GhostLock-App

中文: README_ZH.md

Appareils pris en charge

Les kernels sont appariés par correspondance exacte avec uname -r ; les builds non pris en charge sont rejetés et l'application affiche le statut en haut. Les offsets se trouvent dans src/kernels/<uname-release>/offsets.h — ajoutez de nouveaux builds avec --register de l'extracteur.

Démarrage rapide

Ouvrez GhostLock et appuyez sur Run. KernelSU (me.weishu.kernelsu) ou ReSukiSU (com.resukisu.resukisu) fournit ksud pour le chargement des modules ; sans lui, W1/W2 accordent toujours l'uid 0 mais aucun module n'est chargé.

La route met en concurrence deux cœurs : le thread principal martèle pselect tandis qu'un thread consommateur perturbe la priorité du waiter. La paire utilise par défaut les gros cœurs (repli 0/1), remplaçable via GHOSTLOCK_CORE / GHOSTLOCK_CONSUMER_CORE.

Débogage en ligne de commande

adb/shell n'a pas de filtre seccomp, donc W3 est ignoré — pratique pour une vérification rapide :

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

Extraction des offsets

tools/extract_rs dérive les offsets à partir d'un boot.img (plus un xbl_config.img optionnel), d'un ZIP OTA complet, ou d'une URL http(s) pointant vers l'un d'eux. Les kallsyms proviennent de --kallsyms ou sont récupérés depuis la table intégrée de l'image. pselect_waiter_shift et off_slide_loggers_0_1 sont dérivés par le désassembleur arm64 intégré. Les images MediaTek n'ont pas de xbl_config.img et généralement pas de BTF : l'adresse de chargement physique est dérivée du kallsyms _text (remplaçable avec --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 enregistre la table sous src/kernels/<uname-release>/offsets.h ; --format c --out offsets.h génère un en-tête autonome.

Analyse sur l'appareil

Un OTA complet peut être analysé entièrement sur le téléphone : boot plus xbl_config sont extraits automatiquement. Passez --work-dir vers un répertoire accessible en écriture par l'application lors de l'exécution dans le sandbox de l'application. Compilation croisée et envoi :

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

Importation des offsets sans reconstruire l'application

Les nouveaux kernels ne nécessitent plus de reconstruction de l'application : appuyez sur Import offsets.json et sélectionnez le JSON de l'extracteur (objet unique ou tableau), ou poussez-le vers <GHOSTLOCK_HOME>/offsets.json (par défaut /data/local/tmp). Au démarrage, le natif fait correspondre le uname -r actuel aux entrées importées avant de rejeter le kernel. Les imports fusionnent entre fichiers ; une version déjà stockée demande confirmation avant écrasement.

L'application peut également générer le JSON elle-même — Parse OTA link (URL du ZIP OTA complet) et Parse image (boot.img + xbl_config.img optionnel) exécutent l' extracteur en processus et écrivent offsets.json dans le répertoire de données de l'application en cas de succès.

[
  {
    "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édits et licence

Basé sur les projets suivants, sous licence Apache License 2.0 (voir LICENSE) :

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