Magisk 完整指南Android Root 与模块定制从刷写到 OTA 保留权限【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/MagiskMagisk 是一套面向 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 分区里没有 ramdiskMagisk 会改走 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/是 magiskinitcore/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），仅供参考 Magisk 完整指南：Android Root 与模块定制，从刷写到 OTA 保留权限
Magisk 完整指南Android Root 与模块定制从刷写到 OTA 保留权限【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/MagiskMagisk 是一套面向 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 分区里没有 ramdiskMagisk 会改走 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/是 magiskinitcore/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），仅供参考