Magisk Root 上手指南：4 步解锁小米手机，OTA 升级不掉权限

Magisk Root 上手指南：4 步解锁小米手机，OTA 升级不掉权限

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

用 Magisk 给小米拿 Root，改的是 boot 分区而非系统。照本文 4 步走完，你会得到一台 Magisk 主页显示版本号、终端执行 su 直接出 # 的机器，外加一套升级保权与故障自救的完整方法。

先算清这笔账：得到什么，又失去什么

先给结论：解锁 Bootloader 之后，你会失去一些东西，得到一些东西。代价必须先摊开。

你得到什么	你失去什么
系统最高权限，终端 su 直接出 #	全部数据清空，小米官方解锁强制双清，照片、聊天记录、应用数据都要先备份
A/B 机型可保 Root 过 OTA	保修受影响，部分地区有例外政策，先咨询当地售后
模块生态，按需改机	安全类功能受限，小米钱包、Mi Pay 等依赖安全环境的应用可能不可用
长期可维护的 Root 方案	个别应用拒跑，银行、视频 App 会检测 Root，可后续用 Zygisk 模块规避

这些限制的底层逻辑只有一条：Root 的本质是改了 boot 分区，厂商无法再保证系统完整性。它们是合理代价，不是系统惩罚。确认能接受再往下走。

官方对风险的完整说明见 docs/README.md，boot 分区机制细节见 docs/boot.md。

备料清单：动手机前把东西备齐

中途再找东西，是刷机失败最常见的原因。开始前把这张表填满。

类别	内容	获取来源
电脑端	ADB + Fastboot 工具包	Android 官方开发者工具
电脑端	小米 USB 驱动	确保adb devices与fastboot devices能识别设备
账号	小米官方解锁资格	小米官网账号申请解锁码，等待期最长，建议最先提交
手机端	官方完整固件包	MIUI 官网下载对应机型当前版本，用来提取 boot.img
手机端	Magisk 应用	从本仓库获取最新版 APK 安装
手机端	开发者选项	开启 USB 调试，关闭自动系统更新，防止刷写被 OTA 打断

💡 两条省事提示：所有文件放英文路径下，中文路径是刷机失败的常见诱因；提前确认机型是 A/B 分区还是单分区，后续升级流程不同，A/B 机型能无缝保 Root。

动手四步：从解锁到刷回验证

整个安装概括为 4 个动作，按依赖顺序走。Magisk 不直接写进系统，只改 boot 分区里的内核启动流程，全程只动一个分区。

第一步：解锁 Bootloader，先拿资格再刷指令

没有申请到解锁资格的账号，这一步会卡住。

1. 关机后长按电源键 + 音量减键进 Fastboot 模式，小米入口和其他品牌不同，注意同时按。
2. 电脑连设备，执行fastboot oem unlock，按手机提示确认。
3. 设备自动重启并清空数据，首次启动可能长达 10 分钟，属正常现象。

验收：设备能正常进系统，且再次进 Fastboot 后fastboot devices仍能列出设备。

⚠️ 没有解锁资格的账号无法执行fastboot oem unlock，这是全篇唯一"卡住就走不下去"的一步。

第二步：提取 boot.img，先看 Ramdisk 再取镜像

打开已装的 Magisk 应用，看首页Ramdisk一栏，据此分两条路：

• 显示Yes（绝大多数小米机型）：从官方固件包解出boot.img，包里有init_boot.img就优先取它。
• 显示No：改为提取recovery.img，走 recovery 方案，见 docs/install.md 的 Magisk in Recovery 章节。

验收：电脑上得到 boot.img（或 init_boot.img），大小与分区相符。

💡 极少数机型探测为无 Ramdisk，但 bootloader 实际接受 ramdisk。判断不了就按"有 Ramdisk"试一次，以重启后是否拿到权限为准。

第三步：打补丁，让 Magisk 改写 boot

1. 把boot.img拷入手机存储。
2. 点 Magisk 卡片的Install，方式选Select and Patch a File，选中该镜像。
3. 完成后用adb pull把magisk_patched_xxx.img拉回电脑。

验收：手机上出现magisk_patched开头的文件，且已成功拉到电脑。

第四步：刷回并验证，Root 落地

全篇风险最高的一步，但只动一个分区。

1. 手机再次进 Fastboot 模式，执行fastboot flash boot magisk_patched_xxx.img刷入。
2. 重启，打开 Magisk 应用：Installed从 N/A 变为版本号即成功。
3. 装一个终端模拟器，执行su，提示符变#表示权限可用。

验收：Magisk 主页 Installed 显示版本号，终端 su 出#。

小米机型通常无需刷第三方 Recovery。官方 Recovery 保留完好，对后续 OTA 非常有利，这是小米相对其他品牌的重要优势。

拿到 Root 之后：日常用法与升级保权

Root 稳定后，日常靠模块，升级不掉权限靠顺序。

模块与分区：按需加装，克制修改

原则：按需安装、一次只加一个，出问题才能定位到具体模块。

• boot分区：Magisk 已接管，别再动。
• system、vendor分区：优先用模块做 systemless 修改。直接改分区会破坏 block 校验，后续 OTA 直接失效。

模块来源在 Magisk 应用"下载"标签页统一管理，安装、卸载、禁用都在模块页完成。需要隐藏 Root 时，选专门的 Zygisk 检测绕过模块（Magisk 本体已不再内置隐藏功能，见 docs/faq.md）。

升级不掉权限：A/B 与单分区两条路

升级时顺序错了会丢权限。前提：没改过 system、vendor 等只读分区。

A/B 分区机型（能保 Root）：

1. 收到更新通知后不点重启，打开 Magisk卸载 → 恢复镜像，把 boot 还原为原厂状态，通过 OTA 的完整性校验。
2. 正常下载安装系统更新，等"安装更新"和"优化设备"两步全部完成后，仍不点重启。
3. 打开 Magisk安装 → 安装到未使用的槽位，把 Magisk 写进刚更新的槽位。
4. 回系统更新页面点"立即重启"，设备切到新版槽位，Root 自动保留。

单分区机型：官方 OTA 无法无缝保 Root（见 docs/ota.md）。推荐保留原厂 recovery，让 OTA 正常刷完，再按上文的 4 步重新打补丁刷入一次即可。

出问题怎么办：排错手册与回退路径

出问题不可怕，可怕的是没预案。先看排错，再记回退。

排错手册：常见故障对照表

故障现象	定位思路	处理动作
开机循环（bootloop）	大概率模块冲突	USB 调试连电脑，执行adb shell magisk --remove-modules移除全部模块并自动重启
进不了系统、连不上电脑	模块把系统拖死	开机动画出现前几秒按音量减并保持，触发 Magisk 安全模式禁用全部模块。检测时机比系统安全模式早，按键要比网上教程提前一点
升级后 Installed 显示 N/A	隐藏过应用，残留 stub 包冲突	到应用管理找名为"设置"或自定义名的隐藏应用并卸载，再重装 Magisk 完整应用
应用检测出 Root	正常现象，需专门模块	装 Zygisk 检测绕过模块，把该应用加入隐藏名单
指纹/支付异常	安全类应用对 Root 敏感	针对对应应用单独启用隐藏，而非全局一刀切

回退路径：三道防线，代价从小到大

1. 还原 boot 分区：Magisk 应用 卸载 → 恢复镜像，一键回到原厂 boot。触发条件：想退 Root 或 Root 出问题。
2. Fastboot 重刷原厂 boot.img：设备还能进 Fastboot 时执行fastboot flash boot boot.img。触发条件：进不了系统但能进 Fastboot。
3. MiFlash 完整线刷：官方工具刷完整固件包，等效恢复出厂。触发条件：连 Fastboot 都进不去或分区混乱。

⚠️ 三道防线的共同前提是解锁资格仍在。Bootloader 未重新上锁前，Fastboot 通道永远开放，这是最重要的安全网。

收个尾

Magisk Root 的本质是修补 boot 而非改写系统，风险集中在刷镜像一步。A/B 机型按"还原镜像→装更新不重启→装到未使用槽位"的顺序，就能保 Root 过 OTA。

值得养成的习惯：每次刷写前用adb pull备份 boot 镜像，只要几秒；模块一次只装一个并记录来源；重大版本更新前先查 docs/changes.md 和 docs/app_changes.md 确认适配。Root 是工具不是玩具，用得克制才能用得长久。

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