GhostLock-App

中文: README_ZH.md

Dispositivos compatibles

Los kernels se comparan por coincidencia exacta con uname -r; las compilaciones no compatibles se rechazan y la aplicación muestra el estado en la parte superior. Los offsets se encuentran en src/kernels/<uname-release>/offsets.h — añade nuevas compilaciones con --register del extractor.

Inicio rápido

Abre GhostLock y toca Run. KernelSU (me.weishu.kernelsu) o ReSukiSU (com.resukisu.resukisu) proporcionan ksud para la carga de módulos; sin él, W1/W2 siguen otorgando uid 0 pero no se carga ningún módulo.

La ruta compite entre dos núcleos: el hilo principal golpea pselect mientras un hilo consumidor perturba la prioridad del waiter. El par usa por defecto los núcleos grandes (fallback 0/1), reemplazable mediante GHOSTLOCK_CORE / GHOSTLOCK_CONSUMER_CORE.

Depuración por línea de comandos

adb/shell no tiene filtro seccomp, por lo que W3 se omite — útil para una verificación rápida:

make ghostlock
adb push ghostlock /data/local/tmp/ghostlock
adb shell chmod 755 /data/local/tmp/ghostlock
adb shell /data/local/tmp/ghostlock

Extracción de offsets

tools/extract_rs deriva offsets de un boot.img (más un xbl_config.img opcional), un ZIP OTA completo, o una URL http(s) que apunte a uno. Los kallsyms provienen de --kallsyms o se recuperan de la tabla incrustada de la imagen. pselect_waiter_shift y off_slide_loggers_0_1 se derivan mediante el desensamblador arm64 integrado. Las imágenes de MediaTek no tienen xbl_config.img y normalmente tampoco BTF: la dirección de carga física se deriva del _text de kallsyms (reemplazable con --phys).

cargo build --release --manifest-path tools/extract_rs/Cargo.toml
tools/extract_rs/target/release/ghostlock-extract.exe boot.img --xbl-config xbl_config.img --register
tools/extract_rs/target/release/ghostlock-extract.exe OTA.zip --format json --out offsets.json

--register guarda la tabla en src/kernels/<uname-release>/offsets.h; --format c --out offsets.h vuelca un encabezado independiente.

Análisis en el dispositivo

Un OTA completo puede analizarse enteramente en el teléfono: boot y xbl_config se extraen automáticamente. Pasa --work-dir a un directorio escribible por la app cuando se ejecute dentro del sandbox de la aplicación. Compilación cruzada y push:

rustup target add aarch64-linux-android
$ndk = "$env:ANDROID_HOME\ndk\29.0.14206865\toolchains\llvm\prebuilt\windows-x86_64\bin"
$env:CC_aarch64_linux_android = "$ndk\aarch64-linux-android35-clang.cmd"
$env:AR_aarch64_linux_android = "$ndk\llvm-ar.exe"
$env:CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER = $env:CC_aarch64_linux_android
cargo build --release --target aarch64-linux-android --manifest-path tools/extract_rs/Cargo.toml
adb push tools/extract_rs/target/aarch64-linux-android/release/ghostlock-extract /data/local/tmp/
adb shell /data/local/tmp/ghostlock-extract /sdcard/OTA.zip

Importar offsets sin recompilar la aplicación

Los kernels nuevos ya no necesitan una recompilación de la app: toca Import offsets.json y elige el JSON del extractor (objeto único o array), o envíalo a <GHOSTLOCK_HOME>/offsets.json (por defecto /data/local/tmp). Al iniciar, el código nativo compara el uname -r actual contra las entradas importadas antes de rechazar el kernel. Las importaciones se fusionan entre archivos; una release ya almacenada solicita confirmación antes de sobrescribir.

La aplicación también puede generar el JSON por sí misma — Parse OTA link (URL del ZIP OTA completo) y Parse image (boot.img + xbl_config.img opcional) ejecutan el extractor en proceso y escriben offsets.json en el directorio de datos de la app al tener éxito.

[
  {
    "release": "6.12.38-android16-5-g844001fb8721-ab14552068-4k",
    "kernel_phys_load": 3347054592,
    "pselect_waiter_shift": 0,
    "symbols": { "off_init_task": 37801728, "off_init_cred": 37891184 },
    "struct_fields": { "task_prio": 148, "task_cred": 2304 }
  }
]

Créditos y licencia

Basado en los siguientes proyectos, bajo licencia Apache License 2.0 (ver LICENSE):

• NebuSec/CyberMeowfia
• JoinChang/ghostlock-oneplus
• x-spy/CVE-2026-43499-popsicle