本教程的任务不是下载一个“5.10 通用 boot”,而是判断你的自有备用机能否安全进入 KernelSU 安装流程。你会先完成只读证据表;只有版本、KMI、压缩格式、分区与回滚通道全部匹配,才考虑设备明确支持的临时启动。
你会完成什么#
- 区分 KernelSU Manager、内核实现、LKM、GKI 和模块生态。
- 记录内核版本、KMI、架构、补丁级别、槽位与原厂镜像,逐项核对发布资产。
- 把 Manager 的结果归类为“可评估安装”“需要自行编译”或“停止”。
- 在支持
fastboot boot的设备上做一次可撤销验证,不同时叠加模块或 fork。
先看结论#
| 证据 | 结论 | 下一步 |
|---|---|---|
| Manager 显示支持,KMI/ABI/压缩格式和官方资产完全一致 | 可继续评估 | 优先研究 LKM 与临时启动,保留 stock 镜像 |
Manager 显示 Unsupported | 预编译方案不可用 | 官方含义通常是需要自己编译内核,不是去找相似 boot |
| 只知道“Android 14、kernel 5.10” | 证据不足 | 补齐 KMI、SPL、配置、分区与产品代号 |
| 使用 KernelSU-Next 或其他 fork | 独立实现 | 只用该项目的 Manager、内核补丁、模块说明与支持渠道 |
心智模型#
Android App → KernelSU Manager → 内核授权钩子 → UID 0
├─ LKM:保留内核,加载匹配模块
└─ GKI:替换/使用匹配的 GKI 内核
设备 KMI + ABI + SPL + compression + boot layout → 必须逐项匹配
GKI 是 Android 内核架构和兼容接口,不是“所有 GKI 手机共享同一个镜像”。KMI(Kernel Module Interface)决定模块与内核能否合作;相同的大版本号也可能有不同 KMI、厂商改动和压缩格式。
工具清单#
| 工具 | 角色 | 什么时候用 | 来源与注意 |
|---|---|---|---|
| KernelSU Manager | 读取支持状态与管理授权 | 兼容性体检第一步 | Unsupported 不是下载随机镜像的邀请 |
| ADB/fastboot | 只读取证、设备支持时临时启动 | 产品、槽位、内核记录后 | fastboot boot 并非所有设备实现 |
| 同构建原厂包 | 提供 boot/init_boot 回滚 | 任何写入之前 | 不能用同营销型号的别区固件 |
| KernelSU-Next | 独立 fork 对照 | 仅在明确选择该生态时 | 不把主线 Manager 与 fork 内核混用 |
项目全景:KernelSU 生态的 46 个项目,一个不漏#
以 KernelSU 的内核授权链为主线,把上游/分支、GKI 与设备内核、SUSFS 隐藏、模块用途和生态索引分开讲。大量同名 fork 必须逐项出现,但不能被写成 46 种独立 Root 原理。
| 技术路线 | 项目数 | 处理等级 | 在主题任务中的位置 |
|---|---|---|---|
| SUSFS、挂载隐藏与隐蔽层 | 8 | 候选路线 | 放在基础 KernelSU 成功后的可选层,比较 SUSFS、mountless 重定向和隐藏服务。先建立无隐藏基线,再一次只加入一个组件;内核漏洞项目只作风险说明。 |
| GKI/LKM、设备内核与构建路线 | 7 | 候选路线 | 用于兼容性体检:把 KMI、GKI、LKM、内核源码、设备专用构建和在线构建器放在一起核对。营销机型相同不等于 KMI 匹配,不能下载相似版本的 boot 试刷。 |
| 模块、代理与授权体验扩展 | 3 | 候选路线 | 覆盖 KernelSU 模块、透明代理、配置和授权提示等用户态扩展。它们不改变内核是否支持 KernelSU 的结论,安装前先核对模块格式和版本。 |
| 生态索引、桌面套件与诊断工具 | 2 | 候选路线 | 把 awesome 清单、桌面套件与诊断入口作为发现资源,而不是安装权威。文章应教新手回到上游 release、提交记录和设备维护者页面二次核验。 |
| 主线实现、分支与管理器 | 25 | 候选路线 | 集中介绍 tiann/KernelSU、KernelSU-Next、ReSukiSU、SukiSU/KittiSU/ApexSU 等血缘。逐项列出 fork,但要求 Manager、内核补丁和文档来自同一项目链,禁止交叉混用。 |
| 跨界、信息不足与低置信项目 | 1 | 边界复核 | 收纳只在 topics 提到 KernelSU、通用 AOSP 构建仓库或信息不足的项目。完整展示但不当作上游兼容资产,说明其真正用途和核验缺口。 |
1. SUSFS、挂载隐藏与隐蔽层 · 8#
放在基础 KernelSU 成功后的可选层,比较 SUSFS、mountless 重定向和隐藏服务。先建立无隐藏基线,再一次只加入一个组件;内核漏洞项目只作风险说明。
本组共 8 项:7 个源项目、1 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| sidex15/susfs4ksu-module | 主题用途:将 sidex15/susfs4ksu-module 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 android · kernelsu · kernelsu-module · HTML 核对功能、平台与版本适配。 上游自述(保留原文):An addon root hiding service for KernelSU | 未归档源项目 · ★ 2445 · AGPL-3.0 · 2026-07-17。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| rrr333nnn333/BRENE | 主题用途:将 rrr333nnn333/BRENE 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 android · hiding · kernelsu · Shell 核对功能、平台与版本适配。 上游自述(保留原文):BRENE - A SuSFS/KernelSU module for SuSFS patched kernels | 未归档源项目 · ★ 302 · AGPL-3.0 · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| Enginex0/zeromount | 主题用途:将 Enginex0/zeromount 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 android · android-root · kernel · Rust 核对功能、平台与版本适配。 上游自述(保留原文):Mountless module loading for rooted Android. Kernel-level VFS path redirection — zero mount table pollution. SUSFS integration, WebUI, bootloop guard, and strategy fallback. | 未归档源项目 · ★ 108 · GPL-3.0 · 2026-04-15。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| pershoot/KernelSU-Next | 主题用途:将 pershoot/KernelSU-Next 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):An advanced Kernel based root solution for Android https://gitlab.com/pershoot/susfs4ksu/ (SuSFS: gki-android14-6.1-dev, gki-android14-6.1-lts-dev, aosp-android14-6.1-dev) | 未归档 Fork · ★ 70 · GPL-3.0 · 2026-07-13。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| ahmed-alnassif/GKI-Duchamp | 主题用途:将 ahmed-alnassif/GKI-Duchamp 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 6-1-android14 · android · android-14 · Shell 核对功能、平台与版本适配。 上游自述(保留原文):GKID feature-rich GKI kernel (6.1-android14) for Poco X6 Pro (duchamp) & other compatible Android devices - KernelSU/KernelSU Next/SukiSU Ultra/Wild KSU variants, SUSFS hiding, Baseband Guard (BBG), 300Hz timer, BBRv3, MGLRU, F2FS, optimized zRAM. | 未归档源项目 · ★ 48 · GPL-3.0 · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| JoinChang/ghostlock-oneplus | 主题用途:将 JoinChang/ghostlock-oneplus 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 android · coloros · ghostlock · C 核对功能、平台与版本适配。 上游自述(保留原文):GhostLock (CVE-2026-43499) kernel exploit for OnePlus devices with locked bootloader | 未归档源项目 · ★ 42 · 协议未声明 · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| qrjhamron/ApexSU | 主题用途:将 qrjhamron/ApexSU 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 android · android-app · android-root · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Hardened Android root solution built on KernelSU — Rust-first userspace, stealth hardening, and built-in diagnostics. | 未归档源项目 · ★ 17 · GPL-3.0 · 2026-05-28。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| rathorekrishna401-NeuroVoid/ApexSU | 主题用途:将 rathorekrishna401-NeuroVoid/ApexSU 纳入「SUSFS、挂载隐藏与隐蔽层」候选路线,根据 android · android-root · arm64 · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Provides a hardened Android root solution with reduced attack surface, Rust-based userspace, and stealth features built on KernelSU. | 未归档源项目 · ★ 7 · GPL-3.0 · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
2. GKI/LKM、设备内核与构建路线 · 7#
用于兼容性体检:把 KMI、GKI、LKM、内核源码、设备专用构建和在线构建器放在一起核对。营销机型相同不等于 KMI 匹配,不能下载相似版本的 boot 试刷。
本组共 7 项:3 个源项目、4 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| YuKongA/KernelSU | 主题用途:将 YuKongA/KernelSU 纳入「GKI/LKM、设备内核与构建路线」候选路线,根据 miuix · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 73 · GPL-3.0 · 2026-05-17。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| supechicken/ChromeOS-ARCVM-Root | 主题用途:将 supechicken/ChromeOS-ARCVM-Root 纳入「GKI/LKM、设备内核与构建路线」候选路线,根据 android · chromebook · chromeos · Shell 核对功能、平台与版本适配。 上游自述(保留原文):Scripts for rooting ChromeOS ARCVM-based Android subsystem (Android 11+) | 未归档源项目 · ★ 56 · GPL-3.0 · 2025-08-11。边界命中:先读 README,确认它确实属于当前任务,再决定是否使用。 |
| MiguVT/NP2_Kernel | 主题用途:将 MiguVT/NP2_Kernel 纳入「GKI/LKM、设备内核与构建路线」候选路线,根据 android · android-kernel · arter97 · Shell 核对功能、平台与版本适配。 上游自述(保留原文):Custom kernel for Nothing Phone 2 (Pong) with root and hiding built in. (Built with workflow) | 未归档源项目 · ★ 21 · 协议未声明 · 2026-07-05。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| JingMatrix/KernelSU | 主题用途:将 JingMatrix/KernelSU 纳入「GKI/LKM、设备内核与构建路线」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android (GKI-1.0 support included) | 未归档 Fork · ★ 15 · GPL-3.0 · 2026-06-05。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| CoolestEnoch/kernelsu-xiaomi-cas-online | 主题用途:将 CoolestEnoch/kernelsu-xiaomi-cas-online 纳入「GKI/LKM、设备内核与构建路线」候选路线,根据 android · android-kernel · kernelsu 核对功能、平台与版本适配。 上游自述(保留原文):未提供仓库简介 | 未归档源项目 · ★ 5 · 协议未声明 · 2023-11-25。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| canyie/KernelSU | 主题用途:将 canyie/KernelSU 纳入「GKI/LKM、设备内核与构建路线」候选路线,根据 仓库名、README 与发布记录 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android GKI | 未归档 Fork · ★ 5 · GPL-3.0 · 2023-01-06。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| F-19-F/KernelSU | 主题用途:将 F-19-F/KernelSU 纳入「GKI/LKM、设备内核与构建路线」候选路线,根据 C 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android GKI | 未归档 Fork · ★ 5 · GPL-3.0 · 2023-02-12。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
3. 模块、代理与授权体验扩展 · 3#
覆盖 KernelSU 模块、透明代理、配置和授权提示等用户态扩展。它们不改变内核是否支持 KernelSU 的结论,安装前先核对模块格式和版本。
本组共 3 项:1 个源项目、2 个 Fork,其中 1 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| NativeStar/KernelSUGrantToast | 主题用途:将 NativeStar/KernelSUGrantToast 纳入「模块、代理与授权体验扩展」候选路线,根据 TypeScript 核对功能、平台与版本适配。 上游自述(保留原文):Make KernelSU show a root granted toast like Magisk. | 未归档源项目 · ★ 41 · GPL-3.0 · 2026-07-07。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| Dreamail/ClashforKernelSU | 主题用途:将 Dreamail/ClashforKernelSU 纳入「模块、代理与授权体验扩展」候选路线,根据 Shell 核对功能、平台与版本适配。 上游自述(保留原文):Transparent proxy(Tproxy) for android (root) | 未归档 Fork · ★ 39 · 协议未声明 · 2023-03-27。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| LIghtJUNction/BFM_config- | 主题用途:将 LIghtJUNction/BFM_config- 纳入「模块、代理与授权体验扩展」候选路线,根据 Shell 核对功能、平台与版本适配。 上游自述(保留原文):config for clash meta (mihomo ) / clash verge (pc and android) / box for magsik / kernelsu / apatch (need root)(透明proxy) / DNS 泄露已解决 / 点击下方链接跳转至自定义rule仓库 | 已归档 Fork · ★ 33 · GPL-3.0 · 2025-11-15。已归档 Fork:只用于追溯历史差异,不作为默认安装源。 |
4. 生态索引、桌面套件与诊断工具 · 2#
把 awesome 清单、桌面套件与诊断入口作为发现资源,而不是安装权威。文章应教新手回到上游 release、提交记录和设备维护者页面二次核验。
本组共 2 项:2 个源项目、0 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| fynks/awesome-kernelsu | 主题用途:将 fynks/awesome-kernelsu 纳入「生态索引、桌面套件与诊断工具」候选路线,根据 android-development · android-root · apatch 核对功能、平台与版本适配。 上游自述(保留原文):A curated list of KernelSU & its forks, tools, modules, and documentation | 未归档源项目 · ★ 65 · MIT · 2026-06-09。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| Mortarmacvoid/KernelSU-Android-Root-Suite | 主题用途:将 Mortarmacvoid/KernelSU-Android-Root-Suite 纳入「生态索引、桌面套件与诊断工具」候选路线,根据 android-emulator · device-management · how-to-install-kernelsu-android 核对功能、平台与版本适配。 上游自述(保留原文):KernelSU Android Root Suite — device management utilities, diagnostic flows and transfer tools enabled for Windows desktop use. Windows setup guide — install steps, typical errors, and how to get KernelSU Android Root Suite running on PC. | 未归档源项目 · ★ 23 · NOASSERTION · 2026-07-17。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
5. 主线实现、分支与管理器 · 25#
集中介绍 tiann/KernelSU、KernelSU-Next、ReSukiSU、SukiSU/KittiSU/ApexSU 等血缘。逐项列出 fork,但要求 Manager、内核补丁和文档来自同一项目链,禁止交叉混用。
本组共 25 项:6 个源项目、19 个 Fork,其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release,再用 Fork 追溯设备适配或历史差异;分组本身不等于推荐安装。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| tiann/KernelSU | 主题用途:将 tiann/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 android · kernel · kernelsu · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档源项目 · ★ 1.7万 · GPL-3.0 · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| KernelSU-Next/KernelSU-Next | 主题用途:将 KernelSU-Next/KernelSU-Next 纳入「主线实现、分支与管理器」候选路线,根据 android · kernel · kernelsu · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):An advanced Kernel based root solution for Android | 未归档源项目 · ★ 3960 · GPL-3.0 · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| ReSukiSU/ReSukiSU | 主题用途:将 ReSukiSU/ReSukiSU 纳入「主线实现、分支与管理器」候选路线,根据 kernelsu · resukisu · root · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A KernelSU based root solution for Android | 未归档源项目 · ★ 1041 · GPL-3.0 · 2026-07-19。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| 5ec1cff/KernelSU | 主题用途:将 5ec1cff/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A KernelSU based root solution for Android | 未归档 Fork · ★ 679 · GPL-3.0 · 2026-07-08。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| rsuntk/KernelSU | 主题用途:将 rsuntk/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 android · kernelsu · rksu · Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Personal fork of KernelSU Project | 未归档 Fork · ★ 648 · GPL-3.0 · 2026-07-16。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| ShirkNeko/KernelSU | 主题用途:将 ShirkNeko/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):Kernel-based Android Root Solution | 未归档 Fork · ★ 323 · GPL-3.0 · 2026-03-14。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| Ylarod/KernelSU-fork | 主题用途:将 Ylarod/KernelSU-fork 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 56 · GPL-3.0 · 2025-11-04。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| sidex15/KernelSU-Next | 主题用途:将 sidex15/KernelSU-Next 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 29 · GPL-3.0 · 2026-07-11。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| Dr-TSNG/KernelSU | 主题用途:将 Dr-TSNG/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 29 · GPL-3.0 · 2024-03-24。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| supechicken/KernelSU | 主题用途:将 supechicken/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 21 · GPL-3.0 · 2026-03-22。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| yujincheng08/KernelSU | 主题用途:将 yujincheng08/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 14 · GPL-3.0 · 2024-10-16。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| aviraxp/KernelSU | 主题用途:将 aviraxp/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 12 · GPL-3.0 · 2025-12-13。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| terebiko/KittiSU | 主题用途:将 terebiko/KittiSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A KernelSU based root solution for Android | 未归档 Fork · ★ 10 · GPL-3.0 · 2026-07-14。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| find-xposed-magisk/KernelSU | 主题用途:将 find-xposed-magisk/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android / 基于内核的Android Root解决方案 | 未归档源项目 · ★ 10 · GPL-3.0 · 2026-07-20。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| lightsummer233/KernelSU | 主题用途:将 lightsummer233/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 9 · GPL-3.0 · 2026-07-08。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| deeptesh-rout/KernelSU | 主题用途:将 deeptesh-rout/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 仓库名、README 与发布记录 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 8 · GPL-3.0 · 2024-07-14。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| kutemeikito/KernelSU | 主题用途:将 kutemeikito/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 6 · GPL-3.0 · 2024-11-18。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| sidex15/KernelSU-A | 主题用途:将 sidex15/KernelSU-A 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档源项目 · ★ 6 · GPL-3.0 · 2025-08-25。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
| aaaaaaaa-815/KernelSU | 主题用途:将 aaaaaaaa-815/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 5 · GPL-3.0 · 2026-05-20。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| iamr0s/KernelSU | 主题用途:将 iamr0s/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 5 · GPL-3.0 · 2024-01-27。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| lingqiqi5211/KernelSU | 主题用途:将 lingqiqi5211/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 5 · GPL-3.0 · 2024-10-27。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| officialputuid/KernelSU | 主题用途:将 officialputuid/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 5 · GPL-3.0 · 2025-02-12。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| xianwan1314/KernelSU | 主题用途:将 xianwan1314/KernelSU 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):A Kernel based root solution for Android | 未归档 Fork · ★ 5 · GPL-3.0 · 2026-07-16。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| maxsteeel/KernelSU-Next | 主题用途:将 maxsteeel/KernelSU-Next 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):An advanced Kernel based root solution for Android | 未归档 Fork · ★ 4 · GPL-3.0 · 2026-07-15。Fork:采用前先与上游比较提交、Release 和维护者说明。 |
| solarized-progs/KernelSU-Manager | 主题用途:将 solarized-progs/KernelSU-Manager 纳入「主线实现、分支与管理器」候选路线,根据 Kotlin 核对功能、平台与版本适配。 上游自述(保留原文):(Solarized) Manager for Kernel based root solution for Android | 未归档源项目 · ★ 4 · 协议未声明 · 2023-09-10。活跃候选:先核对 README、最新 Release、目标版本与已知问题。 |
6. 跨界、信息不足与低置信项目 · 1#
收纳只在 topics 提到 KernelSU、通用 AOSP 构建仓库或信息不足的项目。完整展示但不当作上游兼容资产,说明其真正用途和核验缺口。
本组共 1 项:1 个源项目、0 个 Fork,其中 0 项已归档。它们的平台、用途或分类存在边界,只作逐项核验,不当作默认安装候选。
| 项目 | 上游定位与识别信号 | 状态与采用前检查 |
|---|---|---|
| mio-19/repo | 主题用途:将 mio-19/repo 作为「跨界、信息不足与低置信项目」边界条目,通过 android · android-application · aosp · Nix 核对它实际是否属于本教程。 上游自述(保留原文):build script for android applications and operating system based on android | 未归档源项目 · ★ 13 · MIT · 2026-07-19。边界条目:先核对实际平台、用途和分类理由,不作为默认安装源。 |
开始前#
在 Android 中保存 adb shell uname -a、adb shell uname -r、adb shell getprop ro.product.device、完整构建指纹和安全补丁日期;在 bootloader 保存 product 与 current-slot。安装 Manager 只用于读状态,不授予任何 App root。下载当前构建原厂包,保留 stock boot 与设备布局要求时的 init_boot,记录哈希。
截至 2026-08-09,KernelSU 官方文档仍区分 LKM 与 GKI 路线;新 Android 设备的 LKM patch 可能涉及 init_boot,而 GKI 路线仍关系 boot。分区选择必须以当时的 KernelSU 文档和具体设备资料共同确认。
操作步骤#
1. 建立设备与内核证据卡#
把内核 release 完整字符串拆成主版本、Android common kernel 代际与厂商后缀,不删除任何字符。记录 CPU ABI、系统 SPL、启动镜像 header/压缩格式和 bootloader 状态。若 Manager 只给一个概括标签,仍需用官方安装说明核对其含义;截图同时抄成文本,方便和发布资产逐字段比较。
2. 选择 LKM、GKI 或停止#
LKM 旨在保留原内核并加载模块,通常减少替换整个内核的变量;GKI mode 涉及匹配的内核镜像。建立一行对一行匹配表,只有 KMI、架构、Android/kernel 代际、压缩格式、SPL/发布说明和目标分区都明确通过才进入下一步。若需要自行编译,这已经是内核构建任务,应停在结论并另行准备源码、toolchain 和可复现构建。
3. 在设备支持时做临时启动#
先再次运行 fastboot devices、fastboot getvar product 与 current-slot 检查。只有官方设备资料确认允许临时 boot,才用已核验资产执行 fastboot boot <verified-image>;这个动作把镜像放入内存试启动,不应写分区,但错误内核仍可能卡住,需要强制重启。启动后先看 Manager 状态、触控/无线和 adb,不装模块。
4. 做决定并保留回退#
临时启动稳定才评估官方 LKM patch 或永久写入步骤;命令必须来自当前 KernelSU 文档与设备页。永久安装后只让一个终端运行 su -c id,保存授权日志。若临时启动失败、硬件异常或 Manager 状态不一致,正常重启回 stock,记录“不兼容”而不是改用另一个 fork 继续试。
验证#
| 检查 | 通过证据 | 未通过的结论 |
|---|---|---|
| 身份匹配 | product、codename、完整 build 与原厂包一致 | 镜像不可用 |
| 内核匹配 | KMI、ABI、压缩格式与资产逐项一致 | 不以相似大版本替代 |
| 临时启动 | Android 启动,Manager 状态正常,基础硬件可用 | 回 stock,标记不兼容 |
| 最小授权 | 单一终端获得 UID 0,其他 App 无授权 | 撤销授权并排查混装 |
| 回滚 | 正常重启可回 stock,原厂镜像哈希可核对 | 不做永久安装 |
成功标准是证据链完整,不是“别人同 SoC 刷成了”。如果设备不能临时启动,验证门槛应更高:必须有精确设备维护者说明、可工作的 recovery 与完整回刷材料。
排错#
| 现象 | 常见原因 | 安全处理 |
|---|---|---|
| Manager 显示 Unsupported | 内核未集成或无匹配 LKM | 记录需自行编译,停止搜索通用 boot |
| 临时启动卡 logo | KMI、压缩格式或厂商内核不兼容 | 强制重启回 stock,不永久刷写 |
| Manager 与内核版本不对应 | 混用了主线/fork 或旧 Manager | 回到无修改内核,只用同一上游发布链 |
| Root 正常但模块不生效 | 当前模块模型需要 metamodule 或版本不兼容 | 先完成基础稳定性;阅读当前模块文档后单独测试 |
| OTA 后失效 | OTA 替换了启动/内核相关分区 | 恢复官方更新流程,再以新构建重新匹配,绝不沿用旧镜像 |
完成清单#
- 已保存完整内核 release、KMI、ABI、SPL、build、product 和槽位。
- 已把每项设备值与同一上游资产逐项匹配。
- 已明确选择主线或一个 fork,没有交叉混用组件。
- 只有设备明确支持时才做临时启动,并验证基础硬件。
- 首次实验没有加入 SUSFS、Zygisk、metamodule 或隐藏组件。
- 已得出“可继续 / 需自行编译 / 停止”之一并保存 stock 回滚材料。