Android Root 核心 / KernelSU 生态

你的内核真的支持 KernelSU 吗?GKI、KMI 与 LKM 兼容性体检

读取设备内核与 KMI 证据,比较 LKM 和 GKI 路线,并只在精确匹配且可回退时做临时启动验证。

本篇完成任务

完成 KernelSU 兼容性审计,并得到可装、需自行编译或应停止的可验证结论。

本教程的任务不是下载一个“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 -aadb shell uname -radb 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 devicesfastboot 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
临时启动卡 logoKMI、压缩格式或厂商内核不兼容强制重启回 stock,不永久刷写
Manager 与内核版本不对应混用了主线/fork 或旧 Manager回到无修改内核,只用同一上游发布链
Root 正常但模块不生效当前模块模型需要 metamodule 或版本不兼容先完成基础稳定性;阅读当前模块文档后单独测试
OTA 后失效OTA 替换了启动/内核相关分区恢复官方更新流程,再以新构建重新匹配,绝不沿用旧镜像

完成清单#

  • 已保存完整内核 release、KMI、ABI、SPL、build、product 和槽位。
  • 已把每项设备值与同一上游资产逐项匹配。
  • 已明确选择主线或一个 fork,没有交叉混用组件。
  • 只有设备明确支持时才做临时启动,并验证基础硬件。
  • 首次实验没有加入 SUSFS、Zygisk、metamodule 或隐藏组件。
  • 已得出“可继续 / 需自行编译 / 停止”之一并保存 stock 回滚材料。

一手资料#