GhostKey — CVE-2026-98260 원클릭 권한 상승 도구

GhostKey는 승인된 보안 연구 / 본인 소유 기기를 위한 Android 원클릭 권한 상승(privilege escalation) 도구입니다. Shizuku + NDK Native를 기반으로 구현되었으며, 권한 상승에 필요한 Native exploit, 커널 오프셋 테이블, OTA boot 이미지 파싱 기능을 하나의 독립 APK에 패키징하여 사용자가 휴대폰에서 클릭만 하면 트리거되며, PC도 명령줄도 필요하지 않습니다.

⚠️ 보안 및 법적 책임 이 저장소는 승인된 환경에서의 보안 연구 및 본인이 소유한 기기의 합법적 테스트에만 사용됩니다. 기기 소유자의 명시적 승인 없이 타인의 기기에 대해 권한 상승, root 획득 또는 시스템 제한 우회를 실행하는 것은 해당 지역의 법률 및 플랫폼 서비스 약관을 위반할 수 있습니다. 본 도구를 사용함은 이로 인해 발생하는 모든 법적 위험을 이해하고 스스로 부담함을 의미합니다. 작성자는 어떠한 남용 행위에 대해서도 책임지지 않습니다. 본 저장소에서 컴파일된 파일은 주입 단계에서 재부팅될 가능성이 있습니다

기능 특성

원클릭 ROOT: 휴대폰에서 클릭 한 번으로 권한 상승 절차를 완료하며, 컴퓨터 연결이나 adb 명령이 필요 없습니다.
Shizuku 연동: Shizuku를 통해 adb shell 컨텍스트를 획득하여 권한 상승 진입점으로 사용합니다.
순수 APK + NDK Native: exploit의 C 소스 코드가 APK와 함께 NDK/CMake를 통해 libcve98260.so로 컴파일됩니다.
내장 커널 오프셋 테이블: APK와 함께 여러 버전의 커널 프로필을 배포하며, uname -r로 정확히 매칭합니다. 매칭되는 항목이 없으면 사용자에게 해당 boot.img를 가져와 자동으로 파싱하도록 안내합니다.
OTA boot 이미지 파싱: 내장된 BootImageParser / ImgToProfile / KallsymsExtractor를 통해 boot 이미지로부터 커널 심볼과 오프셋을 역추적할 수 있습니다.
KernelSU 연동: KsuResolver / KsudStage가 KernelSU와의 통합을 담당합니다.
실행 로그 분류 표시: 매 권한 상승 실행을 runId별로 그룹화하여 표시하며, 실패 진단(FailureDiagnoser)이 exit 코드(예: KASLR 해석 실패 exit=2)에 대해专项 안내를 제공합니다.
터미널 패널: exploit 실행 로그와 단계 상태를 실시간으로 표시합니다.

기술 스택 및 빌드 환경

항목	버전
`compileSdk` / `targetSdk`	35
`minSdk`	31
Kotlin	1.9+ (JVM target 17)
NDK / CMake	CMake 3.22.1, `ANDROID_STL=none`
Shizuku	13.1.5
Jetpack Compose	BOM 2024.10.00 (Material3)
대상 ABI	`arm64-v8a` (64비트 전용)
산출물 명명	`GhostKey-<버전>-arm64-v8a-release.apk`

현재 버전: 1.1.4 (versionCode 17, 패키지명 com.GhostKey.app).

빌드

이 저장소는 release 빌드를 사용합니다(minify + shrinkResources 활성화, 산출물 약 5.8 MB). assembleDebug를 사용하지 마십시오——구 debug 키는 release와 다르므로, 덮어쓰기 설치 시 먼저 제거해야 합니다.

1. 서명 비밀번호 준비

서명 키는 app/keystore/release.keystore에 위치합니다(.gitignore에 의해 무시되며, 버전 관리에 포함되지 않습니다). 비밀번호는 다음 두 가지 방법 중 하나로 주입하며, 소스 코드에 다시 작성하지 마십시오:

방법 A: local.properties에 추가 (권장, 해당 파일은 무시됨)

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

방식 B: 환경 변수

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

2. release APK 컴파일

./gradlew assembleRelease

산출물 경로: app/build/outputs/apk/release/GhostKey-1.1.5-arm64-v8a-release.apk

디렉터리 구조 (핵심 모듈)

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 二进制

사용 흐름(개요)

기기에 Shizuku를 설치하고 활성화한 뒤, 본 애플리케이션에 권한을 부여합니다.
KernelSU 관리자를 설치합니다(권한 상승 결과를 수신하기 위한 용도).
GhostKey를 열면 애플리케이션이 커널 버전을 탐지하여 내장 오프셋 테이블과 매칭합니다. 매칭되는 항목이 없으면 기기에서 boot.img를 내보내 가져와 자동으로 파싱합니다.
권한 상승을 클릭하면 터미널 로그와 단계 상태를 실시간으로 확인할 수 있으며, 실패 시 FailureDiagnoser의专项 진단(캘리브레이션 A/B, profile 매칭, tracefs 샘플링 등)에 따라 문제를排查합니다.
권한 상승은 임시 root이며, 기기 재부팅 후에는失效합니다.

지원 기기

내장 커널 profile은 여러 5.15 / 6.1 / 6.6 / 6.12 / 6.18 계열 커널을 커버합니다. 검증된 기종 예시:

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

구체적인 커널 프로파일은 app/src/main/kotlin/com/GhostKey/app/data/BuiltinProfileCatalog.kt 및 각 *.profile 리소스를 기준으로 합니다.

버전 규칙

산출물은 일괄적으로 GhostKey-<ver>-release.apk로 명명한 후 dist/에 전달합니다(해당 디렉터리는 .gitignore에 의해 무시되며 버전 관리에 포함되지 않습니다).

라이선스

권한이 부여된 보안 연구 및 자체 사용 기기 테스트 용도로만 제공됩니다. 권한 범위를 벗어나는 모든 용도는 라이선스 범위에 포함되지 않습니다.

인기

CVE-2026-98260-GhostKey