从 KernelSU 切换
约 1269 字大约 4 分钟
迁移时保留 /data/adb 和现有模块。先备份配置并确认当前是 built-in KernelSU 还是 KernelSU LKM;非标准集成需单独核对恢复路径。
关键思路
先把 YukiSU 管理器安装到当前 KernelSU 环境,并由 KernelSU 授予它 Root。这样 YukiSU 管理器就能在当前开机周期内完成镜像恢复或直接安装。
开始前准备
准备这些就够了:
- 设备运行 Android 12(API 31)及以上,并属于 YukiSU 支持的 ARM64、GKI 2.0、Linux 5.10+ 范围;
- 已安装最新 YukiSU 管理器;
- 有匹配当前内核 KMI 的 YukiSU LKM;
- 如果当前是 built-in KernelSU,准备与当前固件完全匹配的原厂 boot;
- 保留正常的 bootloader / fastboot 恢复手段。
在 KernelSU 管理器中给 YukiSU 管理器授予 Root。首次迁移使用默认 APK 签名认证即可,不需要设置 SuperKey。
当前是 built-in KernelSU
这里指 KernelSU 已经编入当前启动内核,例如 CONFIG_KSU=y 或替换 GKI 内核的安装方式。
- 安装 YukiSU 管理器,并在 KernelSU 管理器中授予它 Root;
- 使用 KernelSU 的恢复功能还原当前固件的原厂 boot;
- 还原完成后不要重启;
- 直接打开 YukiSU 管理器,明确选择传统 Ramdisk 或 ImgPatch,再用直接安装把匹配 KMI 的 YukiSU LKM 写进刚恢复的启动链;
- 安装完成后重启。
关键就是还原后别急着重启。磁盘上的 boot 已经恢复了,但内存里跑的还是 KernelSU 内核,刚授予 YukiSU 管理器的 Root 也还在。趁这一轮直接把 YukiSU 装好,再重启,一步到位。
注意
还原的 boot 必须与当前固件和槽位匹配。不要使用同机型旧版本镜像,也不要在 OTA 槽位状态不明时猜测目标。
当前是 KernelSU LKM
LKM 切换更简单:不需要先还原镜像,也不需要卸载现有 KernelSU LKM。
- 安装 YukiSU 管理器;
- 在 KernelSU 管理器中授予 YukiSU 管理器 Root;
- 在 YukiSU 管理器中选择匹配 KMI 的 LKM 与目标布局并直接安装;
- 安装完成后重启。
继续使用传统 Ramdisk 时,YukiSU 会替换旧布局中的 LKM 与用户空间。切到 ImgPatch 时,后端只把 capsule 写进 boot,并在设备安装过程中清理由旧 KernelSU Ramdisk 留在 boot / init_boot 的已知文件。检测到 Magisk Ramdisk 或不能安全清理的内容时会停止;不要手动删一半后继续。
两种布局的输入与恢复方式见安装与镜像模式。
模块、MetaModule 与配置怎么办
可以保留现有数据,但迁移前应备份,并在迁移后核对实际兼容性:
| 内容 | 迁移处理 |
|---|---|
| 普通 KernelSU 模块 | 保留;YukiSU 按上游生命周期继续处理 |
| MetaModule | 保留;YukiSU 继续处理其生命周期与挂载脚本 |
| 模块配置 | 保留在原位置,无需批量导出重建 |
| Root 授权 / App Profile | 保留原数据;重启后逐项确认授权和 Profile,异常项从备份恢复或重新配置 |
| Zygisk Next 与其模块 | 可以继续使用;若改用 YukiZygisk,先停用外部运行时,再开启 YukiZygisk |
| KernelSU 管理器 | 确认 YukiSU 正常后即可卸载 |
别因为换了 Root 就顺手重装 MetaModule。只有模块自己绑定了某个 Android 版本、内核、挂载后端或私有接口时,才需要单独处理。
当前 YukiSU 还包含内置 Kagami:没有启用的外部 metamount.sh 时会使用它;已有外部后端仍优先。不要在迁移 Root 的同时无意切换挂载后端。见模块挂载。
重启后确认
重启后逐项检查:
- YukiSU 管理器显示已安装,运行中的 LKM 对应所选构建,设备侧
ksud与 APK 内置版本一致; - 首页显示的 Ramdisk 或 ImgPatch 运行方式与迁移时选择一致;
- 已授权应用可以正常请求 Root;
- MetaModule 和普通模块状态仍在;
- 需要系统文件挂载的模块实际生效;
- 如果启用 YukiZygisk,单独确认其状态与模块加载结果。
都正常的话,就可以卸载旧 KernelSU 管理器了。它在迁移过程中只是负责“借”一次 Root 给 YukiSU 管理器,任务已经完成。
安装没有继续时
如果 YukiSU 管理器报告 KMI 不匹配、找不到合适 LKM、目标分区不明确或镜像校验失败,应停在当前步骤并核对设备与固件信息。不要关闭版本检查或强行加载不匹配模块。
若设备本身是厂商或自编译内核中的非标准 KernelSU 集成,也无法通过恢复普通 boot 去掉旧实现,应先切换到不包含旧 KernelSU 的兼容内核,再安装 YukiSU。
还没有决定是否切换时,可先看 YukiSU 与 KernelSU 的区别;需要恢复启动链时,参考救砖与恢复。