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 を付与しますが、モジュールは読み込まれません。

このルートは2つのコアを競走させます。メインスレッドが pselect を連打し、コンシューマースレッドが待機プロセスの優先度を撹乱します。このペアはデフォルトで big コアを使用します（フォールバック 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（完全な OTA ZIP URL）と 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