GhostLock-App

中文: README_ZH.md

Поддерживаемые устройства

Ядра сопоставляются по точному значению uname -r; неподдерживаемые сборки отклоняются, и приложение показывает статус в верхней части. Смещения хранятся в src/kernels/<uname-release>/offsets.h — добавляйте новые сборки с помощью --register экстрактора.

Быстрый старт

Откройте GhostLock и нажмите Run. KernelSU (me.weishu.kernelsu) или ReSukiSU (com.resukisu.resukisu) предоставляет ksud для загрузки модулей; без него W1/W2 всё равно предоставляют uid 0, но модуль не загружается.

Маршрут соревнуется между двумя ядрами: основной поток активно вызывает pselect, а поток-потребитель возмущает приоритет ожидающего. Пара по умолчанию использует большие ядра (запасной вариант 0/1), переопределяется через GHOSTLOCK_CORE / GHOSTLOCK_CONSUMER_CORE.

Отладка из командной строки

adb/shell не имеет фильтра seccomp, поэтому W3 пропускается — удобно для быстрой проверки:

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

Извлечение смещений

tools/extract_rs выводит смещения из boot.img (плюс опциональный xbl_config.img), полного OTA ZIP-архива или http(s) URL, указывающего на него. kallsyms берутся из --kallsyms или восстанавливаются из встроенной таблицы образа. pselect_waiter_shift и off_slide_loggers_0_1 выводятся встроенным дизассемблером arm64. Образы MediaTek не имеют xbl_config.img и обычно не имеют BTF: физический адрес загрузки выводится из kallsyms _text (переопределяется через --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 сохраняет таблицу в src/kernels/<uname-release>/offsets.h; --format c --out offsets.h выводит автономный заголовочный файл.

Анализ на устройстве

Полный OTA можно проанализировать целиком на телефоне: boot и xbl_config извлекаются автоматически. Передайте --work-dir в каталог, доступный для записи приложению, при запуске внутри песочницы приложения. Кросс-компиляция и отправка:

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

Импорт смещений без пересборки приложения

Новые ядра больше не требуют пересборки приложения: нажмите Import offsets.json и выберите JSON экстрактора (один объект или массив), или отправьте его в <GHOSTLOCK_HOME>/offsets.json (по умолчанию /data/local/tmp). При запуске нативный код сопоставляет текущий uname -r с импортированными записями перед отклонением ядра. Импорты объединяются между файлами; при уже сохранённом релизе запрашивается подтверждение перед перезаписью.

Приложение также может сгенерировать JSON самостоятельно — Parse OTA link (URL полного OTA ZIP-архива) и Parse image (boot.img + опциональный xbl_config.img) запускают экстрактор в процессе и записывают offsets.json в каталог данных приложения при успехе.

[
  {
    "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 }
  }
]

Авторы и лицензия

Основано на следующих проектах, лицензировано по Apache License 2.0 (см. LICENSE):

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