KernelSU 实战部署指南一份刷机前自检清单和 3 条救砖路径【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 是一种把 root 能力做进内核的 Android 方案。新手最怕两件事刷错 boot 镜像后开不了机、装完模块系统起不来。这篇文章从确认设备能否用讲到出事了怎么拉回来所有操作都以官方文档与 ksud 命令行工具的实际行为为准可以直接照着做。刷机前自检4 个硬性前提先核对再动手。下面任何一项不满足教程再熟都会翻车。检查项怎么查通过标准Bootloader 可解锁查品牌官方解锁文档有官方或社区公认的解锁渠道内核版本电脑端执行adb shell uname -r版本号不低于 4.14GKI 设备形如5.10.101-android12-9-...ADB 与 fastboot 环境adb devices、fastboot devices设备均能正常列出原厂 boot 镜像从官方固件包中提取拿到与机型、系统版本对应的boot.imgadb shell uname -r用来读取当前内核版本号它是后续选镜像的依据。易错点输出里带android12-5.10之类字段时要以这个字段而非手机上的 Android 系统版本为准。读懂内核版本号版本号格式为w.x.y-androidN-K-后缀。其中w.x-androidN-K构成 KMIKernel Module Interface它决定你刷的镜像与设备是否兼容。两个容易判断错的地方中间的补丁号不属于 KMI。5.10.101-android12-9与5.10.137-android12-9属于同一 KMI。Android 系统版本和内核版本不要求一致。系统升到 Android 13 后内核可能仍是android12-5.10选镜像时按android12-5.10找。KMI 与安全补丁级别的完整说明可参考官方安装文档。备份是唯一的安全网⚠️ 注意刷写 boot 分区属于高危操作刷之前必须先把原厂boot.img从官方固件中提取出来留底。没有备份时一旦刷错只能重新去翻官方固件包还原耗时且不一定找得到完全匹配的包。推荐主路径LKM 模式完成首次安装对大多数实体手机第一次上手段推荐 LKM 模式。理由有三点不替换原厂内核失败影响面小后续升级直接在管理器内完成不用手动刷机想彻底退出时有卸载入口过程可逆。修补镜像并刷入LKM 模式的原理是改动原厂镜像的 ramdisk注入 KernelSU 内核模块。电脑端用ksud工具完成修补ksud boot-patch -b 原厂boot.img --kmi 你的KMI版本这条命令把 KernelSU 注入指定的原厂镜像并输出修补后的新镜像。易错点输入必须是未动过的原厂镜像不能重复修补设备内核命名不规范时--kmi要手动指定否则可能选错模块版本。修补完成后进 fastboot 模式写入fastboot flash boot 修补后的镜像这条命令把镜像写入 boot 分区。易错点出厂 Android 13 及以上的设备LKM 模式改的是init_boot分区而不是boot以管理器提示为准设备支持fastboot boot时建议先用它试启动起不来直接重启即可不会留下损坏。启动后验证重启后打开 KernelSU 管理器主页显示已安装并列出内核版本即部署成功。若显示未安装或应用闪退大概率是 KMI 不匹配或内核压缩格式lz4、gz、未压缩选错此时用备份的原厂镜像刷回去重试不要反复猜。分支决策点什么时候改走 GKI 模式两种模式适用边界不同核心判据一句话手机优先 LKM特殊环境走 GKI。选项适用场景优点风险推荐人群LKM常规 GKI 手机、需要 OTA、在用第三方内核不替换内核可随时卸载个别校验严格的设备无法加载大多数手机用户GKI开启 KNOX 的三星、模拟器、WSA/Waydroid、冷门魔改系统通用性强不依赖官方固件更新替换整个内核KMI 或压缩格式选错会无法开机特殊环境与进阶用户如果 LKM 加载模块时提示内核校验过严就转 GKI 模式如果设备是模拟器或 WSA直接用 GKI 镜像如果经常 OTA留在 LKM升级后可在管理器里安装到另一个分区。GKI 安装是把项目提供的通用 boot 镜像直接刷进 boot 分区。选镜像要同时对齐三个参数KMI、安全补丁级别过旧的补丁可能被防回滚机制拦下、内核压缩格式。三者任一不符都可能黑屏。细节仍以安装文档为准。安装之后模块生效还差一步不少人装完 KernelSU 后装了模块却没反应。这不是故障是架构设计KernelSU 把模块挂载逻辑从核心剥离交给了一个叫元模块metamodule的可插拔组件。哪些模块内容需要元模块模块内容类型是否需要元模块启动脚本post-fs-data.sh、service.sh 等不需要system.prop、sepolicy.rule不需要挂载覆盖 /system 文件的模块需要例如官方 meta-overlayfs安装 meta-overlayfs官方参考实现是meta-overlayfs安装方式和普通模块相同下载 zip在管理器模块页选择安装重启。两个约束要记住同一时间只能有一个元模块在运行卸载唯一的元模块后所有挂载型模块会集体失效。切换元模块时先卸载常规模块再换装顺序反了容易出中间态。完整机制见元模块文档。⚠️ 注意模块运行在 root 权限下来路不明的模块可能造成不可逆的损坏。只安装开发者可考信的模块一次只装一个重启后确认系统正常再装下一个。出问题时怎么救按症状走 3 条恢复路径KernelSU 的救砖是分层的。先判断自己卡在哪一层再动手不用一上来就格机。总览见救砖文档。症状最可能原因第一处置动作刷完 boot 直接黑屏KMI 不符、压缩格式错、安全补丁过旧刷回备份的原厂 boot装完模块卡在开机动画或反复重启模块脚本或挂载文件干扰启动进安全模式禁用问题模块安全模式也起不来initrc 注入代码异常或恶意模块ADB 或 Recovery 清理最后手段刷完整系统症状一boot 分区刷坏了只要还能进 fastboot这一类问题永远可解。把之前留底的原厂镜像刷回去fastboot flash boot 原厂boot.img这条命令用原厂镜像覆盖 boot 分区刷完重启即恢复。易错点镜像必须与机型和当前系统版本严格对应混用其他版本固件提取的 boot 可能仍无法启动。症状二模块导致起不来用安全模式开机出现第一屏后连续按音量下键超过三次——是按下-松开重复三次不是长按。设备进入 KernelSU 内置安全模式所有模块被自动禁用管理器模块页里可以直接卸载问题模块再重启。时机要把握好按键监听从内核早期启动持续到开机动画前启动快的机型要在 logo 出现的瞬间就开始按。另外注意模块通过 initrc 注入的服务在安全模式下仍会执行这类问题安全模式救不了走下一条路径。症状三极端情况用 ADB 或 Recovery 清理系统能启动且能通过 ADB 拿到 root shelladb shell后su时直接用命令行处理模块ksud module list ksud module disable 模块id第一条列出全部已装模块及其 id第二条禁用指定模块执行后重启生效。易错点id 要与列表输出完全一致输错会报找不到模块。连系统都进不去时进 TWRP 等第三方 Recovery挂载 data 分区后删除/data/adb/ksud再删除/metadata/ksu/modules.rc注入文件。重启后 KernelSU 会跳过全部模块加载进系统后回管理器里慢慢处理。若以上都无效说明模块可能已恶意改写系统只剩清除数据并完整重刷官方系统一条路。收尾3 条高频踩坑提醒选镜像按 KMI、安全补丁级别、压缩格式三件套核对不要按 Android 系统版本挑这是黑屏的头号原因。模块装了没反应先确认是否需要元模块再怀疑模块本身脚本类模块不需要挂载 /system 的必须装 meta-overlayfs。管理器的直接安装会自动备份原厂镜像存放在/data/adb/ksu/ksu_backup_$SHA1下卸载还原原厂镜像时也依赖这份备份别删。下一步就是按开头的自检清单把备份做掉再按决策表选定模式开工。真出问题先对号入座上面的症状表按层处理大多数情况都不至于走到格机那一步。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
KernelSU 实战部署指南：一份刷机前自检清单和 3 条救砖路径
KernelSU 实战部署指南一份刷机前自检清单和 3 条救砖路径【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 是一种把 root 能力做进内核的 Android 方案。新手最怕两件事刷错 boot 镜像后开不了机、装完模块系统起不来。这篇文章从确认设备能否用讲到出事了怎么拉回来所有操作都以官方文档与 ksud 命令行工具的实际行为为准可以直接照着做。刷机前自检4 个硬性前提先核对再动手。下面任何一项不满足教程再熟都会翻车。检查项怎么查通过标准Bootloader 可解锁查品牌官方解锁文档有官方或社区公认的解锁渠道内核版本电脑端执行adb shell uname -r版本号不低于 4.14GKI 设备形如5.10.101-android12-9-...ADB 与 fastboot 环境adb devices、fastboot devices设备均能正常列出原厂 boot 镜像从官方固件包中提取拿到与机型、系统版本对应的boot.imgadb shell uname -r用来读取当前内核版本号它是后续选镜像的依据。易错点输出里带android12-5.10之类字段时要以这个字段而非手机上的 Android 系统版本为准。读懂内核版本号版本号格式为w.x.y-androidN-K-后缀。其中w.x-androidN-K构成 KMIKernel Module Interface它决定你刷的镜像与设备是否兼容。两个容易判断错的地方中间的补丁号不属于 KMI。5.10.101-android12-9与5.10.137-android12-9属于同一 KMI。Android 系统版本和内核版本不要求一致。系统升到 Android 13 后内核可能仍是android12-5.10选镜像时按android12-5.10找。KMI 与安全补丁级别的完整说明可参考官方安装文档。备份是唯一的安全网⚠️ 注意刷写 boot 分区属于高危操作刷之前必须先把原厂boot.img从官方固件中提取出来留底。没有备份时一旦刷错只能重新去翻官方固件包还原耗时且不一定找得到完全匹配的包。推荐主路径LKM 模式完成首次安装对大多数实体手机第一次上手段推荐 LKM 模式。理由有三点不替换原厂内核失败影响面小后续升级直接在管理器内完成不用手动刷机想彻底退出时有卸载入口过程可逆。修补镜像并刷入LKM 模式的原理是改动原厂镜像的 ramdisk注入 KernelSU 内核模块。电脑端用ksud工具完成修补ksud boot-patch -b 原厂boot.img --kmi 你的KMI版本这条命令把 KernelSU 注入指定的原厂镜像并输出修补后的新镜像。易错点输入必须是未动过的原厂镜像不能重复修补设备内核命名不规范时--kmi要手动指定否则可能选错模块版本。修补完成后进 fastboot 模式写入fastboot flash boot 修补后的镜像这条命令把镜像写入 boot 分区。易错点出厂 Android 13 及以上的设备LKM 模式改的是init_boot分区而不是boot以管理器提示为准设备支持fastboot boot时建议先用它试启动起不来直接重启即可不会留下损坏。启动后验证重启后打开 KernelSU 管理器主页显示已安装并列出内核版本即部署成功。若显示未安装或应用闪退大概率是 KMI 不匹配或内核压缩格式lz4、gz、未压缩选错此时用备份的原厂镜像刷回去重试不要反复猜。分支决策点什么时候改走 GKI 模式两种模式适用边界不同核心判据一句话手机优先 LKM特殊环境走 GKI。选项适用场景优点风险推荐人群LKM常规 GKI 手机、需要 OTA、在用第三方内核不替换内核可随时卸载个别校验严格的设备无法加载大多数手机用户GKI开启 KNOX 的三星、模拟器、WSA/Waydroid、冷门魔改系统通用性强不依赖官方固件更新替换整个内核KMI 或压缩格式选错会无法开机特殊环境与进阶用户如果 LKM 加载模块时提示内核校验过严就转 GKI 模式如果设备是模拟器或 WSA直接用 GKI 镜像如果经常 OTA留在 LKM升级后可在管理器里安装到另一个分区。GKI 安装是把项目提供的通用 boot 镜像直接刷进 boot 分区。选镜像要同时对齐三个参数KMI、安全补丁级别过旧的补丁可能被防回滚机制拦下、内核压缩格式。三者任一不符都可能黑屏。细节仍以安装文档为准。安装之后模块生效还差一步不少人装完 KernelSU 后装了模块却没反应。这不是故障是架构设计KernelSU 把模块挂载逻辑从核心剥离交给了一个叫元模块metamodule的可插拔组件。哪些模块内容需要元模块模块内容类型是否需要元模块启动脚本post-fs-data.sh、service.sh 等不需要system.prop、sepolicy.rule不需要挂载覆盖 /system 文件的模块需要例如官方 meta-overlayfs安装 meta-overlayfs官方参考实现是meta-overlayfs安装方式和普通模块相同下载 zip在管理器模块页选择安装重启。两个约束要记住同一时间只能有一个元模块在运行卸载唯一的元模块后所有挂载型模块会集体失效。切换元模块时先卸载常规模块再换装顺序反了容易出中间态。完整机制见元模块文档。⚠️ 注意模块运行在 root 权限下来路不明的模块可能造成不可逆的损坏。只安装开发者可考信的模块一次只装一个重启后确认系统正常再装下一个。出问题时怎么救按症状走 3 条恢复路径KernelSU 的救砖是分层的。先判断自己卡在哪一层再动手不用一上来就格机。总览见救砖文档。症状最可能原因第一处置动作刷完 boot 直接黑屏KMI 不符、压缩格式错、安全补丁过旧刷回备份的原厂 boot装完模块卡在开机动画或反复重启模块脚本或挂载文件干扰启动进安全模式禁用问题模块安全模式也起不来initrc 注入代码异常或恶意模块ADB 或 Recovery 清理最后手段刷完整系统症状一boot 分区刷坏了只要还能进 fastboot这一类问题永远可解。把之前留底的原厂镜像刷回去fastboot flash boot 原厂boot.img这条命令用原厂镜像覆盖 boot 分区刷完重启即恢复。易错点镜像必须与机型和当前系统版本严格对应混用其他版本固件提取的 boot 可能仍无法启动。症状二模块导致起不来用安全模式开机出现第一屏后连续按音量下键超过三次——是按下-松开重复三次不是长按。设备进入 KernelSU 内置安全模式所有模块被自动禁用管理器模块页里可以直接卸载问题模块再重启。时机要把握好按键监听从内核早期启动持续到开机动画前启动快的机型要在 logo 出现的瞬间就开始按。另外注意模块通过 initrc 注入的服务在安全模式下仍会执行这类问题安全模式救不了走下一条路径。症状三极端情况用 ADB 或 Recovery 清理系统能启动且能通过 ADB 拿到 root shelladb shell后su时直接用命令行处理模块ksud module list ksud module disable 模块id第一条列出全部已装模块及其 id第二条禁用指定模块执行后重启生效。易错点id 要与列表输出完全一致输错会报找不到模块。连系统都进不去时进 TWRP 等第三方 Recovery挂载 data 分区后删除/data/adb/ksud再删除/metadata/ksu/modules.rc注入文件。重启后 KernelSU 会跳过全部模块加载进系统后回管理器里慢慢处理。若以上都无效说明模块可能已恶意改写系统只剩清除数据并完整重刷官方系统一条路。收尾3 条高频踩坑提醒选镜像按 KMI、安全补丁级别、压缩格式三件套核对不要按 Android 系统版本挑这是黑屏的头号原因。模块装了没反应先确认是否需要元模块再怀疑模块本身脚本类模块不需要挂载 /system 的必须装 meta-overlayfs。管理器的直接安装会自动备份原厂镜像存放在/data/adb/ksu/ksu_backup_$SHA1下卸载还原原厂镜像时也依赖这份备份别删。下一步就是按开头的自检清单把备份做掉再按决策表选定模式开工。真出问题先对号入座上面的症状表按层处理大多数情况都不至于走到格机那一步。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考