GhostKey — Outil d'élévation de privilèges en un clic pour CVE-2026-98260

GhostKey est un outil Android d'élévation de privilèges (privilege escalation) en un clic destiné aux appareils personnels / à la recherche en sécurité autorisée. Il est implémenté sur la base de Shizuku + NDK Native, et empaquette dans un APK autonome l'exploit natif nécessaire à l'élévation de privilèges, la table d'offsets du noyau et la capacité d'analyse des images boot OTA ; l'utilisateur peut le déclencher d'un simple clic sur son téléphone, sans PC ni ligne de commande.

⚠️ Sécurité et responsabilité légale Ce dépôt est destiné uniquement à la recherche en sécurité dans des environnements autorisés et aux tests légitimes sur des appareils que vous possédez personnellement. Sans autorisation explicite du propriétaire de l'appareil, exécuter une élévation de privilèges, obtenir un accès root ou contourner les restrictions système sur l'appareil d'autrui peut enfreindre les lois et réglementations locales ainsi que les conditions d'utilisation de la plateforme. L'utilisation de cet outil implique que vous comprenez et assumez l'ensemble des risques juridiques qui en découlent. L'auteur décline toute responsabilité en cas d'utilisation abusive. Les fichiers compilés à partir de ce dépôt peuvent, dans certains cas, provoquer un redémarrage lors de la phase d'injection

Fonctionnalités

ROOT en un clic : un simple appui sur le téléphone suffit pour réaliser le processus d'élévation de privilèges, sans connexion à un ordinateur ni commande adb.
Intégration Shizuku : obtention d'un contexte adb shell via Shizuku, servant de point d'entrée pour l'élévation de privilèges.
APK pur + NDK Native : le code source C de l'exploit est compilé avec l'APK via NDK/CMake dans libcve98260.so.
Table d'offsets du noyau intégrée : distribution avec l'APK de profils de noyau multi-versions, correspondance précise selon uname -r ; en l'absence de correspondance, l'utilisateur est guidé pour importer le boot.img correspondant afin de l'analyser automatiquement.
Analyse d'image boot OTA : intégration de BootImageParser / ImgToProfile / KallsymsExtractor, permettant de déduire les symboles et offsets du noyau à partir de l'image boot.
Intégration KernelSU : KsuResolver / KsudStage assurent l'intégration avec KernelSU.
Journaux d'exécution par niveaux : chaque exécution d'élévation de privilèges est regroupée et affichée par runId, le diagnostic d'échec (FailureDiagnoser) fournit des indications spécifiques selon le code exit (par exemple, échec de résolution KASLR exit=2).
Panneau terminal : affichage en temps réel des journaux d'exécution de l'exploit et de l'état des phases.

Stack technique et environnement de compilation

Élément	Version
`compileSdk` / `targetSdk`	35
`minSdk`	31
Kotlin	1.9+ (cible JVM 17)
NDK / CMake	CMake 3.22.1, `ANDROID_STL=none`
Shizuku	13.1.5
Jetpack Compose	BOM 2024.10.00 (Material3)
ABI cible	`arm64-v8a` (64 bits uniquement)
Nommage du produit	`GhostKey-<version>-arm64-v8a-release.apk`

Version actuelle : 1.1.5 (versionCode 17, nom de package com.GhostKey.app).

Compilation

Ce dépôt utilise une compilation release (minify + shrinkResources activés, produit d'environ 5,8 Mo). N'utilisez pas assembleDebug — l'ancienne clé debug diffère de celle de release, et une installation par-dessus nécessite une désinstallation préalable.

1. Préparation du mot de passe de signature

La clé de signature se trouve dans app/keystore/release.keystore (ignorée par .gitignore, elle ne sera pas versionnée). Le mot de passe est injecté par l'une des deux méthodes suivantes, ne l'écrivez pas dans le code source :

Méthode A : ajout dans local.properties (recommandé, ce fichier est déjà ignoré)
```
CVE98260_STORE_PASSWORD=你的密码
CVE98260_KEY_PASSWORD=你的密码
```

Méthode B : variables d'environnement

export CVE98260_STORE_PASSWORD=你的密码
export CVE98260_KEY_PASSWORD=你的密码

2. Compiler l'APK release

./gradlew assembleRelease

Chemin de sortie : app/build/outputs/apk/release/GhostKey-1.1.5-arm64-v8a-release.apk

Structure des répertoires (modules principaux)

app/src/main/
├── kotlin/com/GhostKey/app/
│   ├── Cve98260Application.kt        # Application 入口
│   ├── data/                       # 内核 profile 加载/解析/存储
│   │   ├── Profile.kt              # 内核 profile 数据模型
│   │   ├── BuiltinProfileCatalog.kt# 内置偏移表
│   │   ├── ProfileRepository.kt    # 精确 release 匹配（无回退）
│   │   ├── AssetConfigLoader.kt    # assets 配置加载
│   │   ├── LegacyProfileConverter.kt
│   │   ├── ProfileImportManager.kt # 用户导入 boot.img
│   │   ├── RunLogStore.kt         # 运行日志分档存储
│   │   ├── UserProfileStore.kt
│   │   └── ota/                   # BootImageParser / ImgToProfile / KallsymsExtractor
│   ├── device/                    # DeviceBinding / KernelProbe / PrivilegeGate
│   ├── engine/                    # ExploitEngine / FailureDiagnoser
│   ├── ksu/                       # KsuResolver / KsudStage
│   ├── model/                     # KernelProfile / ShizukuStatus / StageTracker ...
│   ├── native/                    # KernelProfileSerializer / NativeContract
│   ├── shizuku/                   # Cve98260UserService / ShizukuPermissionManager
│   ├── ui/                        # Compose 界面（MainScreen / LogViewerScreen / SettingsScreen）
│   └── viewmodel/                 # ExploitViewModel
├── aidl/com/GhostKey/app/shizuku/ # Shizuku 跨进程接口
├── cpp/                           # Native exploit（CMake 构建为 libcve98260.so）
└── assets/ksu/                    # ksud 二进制

Flux d'utilisation (aperçu)

Installez et activez Shizuku sur l'appareil, puis autorisez cette application.
Installez le gestionnaire KernelSU (pour recevoir le résultat de l'élévation de privilèges).
Ouvrez GhostKey ; l'application détecte la version du noyau et la fait correspondre à la table d'offsets intégrée ; en l'absence de correspondance, exportez boot.img depuis l'appareil et importez-le pour un parsing automatique.
Cliquez sur l'élévation de privilèges pour consulter en temps réel les journaux du terminal et l'état des étapes ; en cas d'échec, diagnostiquez à l'aide des diagnostics spécialisés de FailureDiagnoser (calibrage A/B, correspondance de profile, échantillonnage tracefs, etc.).
L'élévation de privilèges produit un root temporaire, qui devient caduc après redémarrage de l'appareil.

Appareils pris en charge

Les profiles de noyau intégrés couvrent plusieurs séries de noyaux 5.15 / 6.1 / 6.6 / 6.12 / 6.18. Exemples de modèles validés :

OPPO Find X8 Ultra (PKJ110) — noyau 6.6.118-android15-...

Les profils de noyau précis font foi dans app/src/main/kotlin/com/GhostKey/app/data/BuiltinProfileCatalog.kt et dans les ressources *.profile respectives.

Convention de version

Le numéro de version est géré manuellement depuis la 1.1.0 et n'est pas incrémenté automatiquement lors des reconditionnements quotidiens ; il n'est bumpé qu'en cas de besoin explicite.
Les artefacts sont uniformément nommés GhostKey-<ver>-release.apk puis livrés dans dist/ (ce répertoire est ignoré par .gitignore et n'entre pas dans le dépôt de versions).

Licence

Destiné exclusivement à la recherche en sécurité autorisée et aux tests sur des appareils personnels. Tout usage dépassant le cadre autorisé est exclu du périmètre de la licence.

Populaires

CVE-2026-98260-GhostKey