KernelSU：Android 内核级 Root 从环境验证到模块运维的实操路径
KernelSUAndroid 内核级 Root 从环境验证到模块运维的实操路径【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 是一个基于 Android 内核的 root 解决方案它通过加载内核模块 hook 系统调用来实现 root不修改系统分区本身。本文覆盖从设备环境验证、LKM 与 GKI 两种安装模式各刷一条到日常模块运维与救砖的完整流程。读完你可以独立在 GKI 设备上完成 KernelSU 安装遇到问题时知道按什么顺序排查。先核查环境确认你的设备能跑 KernelSU这一节解决我能不能装的问题把前置条件一次性过完再动手能避免绝大部分返工。检查项最低要求查看方式命令/路径不满足时怎么办Bootloader必须支持解锁查厂商官方文档或 XDA 对应机型帖无法解锁则 KernelSU 不可用直接停止内核版本≥ 4.14adb shell uname -r低于 4.14 需自行移植详见官方 FAQGKI 支持内核版本符合 KMI 规范uname -r输出的命名格式管理器显示不支持的机型需自编译内核ADB / fastboot已安装且能识别设备adb devices出现设备序列号安装 SDK Platform-Tools 并开启 USB 调试原厂 boot 备份刷机前必须完成本地保存的 boot或 init_boot镜像文件从官方固件包提取后再继续最常见的前置翻车原因刷机前没备份原厂 boot。解法一句话——任何操作之前先把设备原始 boot 提取出来存在电脑上变砖时它就是你的退路。快速判断设备是否满足条件先查内核版本这条命令同时能帮你读出 KMIKernel Module Interface内核模块接口简单理解就是内核的插件标准KMI 相同的内核互相兼容adb shell uname -r # 输出示例5.10.101-android12-9-g30979850fc20其中 android12-9 就是 KMI再查 ADB 是否真正连通刷机全程依赖它adb devices最后装好 KernelSU 管理器并打开显示未安装说明设备支持可继续显示不支持则需自己编译内核集成官方不会提供现成 boot 镜像。需要提前准备的工具和文件ADB / fastboot 工具从 Android 开发者官网的 SDK Platform-Tools 下载内含 adb 与 fastboot 两个工具KernelSU 管理器 APK从项目官方 Release 页下载安装后用于检查设备状态和日常管理ksud 命令行工具从官方 Release 页下载对应系统macOS/Linux/Windows版本修补与模块管理都靠它你设备的原厂 boot或 init_boot镜像从官方固件包提取或后续用管理器直接安装时的自动备份可选magiskboot仅在 boot 镜像压缩格式不常见、需要手动修补时才用到刷入 KernelSU两种安装路径选一条跑通这一节是全文重点LKM 和 GKI 两条路径各走一遍只需 10 分钟你根据设备情况选一条走完即可。路径一LKM 模式保留原厂内核手机推荐LKM 模式通过可加载内核模块方式工作不替换原厂内核升级 OTA 都更方便。第 1 步拿到官方 boot 镜像从设备官方固件包中提取boot.img如果你的设备出厂为 Android 13 及以上提取的应该是init_boot.img。已用第三方内核的可以直接拿第三方内核的 boot 作为基础。这里容易手滑LKM 模式改的是 ramdisk出厂 Android 13 的设备要选 init_boot 分区而非 boot选错分区修补不会生效。第 2 步用 ksud 修补镜像在电脑上运行 ksud对官方 boot 打补丁ksud boot-patch -b boot.img --kmi android13-5.10 -o new-boot.img # --kmi ← 替换成你 uname -r 里读到的 KMI-o ← 输出文件名预期看到当前目录生成new-boot.img无报错输出。第 3 步刷入并重启长按电源键部分机型为电源音量下进入 fastboot 模式后执行fastboot flash boot new-boot.img fastboot reboot预期看到设备正常重启进系统打开管理器状态显示内核版本号。跑通验证在电脑上执行下面这条确认 root 已生效adb shell su -c id # 预期输出uid0(root) gid0(root) groups0(root)路径二GKI 模式整体替换内核冷门机型与模拟器适用GKI 模式用 KernelSU 提供的通用内核镜像替换设备内核通用性强适合三星 KNOX 设备、模拟器、WSA、Waydroid 等场景。第 1 步核对 KMI 与安全补丁级别用adb shell uname -r的输出确认w.x-androidNN-N部分和安全补丁级别你下载的 boot 必须与这两项都对得上KMI 相同但安全补丁更旧的内核在带防回滚机制的新设备上会无法开机。第 2 步下载匹配的通用 boot 镜像从官方 Release 页下载与你 KMI、安全补丁级别一致的 boot.img。同一 KMI 下通常有 lz4、gz 等几种压缩格式的文件请与你原厂 boot 的压缩格式保持一致小米常见 gz 或不压缩格式刷错可能直接无法开机。第 3 步刷入并重启⚠️ 此步将覆盖原厂内核。刷之前务必确认原厂 boot 已备份到电脑未备份的先完成备份再执行下面命令。fastboot flash boot boot.img fastboot reboot预期看到设备正常重启进系统。若卡 Logo 不动多半是 KMI 或压缩格式选错尽快进 fastboot 刷回原厂 boot见第四章。跑通验证adb shell su -c id # 预期输出uid0(root) gid0(root) groups0(root)两条路径怎么选直接说结论真机手机优先 LKM模拟器或 WSA 这类虚拟环境优先 GKI。维度LKM 模式GKI 模式内核处理保留原厂内核注入可加载模块整体替换为通用内核镜像升级 / OTA管理器内直接升级OTA 后装另一槽位即可固件内核变化后需重新刷 boot临时取消 root支持卸载模块即可无需重启不支持需卸载或刷回原厂跑通之后日常你会反复做的 5 件事这一节是装好之后的日常操作手册每个场景 1~3 步命令都可直接复制。怎么确认 root 真的生效了操作在终端执行adb shell su -c id输出以uid0(root)开头即为生效也可以打开管理器看状态栏的内核版本信息。注意root 生效不等于所有应用都能用。应用必须先经过管理器超级用户页的授权未授权应用执行 su 会被拒绝。怎么安装一个模块又怎么禁用它ksud module install xxx.zip # 安装模块安装包 ksud module disable id # 按模块 id 禁用重启后生效注意每次只装一个模块重启后观察至少 10 分钟稳定性修改 /system 的模块依赖 metamodule详见第五章。怎么临时取消 root 又不想刷写LKM 模式下执行ksud unload即可卸载内核模块root 立即失效且不用重启重启后自动恢复。注意该命令仅 LKM 模式可用。GKI 模式的内核已编译在内核镜像里无法临时卸载想停用只能卸载 KernelSU 或刷回原厂 boot。系统 OTA 之后 root 丢了OTA 后 A/B 设备会切到新槽位修补另一个槽位再重启即可ksud boot-patch -u # -u ← 自动选择 OTA 之后的另一个槽位进行修补或者在管理器里选安装 → 安装到另一个分区效果相同。注意OTA 通常不换内核KMI 不变如果厂商更新了内核先重新用uname -r核对 KMI 再修补。怎么开关内核功能su 兼容、日志、隐藏ksud feature list # 列出全部功能及当前支持状态 ksud feature set sulog 1 # 示例开启 root 日志0 关闭 / 1 开启功能 ID作用开启命令su_compat提供兼容层方便依赖传统 su 行为的应用ksud feature set su_compat 1sulog记录 root 事件日志排障时很有用ksud feature set sulog 1selinux_hide隐藏 SELinux 层面的相关痕迹ksud feature set selinux_hide 1卡住了按顺序排查常见故障排查总原则是先软后硬、先新后旧先试软件手段安全模式、禁用模块、ksud 命令最后才动 boot 分区先怀疑最近安装的模块再怀疑内核本身。你看到的现象最可能的原因第一步处理动作开机卡在 Logo 不动boot 的 KMI 或压缩格式不匹配进 fastboot 刷回备份的原厂 boot能开机管理器显示未安装内核未加载 KernelSU 模块adb shell uname -r核对 KMI 是否选错应用申请 root 无反应应用不在授权列表在管理器超级用户页授予该应用装完模块就无限重启模块脚本或挂载问题开机第一屏连续按音量下键 3 次进安全模式开机卡在 Logo 不动刷 boot 变砖第 1 步长按电源键或电源音量下进 fastboot 模式电脑端确认能识别设备识别不了先换数据线并检查 fastboot 驱动。第 2 步刷回备份的原厂 bootfastboot flash boot stock_boot.img # stock_boot.img 你之前备份的原厂 boot fastboot reboot如果输出OKAY并显示 finished说明刷写成功重启后应正常进入系统。若你此前没备份原厂 boot需要从对应机型、对应系统版本的官方固件包中提取后再执行。管理器显示未安装或 su 无响应第 1 步核对 KMI 是否刷错了adb shell uname -r如果输出里的 KMI 与你刷机时用的不一致比如 android13 的内核刷了 android12 的镜像说明刷错文件重新按正确 KMI 修补刷入即可。第 2 步检查 root 是否真正生效adb shell su -c id如果输出报错或权限拒绝说明内核模块没加载回第 1 步查 KMI如果输出 uid0(root)则 root 正常问题在应用授权一侧回管理器重新授权。第 3 步逐一核对模块ksud module list如果列表里有最近装过的问题模块先禁用它重启再逐个启用定位元凶。如果以上都无效把设备刷回备份的原厂 boot 镜像即可回到刷机前的初始状态——这也是为什么备份是整条流程的第一步。别踩的 3 个坑 进阶方向用 Android 版本号去选 boot 镜像错误做法系统是 Android 13就去下android13的内核镜像。正确做法永远以内核版本为准用uname -r读出 KMI 和安全补丁级别再对照下载。为什么内核版本在设备出厂时基本定型系统升级后通常不变拿 Android 版本号当依据必然 KMI 不匹配等待你的是无法开机。不做备份就直接刷写错误做法直接下载就刷出问题再想办法。正确做法任何刷写之前先把原厂 bootAndroid 13 以上 LKM 场景是 init_boot提取出来存到电脑。为什么变砖恢复依赖的就是刷回原厂 boot没有备份时你得重新找同型号同版本的官方固件去提取救砖难度直接翻倍。装修改 /system 的模块却不装 metamodule错误做法直接安装需要改 /system 文件的模块然后疑惑为什么文件没变化。正确做法先安装 metamodule如 meta-overlayfs再装功能模块只用脚本、sepolicy、system.prop 的模块则不需要。为什么KernelSU 的 systemless 修改 /system 依赖 metamodule 提供的 overlayfs 挂载基础设施缺了它挂载根本不会发生。想更深入的话仓库website/docs/zh_CN/guide/目录下有完整的中文文档安装指南 覆盖了手动修补 boot、Recovery 安装等变通方法救砖指南 提供了 ADB 手动管理模块、Recovery 清理等更底层的手段模块开发指南 则是自己写模块的完整参考。祝刷机顺利。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考