Magisk 安装指南：给安卓 Root 打补丁的完整流程
【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk
Magisk 是目前最常用的安卓 Root 方案：它把注入点放在开机最早的 boot 阶段，只改 boot 镜像，系统分区原样保留。本文面向第一次安装 Magisk 的用户，从判断适不适合装，到修补刷入、日常使用和排障，把完整流程讲一遍。
先判断：谁适合装 Magisk，风险在哪
- 适合：想长期保留 Root，经常装模块、跟随官方 OTA，出问题要能退回原厂状态的用户
- 不建议：日常设备、主力工作机，或不愿意折腾 fastboot 的用户
- 必须知道：解锁 Bootloader 会清空全部数据，动手前完整备份
- 必须知道：刷错镜像（用了别人修补的）可能开不了机，救回往往要清数据
对比传统 Root（刷第三方 Recovery、直接改系统分区），Magisk 的差异：
- 改动面小：只写 boot 一类分区，只读系统分区一个字节都不动
- 可回退：用当初备份的原厂镜像刷回去即可卸载，不用重刷整机
- 系统完整性校验仍通过：官方 OTA 的分区校验照常过，升级路径不被切断
- 扩展统一：模块装、卸、禁用都走同一个 App，不依赖各家刷法
安装主线：准备、修补、刷入三个阶段
阶段一：安装前准备
输入：电脑、adb/fastboot 环境、最新 Magisk App、官方固件包。
动作：打开 App 看主页的设备信息卡，Ramdisk 一栏显示 Yes 就从官方固件提取boot.img（有init_boot.img时优先用它）；显示 No 则提取recovery.img，这类设备每次开机要先经特定按键组合进 Magisk，细节见官方安装说明 docs/install.md。
验收标准：确认了 Ramdisk 状态，手里有与本机型对应的镜像文件。
阶段二：在本机修补镜像
输入：阶段一备好的镜像。
动作：把镜像拷到手机，点 Magisk 卡片的 Install，方式选"选择并修补一个文件"选中镜像；修补 recovery 镜像时先勾选 Recovery Mode。完成后用下面命令把结果拉回电脑：
adb pull /sdcard/Download/magisk_patched-*.img命令执行完，电脑对应目录出现magisk_patched-xxxx.img即为成功。
验收标准：手机 Download 目录生成带随机后缀的修补镜像，且已拉到电脑。
⚠️ 修补只能在这台要装 Magisk 的手机上做。镜像里有设备相关数据，用别人分享或别台机器修补的镜像，轻则无法开机，重则要清数据才能救回。
阶段三：fastboot 刷入命令怎么写
输入：电脑上的修补镜像。
动作：手机重启进 fastboot，执行刷入和重启；分区名必须和镜像类型一致——boot、init_boot、recovery三选一：
fastboot flash boot magisk_patched-*.img fastboot reboot刷入时终端出现OKAY即写入成功。
验收标准：重启后打开 App，若弹"环境修复"提示就点确定，等它自动重启；之后主页显示 Magisk 版本号，说明 Root 已生效。若清过数据、主页只有临时引导应用，先用它自举安装完整 App。
装完能做什么：模块、OTA、授权管理
| 场景 | 做法 | 结果 |
|---|---|---|
| 模块 | 模块页选"从本地安装"，选 zip 后重启 | 功能生效；可一键禁用（重启恢复原状）或卸载 |
| 升级保留 Root | 开发者选项关自动更新 → App 卸载页"还原镜像"（此后别重启）→ 正常走完系统升级但先别点"立即重启" → App 选"安装到未使用槽位" → 回系统更新页点重启进新槽 | A/B 设备全程保住 Root；非 A/B 设备升级后 Root 丢失，需重走修补流程 |
| 授权管理 | 超级用户页对 su 请求逐条允许/拒绝，可按应用设授权超时 | 请求与授权都进日志，随时撤销或删除记录 |
进阶方向：模块开发与 Zygisk
💡 两个方向各给几句：
- 模块开发：模块就是放进
/data/adb/modules的 zip。module.prop声明 id、名称与版本；post-fs-data.sh在数据挂载后的阻塞阶段执行，service.sh在 late_start 服务阶段执行；需要额外 SELinux 权限时把规则写进sepolicy.rule。完整规范见模块开发指南 docs/guides.md。 - Zygisk：把代码注入每个应用的 Zygote 进程，在应用特化前挂上钩子。官方已不再内置 Root 隐藏，银行类应用检测的对策主要靠社区 Zygisk 隐藏模块；下载模块认准作者明确、更新活跃、规则说明清楚的来源。改 boot 镜像、调试开机流程的 magiskboot、resetprop 用法见工具手册 docs/tools.md。
排障速查
| 现象 | 原因 | 处理 |
|---|---|---|
| 刷完无法开机 | 刷了别人修补的镜像，或镜像与机型不匹配 | 用原厂 boot 镜像刷回救活；镜像只在本机修补 |
| 装完模块循环重启 | 新模块与系统冲突 | 用下方命令清空模块，或进 Magisk 安全模式（开机动画前几秒按住音量减，动画一出现就松手） |
| 银行、游戏检测出 Root | 官方不再内置 Root 隐藏 | App 设置开启 Zygisk，再装一个社区 Zygisk 隐藏模块 |
| 升级后 App 显示"已安装 = N/A" | 隐藏 stub 应用与完整应用冲突 | 到系统设置 → 应用找到隐藏的 stub（默认名叫 Settings）卸载，再重装完整 App |
模块冲突最稳妥的远程清除方式：
adb devices adb shell magisk --remove-modules第一条确认手机在线，第二条删除全部模块并自动重启，回来即可正常进系统。
下一步
对照官方安装说明 docs/install.md 完成刷入，卡住先查常见问题解答 docs/faq.md；想写模块或研究原理，继续读模块开发指南 docs/guides.md 与内部机制详解 docs/details.md。
【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
