Magisk Root快速完整指南：拿到可维护的 Root 并保过系统升级

Magisk Root快速完整指南：拿到可维护的 Root 并保过系统升级

【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk

这篇文章面向第一次做 Magisk Root 的新手：从解锁 Bootloader 到系统升级，把全程会遇到的 6 个问题逐一回答并给出可执行的步骤。按文操作后你能得到三个可验证的结果——Magisk 应用首页Installed显示版本号、终端里执行su后提示符变为#、以及一套"保 Root 过 OTA"的标准流程。

值不值得拿这个 Root，代价是什么

结论先说：解锁 Bootloader 之后，以下东西会失去——

• 全部数据被清空：解锁流程强制恢复出厂，照片、聊天记录、应用数据需提前备份
• 保修受影响：各地政策有例外，建议先咨询当地售后
• 安全类功能受限：依赖安全环境的钱包、移动支付类应用可能无法使用
• 个别应用拒运行：部分银行、视频类 App 会检测 Root，后续可用 Zygisk 模块规避

这些限制是"合理代价"而非"系统惩罚"：Root 的本质是修改 boot 分区的内容，厂商无法再保证系统完整性，所以上述每一条都是这件事的直接推论。确认你能接受，再往下走。

需要准备什么：工具与固件清单

中途再找东西是最常见的翻车原因，动手前先把这份清单备齐：

⚠️ 所有文件放在英文路径下，中文路径是刷机失败的常见诱因。

如何确认机型是 A/B 分区还是单分区

是否 A/B 决定文章后半段的升级走法：A/B 机型有两套系统槽位，OTA 时可以"装到未使用槽位"保住 Root。

• 确认方法：看系统更新界面描述或查机型资料；拿不准就先继续，Magisk 应用里若出现"安装到未使用的槽位"选项，即为 A/B 机型
• 单分区机型 OTA 无法无缝保 Root，升级后需要重新打补丁，见后文对应章节

如何修补镜像：从提取 boot 到刷回的完整流程

全程只动一个分区（boot），顺序固定：解锁 → 取镜像 → 打补丁 → 刷回。安装 Magisk 应用后打开首页，你会看到类似这样的信息面板：

第一步：解锁 Bootloader

1. 关机状态下长按电源键 + 音量减键进入 Fastboot 模式，连接电脑 → 验证：fastboot devices列出设备
2. 执行fastboot oem unlock，按手机屏幕提示确认 → 验证：设备自动清空数据并重启，首次开机可能长达 10 分钟

⚠️ 解锁资格需提前在厂商账号申请，这段等待是全程最长的，建议最先开始。

第二步：看 Ramdisk 标识并提取镜像

1. 查看首页Ramdisk一栏 → 显示 Yes：按下面步骤走；显示 No：见本节末尾的分支
2. 从官方固件包解出boot.img（包里有init_boot.img则优先取它）→ 验证：文件存在且大小在几十 MB 量级
3. 把镜像拷入手机存储 → 验证：文件管理器中可见该文件

💡 无需自己判断机型是否有 ramdisk，应用首页的Ramdisk一栏就是检测结果，以它为准。

Ramdisk 显示 No 时的分支：

• 改提取recovery.img，走 recovery 方案，参见 docs/install.md 的 "Magisk in Recovery" 章节
• 极少数机型探测为 No 但 bootloader 实际接受 ramdisk；判断不了就按"Yes"流程试一次，以重启后能否拿到权限为准

第三步：打补丁、刷回并收尾

1. 点击 Magisk 卡片的Install，方式选"选择并修补文件"，选中镜像 → 验证：Download 目录生成magisk_patched_xxx.img
2. 用adb pull把修补后的镜像拉回电脑 → 验证：文件大小与手机端一致
3. 再次进入 Fastboot，执行fastboot flash boot magisk_patched_xxx.img→ 验证：命令无报错完成
4. 重启手机，打开 Magisk → 验证：Installed从 N/A 变为具体版本号

⚠️ 补丁必须在目标设备本机上打，别人分享的修补镜像一律不能用，刷错最轻的结果是强制清空数据。

如何验证：确认你真的拿到了 Root

验证顺序从应用到命令行，三项都通过才算可用：

1. Magisk 首页Installed显示版本号 → 若显示 N/A 但su仍能用，是隐藏应用的残留 stub 冲突，见 docs/faq.md 对应条目
2. 装一个终端模拟器，执行su→ 验证：提示符变为#
3. 执行magisk -c查看已安装版本号 → 验证：与首页显示一致

日常模块使用的三条纪律

• 一次只装一个模块并记录来源，出问题才能定位到具体模块
• Magisk 本体已移除内置隐藏功能，检测绕过需用 Zygisk 检测绕过类模块，并把目标应用加入隐藏名单
• system/vendor等只读分区优先用模块做 systemless 修改，直接改分区会破坏 block 校验，后续 OTA 直接失效

如何保 Root 过 OTA：系统升级的标准动作

OTA 能顺利走通的前提：你没动过system、vendor等只读分区。A/B 机型按下面四步操作，关键在两个"不要点重启"：

A/B 分区机型的标准动作

1. 收到更新通知后不要点重启，Magisk →卸载 → 恢复镜像，把 boot 还原为原厂 → 验证：提示恢复完成，此时仍不重启
2. 在系统设置中正常下载并安装更新，等"安装更新"与"优化设备"两步全部完成→ 验证：更新页面出现"可重启"提示
3. 仍不重启，Magisk →安装 → 安装到未使用的槽位，把 Magisk 写进刚更新的槽位 → 验证：提示安装完成
4. 回到系统更新页面点"立即重启" → 验证：切换新槽位后，Magisk 首页仍显示版本号

⚠️ 第 1 步完成后立刻点重启就会把 Magisk 卸载掉，这是整个流程里最高频的错误。

单分区机型的重刷路线

官方 OTA 无法无缝保 Root，稳妥做法是保留原厂 recovery、让升级完整刷完，然后重新打一遍补丁：

1. 完成官方 OTA 并重启 → 验证：系统版本号已更新，Root 消失属预期
2. 提取新版本boot.img，按前文流程打补丁并刷回 → 验证：Installed恢复为版本号

OTA 细节见 docs/ota.md。

出事了怎么办：故障排查与应急恢复

常见故障的定位与处理

安全模式按键时机是最容易踩的坑：Magisk 的检测比系统安全模式早，按网上教程的时机按可能只触发系统安全模式而模块没被禁用，按键要比动画出现前提前几秒。

变砖前的三道防线

按代价从小到大排列：

1. 恢复镜像：Magisk → 卸载 → 恢复镜像，一键回到原厂 boot，Root 消失但系统完好 → 验证：重启后正常进系统
2. Fastboot 重刷：设备还能进 Fastboot 时，执行fastboot flash boot boot.img刷回原厂镜像 → 验证：开机进入系统
3. 完整线刷：彻底救不了时用官方工具刷完整固件包，等效恢复出厂

三道防线共同的前提是解锁资格仍在手中：Bootloader 未重新上锁前，Fastboot 通道始终开放，这是最重要的安全网。

养成两个习惯能避开绝大多数麻烦：每次刷写前用adb pull备份对应分区镜像，只花几秒；重大系统版本更新前先查 docs/changes.md 确认当前 Magisk 版本的适配情况。

【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk