Magisk 完整指南：Android Root 与模块定制，从刷写到 OTA 保留权限
【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk
Magisk 是一套面向 Android 的开源 Root 与系统定制工具：通过修补 boot 镜像获得 root 权限，用模块机制修改只读分区而不改动/system，还能在 OTA 升级后保留 Root。下面按「先跑通、再理解、后深入」的顺序，给出从首次刷写到日常维护的完整路径。
先想清楚：你会在哪些地方卡住
动手之前，先把三个最常见的坑摆出来，后文的步骤都是围绕它们设计的：
- 怕变砖：改错 boot 分区后设备起不来，且不同厂商的恢复手段完全不同；
- 怕被检测：银行、支付类 App 会检查 root 痕迹，Root 后部分业务直接不可用；
- 怕失效：一次 OTA 之后 Root 就没了，之前的工作全部清零。
如果你的设备属于「解锁 Bootloader 即可刷写」的普通机型（大部分非三星设备都是这类），整个过程大约需要 30 分钟和一台电脑。
先跑通：不刷第三方 recovery 也能装 Magisk
现在主流的安装方式只有一条主线：在 Magisk App 里修补自己的 boot 镜像，再刷回自己这台设备。不需要第三方 recovery，也不需要在电脑上编译任何东西。
准备清单：
- 已解锁 Bootloader 的设备（解锁会清空数据，先备份）；
- 电脑上装好
adb和fastboot； - 从官方固件包或 ROM zip 中提取的
boot.img（若有init_boot.img则优先取它）。
操作流程：
- 把
boot.img拷进设备存储； - 安装 Magisk App，点击安装入口，选择「选择并修补一个文件」，选中刚才的镜像；
- 修补完成后，用
adb pull把生成的magisk_patched_*.img拉回电脑； - 重启进 fastboot，执行刷写：
adb reboot bootloader fastboot flash boot magisk_patched_*.img fastboot reboot- 开机后进入 Magisk App，按提示完成环境修复（会自动重启一次）。
两条硬性红线：
- 修补必须在目标设备上完成。别人的修补镜像、甚至同型号设备修补出来的镜像，都不要直接刷，轻则无法开机，重则需要全量清数据才能救回；
- 三星机型走的是另一套流程：Knox 保修位会被触发且不可逆，首次安装必须全量清数据，且刷写用的是 Odin 加修补后的
AP包。如果你用的是三星，先把 docs/install.md 里 Samsung 一节读完再动手。
装好之后，App 首页会给出当前设备的运行状态，其中Ramdisk 检测一项决定了你该修补哪个镜像——如果你的机型 boot 分区里没有 ramdisk，Magisk 会改走 recovery 分区，日常使用和开机方式都会不同，这部分同样写在 docs/install.md。
它凭什么不一样：不改 /system 也能改系统
传统 Root 方案要往/system里塞东西，分区内容一变，固件校验（verity）立刻不通过，检测结果也随之而来。Magisk 的做法不同，整个定制发生在启动流程里，而不是分区里：
- systemless 挂载：
magiskinit在开机最早期接管 init 流程，把 Magisk 的二进制和模块内容挂载进运行时文件系统（现代设备上基于/data/adb）。/system分区本身一个字节都不动，verity 校验自然通过，这也是「卸载即恢复原状」的原因——把镜像还原回去就行； - Zygisk 进程注入：Android 所有应用都由 zygote 进程 fork 而来。Zygisk 让模块代码在每个应用特化之前进入其进程运行，于是「全局生效」的修改不需要改系统文件，改的是进程启动时的行为；
- 属性与 SELinux 的定点修补：
resetprop可以直接改写连setprop都改不动的只读属性（ro.*）；sepolicy.rule则允许在原有策略上追加规则，而不是整包替换。
理解这三点之后，很多「为什么」都有答案了：为什么 OTA 相对容易、为什么卸载干净、为什么有些检测手段对它无效而另一些又必须靠第三方模块绕过——都是启动时挂载与进程级注入的直接结果。内部机制的更多细节见 docs/details.md 和 docs/boot.md。
能力盘点：三个板块够用
Magisk 对外提供的能力可以归成三块，日常使用基本都在这三块里。
权限与策略。su请求由 MagiskSU 统一裁决：按应用授权或拒绝、记录每一次 root 的日志、支持对特定应用做进程级隐藏策略。root shell 默认跑在独立的 SELinux 域里，规则边界清晰，不会像早期方案那样大面积放松沙箱。
模块与启动脚本。一个模块就是一个放在/data/adb/modules下的文件夹：module.prop声明身份，system/目录按相对路径递归合并进真实/system（同名文件被替换、新文件被注入），放.replace标记可以整目录替换，放一个 0/0 的假设备节点就能「删掉」一个系统文件。启动脚本分两个阶段：post-fs-data.sh在/data挂载后、系统服务启动前运行（阻塞启动，最多等 40 秒，慎用）；service.sh与系统并行启动，绝大多数脚本放这里就够。模块的完整结构说明在 docs/guides.md。
进程级与策略扩展。Zygisk 模块把.so注入每个应用进程，适合做全局行为修改；resetprop改属性、sepolicy.rule补 SELinux 规则，这三样组合起来，覆盖了「不用改系统文件」这一前提下能做的绝大多数定制。
真实场景：日常会遇到什么
模块管理：一个节奏问题
模块装多、装快是 bootloop 的最大来源。可执行的纪律只有一条：一次只装一个模块，重启确认稳定再装下一个。出问题时的两个逃生手段：
- USB 调试可用时：
adb shell里执行magisk --remove-modules，移除全部模块并自动重启； - 没有 USB 调试时：进系统安全模式（注意 Magisk 的按键检测早于系统安全模式，要在开机动画出现前就按住音量减，时机不对可能只触发了系统安全模式而模块没被禁用）。
OTA 之后怎么保住 Root
这是 A/B 槽位设备与非 A/B 设备体验差别最大的地方。
A/B 设备（绝大多数近几年的机型）：流程是「先还原、再更新、最后补装」。收到更新后不要点重启，先在开发者选项里关掉自动系统更新，然后走 Magisk App 的卸载入口执行「还原镜像」，把安装时备份的分区恢复成原厂状态以通过 OTA 前的校验，再正常完成 OTA。等「安装更新」和「优化设备」两个阶段都结束后依然不要点重启，改到安装入口选「安装到未使用的槽位」，把 Magisk 装进刚更新好的槽位，最后回到系统更新页面点重启切槽。全程数据不丢，Root 保留。
非 A/B 设备：没有好办法让 OTA 直接保留 Root，官方给出的做法是更新前还原原厂镜像、用原厂 recovery 完成 OTA，更新完成后再手动走一遍修补刷写流程，Root 需要重打。详细分支见 docs/ota.md。
三星：Root 之后无法再走系统内 OTA，升级必须手动下载新固件、在 App 里修补AP包再用 Odin 刷回（升级场景用HOME_CSC而不是CSC），并且永远不要把 boot/recovery/vbmeta 单独还原成原厂镜像。
写自己的模块
有脚本基础之后，自己做一个去预装模块的成本很低：一个 zip 里放module.prop、一个system/目录（把要删的目录放成 0/0 假设备节点）、一个service.sh，在 App 里直接刷入。两个容易踩的细节：脚本里取模块路径用MODDIR=${0%/*}，不要硬编码路径；post-fs-data阶段里用setprop会死锁启动，要改用resetprop -n。完整字段和安装器变量表在 docs/guides.md。
性能与隐私的边界
调频、内存、网络优化这类模块走的就是上面三个板块的常规能力，没有特殊通道。需要说清楚的一点是：Magisk 本体现在不做 root 隐藏，官方 FAQ 的口径是交给第三方 Zygisk 模块去做。如果你的核心诉求是银行 App 可用，选型时应该直接找这类模块并确认它支持你当前的 Magisk 版本，而不是指望内置功能。
排障：先看现象，再动手
设备装完模块后起不来。判断顺序：USB 调试是否开着 → 开着就adb shell magisk --remove-modules；没开就走安全模式组合键。起不来且反复重启时，先怀疑最近装的模块，而不是 Magisk 本身。
某个 App 报检测到 Root。确认 Zygisk 已开启（这类检测的绕过基本依赖 Zygisk 模块），再检查该 App 是否在策略里做了对应处理。只改 Magisk 设置是不够的。
App 显示已安装 = N/A，但 su 还活着。多半是「隐藏 Magisk App」生成的 stub 应用和完整应用并存冲突：去系统设置的已安装应用列表里找名字像「设置」或你当初起名的隐藏应用，逐个卸载，必要时重装完整版 App。
Ramdisk 检测为 No。你的机型大概率走 recovery 方案，每次开机方式与官方文档一致地变化，按 docs/install.md 的「Magisk in Recovery」小节操作，不要硬套普通流程。
三星设备任何「还原原厂分区」的念头。放弃。boot、recovery、vbmeta 单独还原原厂可能直接变砖，唯一救法是全量 Odin 恢复并清数据。
更完整的问答在 docs/faq.md。
入口与社区
- 本地文档按主题分文件：安装 docs/install.md、排障 docs/faq.md、开发者指南 docs/guides.md、工具集 docs/tools.md、OTA docs/ota.md、启动机制 docs/boot.md；
- 源码侧：启动与核心逻辑在 native/（
init/是 magiskinit，core/zygisk/是进程注入），App 端在 app/，模块安装脚本在 scripts/module_installer.sh； - 官方渠道只认 GitHub 仓库与官方文档站，发布页是唯一可信的下载来源；社区讨论集中在 XDA Developers 的 Magisk 版块。想自己编译的话，先读 docs/ 里的构建文档，仓库克隆地址为
git clone https://gitcode.com/GitHub_Trending/ma/Magisk。
最后说几句
Magisk 的价值不在于「能 root」这件事本身，而在于它把定制从「改分区」挪到了「改启动」，于是卸载可以回到原厂状态、OTA 多了一条可走的路、检测面也小了一圈。但工具不替你承担风险：解锁 Bootloader 之前的备份、三星 Knox 的不可逆、模块之间互相打架，这些边界条件不会因为流程跑通就消失。把「一次一个模块、OTA 前先还原、永远自己修补自己的镜像」当成默认习惯，剩下的事情就会简单很多。
【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
