KernelSU 实战指南从确认设备支持到刷入翻车自救的完整流程【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 是一套运行在 Android 内核空间的 root 方案它直接在内核中拦截系统调用并为用户态应用授予 root 权限不依赖传统用户态框架。这篇文章按自检设备 → 选择安装方式 → 启用模块 → 出事恢复的顺序把每个节点上你会看到的现象、该做的决定和具体操作串起来所有路径与命令均来自项目文档。动手前先确认你的设备能不能装刷机前有两个硬性前置条件缺一个后面的路都不通能解锁 Bootloader无法解锁的设备直接放弃这是 FAQ 中明确的前提。内核版本达标连接电脑后执行下面命令查看adb shell cat /proc/versionKernelSU 目前最低支持 4.14 内核出厂 Android 12 及以后的设备基本是 GKI 设备开箱即支持。然后安装 KernelSU 管理器并打开界面状态直接告诉你结论管理器显示含义下一步未安装设备受官方支持继续走安装流程不支持没有现成的 boot 镜像可用需自行编译内核集成 KernelSU官方不会也不愿提供 boot 镜像注意选不支持路线时非官方支持设备列表和非 GKI 设备集成教程可以作为参考但官方明确不会为你编译内核。刷之前必须弄懂的三个概念这三个概念决定了你下载/修补哪个镜像选错就直接变砖官方安装文档对此反复强调KMIKernel Module Interface相同 KMI 的内核互相兼容。GKI 设备内核版本形如5.10.101-android12-9-g30979850fc20其中5.10-android12-9就是 KMI。注意 SubLevel101不算在 KMI 内5.10.101和5.10.137的 KMI 相同。安全补丁级别新设备有防回滚机制刷入安全补丁比现有内核更旧的镜像可能无法开机。KMI 一致的前提下优先选安全补丁更新的内核。内核版本 ≠ Android 版本系统升到 Android 13 后内核版本号通常不变。刷机永远以内核版本为准而不是系统版本。选择安装方式GKI 模式还是 LKM 模式自 0.9.0 起GKI 设备上有两种安装模式二者的差别在于动不动原厂内核LKM 模式GKI 模式原理以内核模块LKM方式加载不替换原厂内核用通用内核镜像替换原厂内核优点保留原厂内核升级/OTA 无需手动刷写可随时卸载、甚至免重启通用性强三星 KNOX 设备、冷门魔改设备只能用它操作分区出厂 Android 13 的设备修补init_boot分区永远操作boot分区怎么选官方建议是——真机手机优先考虑 LKM模拟器 / WSA / Waydroid 优先考虑 GKI。如果你只是想要 root、又在意后续 OTA 省事LKM 是更稳的路如果你在用第三方内核或 KNOX 设备再走 GKI。第一步永远是备份原厂 boot无论选哪种模式动手前先备份dd if/dev/block/by-name/boot of/sdcard/boot_backup.img这是全文最重要的一条。后续所有刷坏了怎么办的方案本质都是把原厂 boot 刷回去。没有备份你就只能去翻官方固件包或找同机型用户提取成本和风险都高得多。LKM 模式的最小步骤最省事的路径是借助fastboot boot临时启动 KernelSU 的 GKI 内核获得临时 root再在管理器中直接安装——全程不需要手动下载固件、提取 boot用fastboot boot boot.img临时启动 KernelSU 内核安装管理器打开管理器 → 右上角安装图标 → 选择直接安装管理器自动识别设备信息、修补并刷入重启完成。如果设备不支持fastboot boot就需要手动下载官方固件提取 boot然后在管理器里选选择并修补一个文件。也可以用命令行工具ksud源码见 userspace/ksud/src/支持 macOS/Linux/Windowsksud boot-patch -b boot.img --kmi android13-5.10修补完成后把生成的镜像fastboot flash进对应分区即可。设备已 root 时管理器的直接安装还会自动备份原厂 boot或 init_boot到/data/adb/ksu/下卸载时的还原原厂镜像功能会直接调用它。GKI 模式的最小步骤核心思路只有一个把原厂内核换成 KernelSU 提供的内核。最直接的刷法fastboot flash boot boot.img fastboot reboot这里最容易翻车的点是内核压缩格式同一 KMI、同一安全补丁下通常有 lz4、gz 等不同压缩格式的镜像刷错格式会直接无法开机。用 magiskboot 解包原厂 boot 可查看原格式小米通常为gz或不压缩。Pixel 的lz4_legacy格式比较特殊官方推荐用 magiskboot 手动解包原厂 boot、替换其中kernel文件为 KernelSU 的 Image 再 repack这一步的详细操作在安装文档中有完整清单。如果设备有 TWRP 之类的自定义 Recovery也可以用 AnyKernel3 刷机包走 Recovery 路线KMI 和安全补丁的选择规则与上面完全一致。root 之后让模块真正跑起来刷好 boot 只是拿到 rootKernelSU 的价值一半在模块系统。这里有一个新手最容易忽略的前置步骤。重要如果你的模块需要修改/system文件必须先安装一个metamodule如meta-overlayfs。没有元模块模块的挂载功能不会生效而仅靠脚本、sepolicy.rule、system.prop的模块不需要元模块。元模块文档对此有说明。安装方式与常规模块相同管理器 → 点 ➕ → 选择元模块 zip → 重启。一次只能运行一个元模块管理器会拦截第二个的安装。模块的工作机制一句话版模块就是/data/adb/modules下的一个文件夹核心结构是module.prop模块的身份信息id、name、version缺了它就不算模块system/启动时以 overlayfs 叠加到系统/system上实现systemless修改post-fs-data.sh/service.sh/boot-completed.sh等在不同启动阶段执行脚本所有脚本都在 KernelSU 内置的 BusyBox/data/adb/ksu/bin/busybox中以独立模式运行。模块开发文档里有完整的目录结构和启动时序图。对普通用户来说记住两点就够了KernelSU 模块不支持在 Recovery 中安装必须在管理器中刷入模块与 Magisk 的 magic mount 机制互斥两边同时启用模块会导致 Magisk 不工作详见差异说明。进阶用 App Profile 给 root 上笼子授出 root 后如果想收紧权限可以在管理器的应用配置中为每个应用单独设置 Root Profile自定义su后的 UID/GID/groups、Capabilities 乃至 SELinux context。比如给防火墙应用去掉inet组它的su就无法访问网络。这套限制是在内核中强制执行的不依赖应用自身的自觉机制细节见App Profile 文档。出事了分三级恢复变砖不可怕可怕的是不知道从哪一级开始救。按下面的顺序逐级尝试前面的方法能解决时不要跳级。现象可能原因处理方式刷入新 boot 后直接不开机KMI 不匹配、压缩格式选错、安全补丁过旧fastboot 刷回备份的原厂 boot能进系统但循环重启/卡开机动画模块改坏了关键系统行为音量下键进安全模式卸载问题模块连系统都进不去ADB 也不通模块在 init 早期就破坏启动流程Recovery 中手动清理模块加载依赖以上全部无效模块带有恶意操作系统已损坏清除数据后刷完整官方系统第一级刷回原厂 boot能进 fastboot 模式长按电源键音量减时变砖问题基本都有解fastboot flash boot stock_boot.img fastboot reboot这里的stock_boot.img就是你第一步备份的文件。如果没有备份从官方固件包中提取或向同机型用户索要。第二级音量下键进入安全模式这是 KernelSU 内置的机制进入后所有模块全部被禁用。开机第一屏出现后连续按音量下键超过三次——注意是按下-松开重复三次不是长按。触发成功后在管理器的模块页面卸载可疑模块即可。两个容易踩的坑监听窗口只在启动早期on_post_fs_data阶段前有效设备启动快时要手快安全模式只会禁用模块不会跳过模块注入 initrc 的代码。如果模块的.rc文件本身写坏了启动流程安全模式也救不了需要走第三级。另外如果 ADB 能拿到 root shell也可以直接用ksud命令行处理比进安全模式更精确ksud module list # 列出所有模块 ksud module disable id # 禁用问题模块 ksud module uninstall id # 或直接卸载第三级Recovery 手动清理连 ADB 都不通时需要第三方 Recovery如 TWRP。KernelSU 的模块加载依赖内核侧的 init.rc 注入和用户态的 ksud 进程把这条链打断即可mount /data rm -f /data/adb/ksud mount /metadata rm -f /metadata/ksu/modules.rc rm -f /metadata/watchdog/ksu/modules.rc reboot重启后 KernelSU 会跳过所有模块加载正常进入系统后再回管理器处理。底线建议以上都无效时大概率是模块有恶意行为只剩两条路——清除数据刷完整官方系统或联系售后。所以装模块前务必确认来源[rescue-from-bootloop 文档](https://link.gitcode.com/i/e83a35b9051d662654a37dd752b71253)中专门警告了请勿刷入来路不明的模块。收尾清单走完全流程把这几件事固化成习惯刷机前备份原厂 boot永远放在第一位下载镜像时核对 KMI 安全补丁 压缩格式三要素依赖挂载的模块先装 metamodule每次只加一个模块重启观察稳定后再加下一个记住音量下 ×3和ksud module disable这两张底牌。KernelSU 的恢复机制设计得比多数 root 方案更宽容只要没动原厂 boot 备份绝大多数翻车都能收场。剩下的风险只来自两点——选错了镜像或者装了来路不明的模块。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
KernelSU 实战指南：从确认设备支持到刷入翻车自救的完整流程
KernelSU 实战指南从确认设备支持到刷入翻车自救的完整流程【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 是一套运行在 Android 内核空间的 root 方案它直接在内核中拦截系统调用并为用户态应用授予 root 权限不依赖传统用户态框架。这篇文章按自检设备 → 选择安装方式 → 启用模块 → 出事恢复的顺序把每个节点上你会看到的现象、该做的决定和具体操作串起来所有路径与命令均来自项目文档。动手前先确认你的设备能不能装刷机前有两个硬性前置条件缺一个后面的路都不通能解锁 Bootloader无法解锁的设备直接放弃这是 FAQ 中明确的前提。内核版本达标连接电脑后执行下面命令查看adb shell cat /proc/versionKernelSU 目前最低支持 4.14 内核出厂 Android 12 及以后的设备基本是 GKI 设备开箱即支持。然后安装 KernelSU 管理器并打开界面状态直接告诉你结论管理器显示含义下一步未安装设备受官方支持继续走安装流程不支持没有现成的 boot 镜像可用需自行编译内核集成 KernelSU官方不会也不愿提供 boot 镜像注意选不支持路线时非官方支持设备列表和非 GKI 设备集成教程可以作为参考但官方明确不会为你编译内核。刷之前必须弄懂的三个概念这三个概念决定了你下载/修补哪个镜像选错就直接变砖官方安装文档对此反复强调KMIKernel Module Interface相同 KMI 的内核互相兼容。GKI 设备内核版本形如5.10.101-android12-9-g30979850fc20其中5.10-android12-9就是 KMI。注意 SubLevel101不算在 KMI 内5.10.101和5.10.137的 KMI 相同。安全补丁级别新设备有防回滚机制刷入安全补丁比现有内核更旧的镜像可能无法开机。KMI 一致的前提下优先选安全补丁更新的内核。内核版本 ≠ Android 版本系统升到 Android 13 后内核版本号通常不变。刷机永远以内核版本为准而不是系统版本。选择安装方式GKI 模式还是 LKM 模式自 0.9.0 起GKI 设备上有两种安装模式二者的差别在于动不动原厂内核LKM 模式GKI 模式原理以内核模块LKM方式加载不替换原厂内核用通用内核镜像替换原厂内核优点保留原厂内核升级/OTA 无需手动刷写可随时卸载、甚至免重启通用性强三星 KNOX 设备、冷门魔改设备只能用它操作分区出厂 Android 13 的设备修补init_boot分区永远操作boot分区怎么选官方建议是——真机手机优先考虑 LKM模拟器 / WSA / Waydroid 优先考虑 GKI。如果你只是想要 root、又在意后续 OTA 省事LKM 是更稳的路如果你在用第三方内核或 KNOX 设备再走 GKI。第一步永远是备份原厂 boot无论选哪种模式动手前先备份dd if/dev/block/by-name/boot of/sdcard/boot_backup.img这是全文最重要的一条。后续所有刷坏了怎么办的方案本质都是把原厂 boot 刷回去。没有备份你就只能去翻官方固件包或找同机型用户提取成本和风险都高得多。LKM 模式的最小步骤最省事的路径是借助fastboot boot临时启动 KernelSU 的 GKI 内核获得临时 root再在管理器中直接安装——全程不需要手动下载固件、提取 boot用fastboot boot boot.img临时启动 KernelSU 内核安装管理器打开管理器 → 右上角安装图标 → 选择直接安装管理器自动识别设备信息、修补并刷入重启完成。如果设备不支持fastboot boot就需要手动下载官方固件提取 boot然后在管理器里选选择并修补一个文件。也可以用命令行工具ksud源码见 userspace/ksud/src/支持 macOS/Linux/Windowsksud boot-patch -b boot.img --kmi android13-5.10修补完成后把生成的镜像fastboot flash进对应分区即可。设备已 root 时管理器的直接安装还会自动备份原厂 boot或 init_boot到/data/adb/ksu/下卸载时的还原原厂镜像功能会直接调用它。GKI 模式的最小步骤核心思路只有一个把原厂内核换成 KernelSU 提供的内核。最直接的刷法fastboot flash boot boot.img fastboot reboot这里最容易翻车的点是内核压缩格式同一 KMI、同一安全补丁下通常有 lz4、gz 等不同压缩格式的镜像刷错格式会直接无法开机。用 magiskboot 解包原厂 boot 可查看原格式小米通常为gz或不压缩。Pixel 的lz4_legacy格式比较特殊官方推荐用 magiskboot 手动解包原厂 boot、替换其中kernel文件为 KernelSU 的 Image 再 repack这一步的详细操作在安装文档中有完整清单。如果设备有 TWRP 之类的自定义 Recovery也可以用 AnyKernel3 刷机包走 Recovery 路线KMI 和安全补丁的选择规则与上面完全一致。root 之后让模块真正跑起来刷好 boot 只是拿到 rootKernelSU 的价值一半在模块系统。这里有一个新手最容易忽略的前置步骤。重要如果你的模块需要修改/system文件必须先安装一个metamodule如meta-overlayfs。没有元模块模块的挂载功能不会生效而仅靠脚本、sepolicy.rule、system.prop的模块不需要元模块。元模块文档对此有说明。安装方式与常规模块相同管理器 → 点 ➕ → 选择元模块 zip → 重启。一次只能运行一个元模块管理器会拦截第二个的安装。模块的工作机制一句话版模块就是/data/adb/modules下的一个文件夹核心结构是module.prop模块的身份信息id、name、version缺了它就不算模块system/启动时以 overlayfs 叠加到系统/system上实现systemless修改post-fs-data.sh/service.sh/boot-completed.sh等在不同启动阶段执行脚本所有脚本都在 KernelSU 内置的 BusyBox/data/adb/ksu/bin/busybox中以独立模式运行。模块开发文档里有完整的目录结构和启动时序图。对普通用户来说记住两点就够了KernelSU 模块不支持在 Recovery 中安装必须在管理器中刷入模块与 Magisk 的 magic mount 机制互斥两边同时启用模块会导致 Magisk 不工作详见差异说明。进阶用 App Profile 给 root 上笼子授出 root 后如果想收紧权限可以在管理器的应用配置中为每个应用单独设置 Root Profile自定义su后的 UID/GID/groups、Capabilities 乃至 SELinux context。比如给防火墙应用去掉inet组它的su就无法访问网络。这套限制是在内核中强制执行的不依赖应用自身的自觉机制细节见App Profile 文档。出事了分三级恢复变砖不可怕可怕的是不知道从哪一级开始救。按下面的顺序逐级尝试前面的方法能解决时不要跳级。现象可能原因处理方式刷入新 boot 后直接不开机KMI 不匹配、压缩格式选错、安全补丁过旧fastboot 刷回备份的原厂 boot能进系统但循环重启/卡开机动画模块改坏了关键系统行为音量下键进安全模式卸载问题模块连系统都进不去ADB 也不通模块在 init 早期就破坏启动流程Recovery 中手动清理模块加载依赖以上全部无效模块带有恶意操作系统已损坏清除数据后刷完整官方系统第一级刷回原厂 boot能进 fastboot 模式长按电源键音量减时变砖问题基本都有解fastboot flash boot stock_boot.img fastboot reboot这里的stock_boot.img就是你第一步备份的文件。如果没有备份从官方固件包中提取或向同机型用户索要。第二级音量下键进入安全模式这是 KernelSU 内置的机制进入后所有模块全部被禁用。开机第一屏出现后连续按音量下键超过三次——注意是按下-松开重复三次不是长按。触发成功后在管理器的模块页面卸载可疑模块即可。两个容易踩的坑监听窗口只在启动早期on_post_fs_data阶段前有效设备启动快时要手快安全模式只会禁用模块不会跳过模块注入 initrc 的代码。如果模块的.rc文件本身写坏了启动流程安全模式也救不了需要走第三级。另外如果 ADB 能拿到 root shell也可以直接用ksud命令行处理比进安全模式更精确ksud module list # 列出所有模块 ksud module disable id # 禁用问题模块 ksud module uninstall id # 或直接卸载第三级Recovery 手动清理连 ADB 都不通时需要第三方 Recovery如 TWRP。KernelSU 的模块加载依赖内核侧的 init.rc 注入和用户态的 ksud 进程把这条链打断即可mount /data rm -f /data/adb/ksud mount /metadata rm -f /metadata/ksu/modules.rc rm -f /metadata/watchdog/ksu/modules.rc reboot重启后 KernelSU 会跳过所有模块加载正常进入系统后再回管理器处理。底线建议以上都无效时大概率是模块有恶意行为只剩两条路——清除数据刷完整官方系统或联系售后。所以装模块前务必确认来源[rescue-from-bootloop 文档](https://link.gitcode.com/i/e83a35b9051d662654a37dd752b71253)中专门警告了请勿刷入来路不明的模块。收尾清单走完全流程把这几件事固化成习惯刷机前备份原厂 boot永远放在第一位下载镜像时核对 KMI 安全补丁 压缩格式三要素依赖挂载的模块先装 metamodule每次只加一个模块重启观察稳定后再加下一个记住音量下 ×3和ksud module disable这两张底牌。KernelSU 的恢复机制设计得比多数 root 方案更宽容只要没动原厂 boot 备份绝大多数翻车都能收场。剩下的风险只来自两点——选错了镜像或者装了来路不明的模块。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
