ksud 命令行修补 boot 镜像——不用手机也能完成安装
ksud 是什么
ksud 是 KernelSU 官方提供的命令行工具,支持 macOS、Linux 和 Windows,从官方发布页下载对应平台的版本。它把管理器里的修补能力搬到了电脑上:不动手机就能完成 boot 镜像修补,适合习惯命令行、或需要批量处理镜像的玩家。
核心命令 boot-patch
查看帮助:
ksud boot-patch -h
最典型的用法:
ksud boot-patch -b <boot.img> --kmi android13-5.10
执行后会在输出目录生成修补好的镜像,再按 fastboot 手动刷入 的方法刷入即可。
常用参数速查
| 参数 | 作用 |
|---|---|
-b, --boot | boot 镜像路径;不指定时尝试自动查找 |
-k, --kernel | 要替换进去的内核镜像路径 |
-m, --module | LKM 模块路径;不指定用内置版本 |
--kmi | 手动指定 KMI(设备内核命名不规范时用) |
-u, --ota | 未指定 boot 时使用另一槽位 |
-f, --flash | 修补完成后直接刷入 boot 分区 |
-o, --out | 输出路径,默认当前目录 |
--magiskboot | 指定 magiskboot 路径,不指定则在环境变量中查找 |
--no-custom-rc | 禁用模块 init.rc 注入 |
两个细节
- KMI 指定:设备内核名字没有遵循 KMI 规范时,
--kmi是唯一的补救手段,参数格式如android13-5.10; - magiskboot:ksud 依赖 magiskboot 完成解包重打包。不指定路径时会在环境变量里找;Windows 用户可从社区构建的 magiskboot 版本获取。
与其他方法的取舍
- 想要全图形界面:用管理器的 三个安装选项;
- 镜像格式特殊(Pixel 的 lz4_legacy 等):ksud 与手动 magiskboot 修补都能处理,手动流程见 Recovery 与变通安装方法;
- 三星等设备请在能引导的环境下操作,变砖风险与恢复手段见 刷 boot 变砖恢复。