KernelSU 中文文档站——内核级 Root 全流程手册
关于本站:第三方整理的中文文档站,非官方页面;内容来自公开资料整理,功能与界面以官方最新版为准。
KernelSU 是一款面向 Android GKI 设备的内核级 root 方案,由开发者 tiann(weishu,也是 Capo 与 Breath 呼吸灯等项目的作者)发起并开源。与在用户空间运作的传统方案不同,它把 su 逻辑放进 Linux 内核里运行,从更底层为应用授予权限,并配套了一套可插拔的模块架构与精细化权限控制能力。
本站是第三方整理的中文技术文档,主线按照你真实的使用顺序展开:先判断设备能不能用,再选运行模式,然后动手安装,装完管好权限,接着用模块扩展系统,出问题有救砖手段兜底,长期使用还要维护 OTA。每个环节都拆成独立小页,跟着目录从头读到尾即可走完全流程。
刷机操作有风险,动手前请务必备份原厂 boot 镜像与个人数据。功能细节可能随版本演进变化,以官方最新发布为准。

产品档案速览
| 项目 | 说明 |
|---|---|
| 软件名称 | KernelSU |
| 开发者 | tiann(weishu)及开源社区贡献者 |
| 软件性质 | 开源的 Android 内核级 root 解决方案 |
| 组成部分 | 内核补丁 / 可加载内核模块 + 管理器 APK + ksud 命令行工具 |
| 运行平台 | Android GKI 2.0 设备(内核 5.10 起),旧内核 4.14 起可自编译集成 |
| 支持架构 | arm64-v8a、x86_64(另兼容 WSA、ChromeOS、容器化 Android) |
| 当前版本 | v3.3.0(以官方发布页为准) |
| 开源协议 | 内核部分 GPL-2.0,其余部分 GPL-3.0 |
| 获取渠道 | 官方 GitHub 发布页;本站顶栏与页脚提供下载与网盘入口 |
结构导览
- 认识本方案:从「内核级 root 到底强在哪」讲起,帮你分清 LKM 与 GKI 两种运行模式的取舍。入口:内核级 root 方案是什么
- 安装前准备:判断设备支持状态、看懂 KMI 与安全补丁级别、备份 boot、备好 ADB 与 fastboot。入口:怎么判断我的设备能不能用
- 安装实战:管理器修补、fastboot 手动刷入、ksud 命令行与 Recovery 等多条安装路径。入口:用管理器修补安装 KernelSU
- 授权与权限:理解「默认拒绝」的授权模型,用 App Profile 把 root 权力关进笼子。入口:超级用户页与授权操作
- 模块系统:systemless 修改系统文件的机制、元模块架构与模块日常管理。入口:模块机制与 systemless 修改
- 维护与升级:系统 OTA 不掉 root 的正确姿势、卸载还原、设置项速览。入口:系统 OTA 后如何保住 root
- 救砖与排障:音量键安全模式、刷 boot 与模块变砖的恢复办法。入口:音量键触发安全模式
- 进阶与开发:自编译内核、非 GKI 设备集成、模块与 WebUI 开发入门。入口:自编译内核集成 KernelSU