MagiskBoot 完整教程3 个步骤解包、修改并重打包 boot 镜像【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/MagiskMagiskBoot 是 Magisk 项目自带的命令行工具源码见 native/src/boot/负责 Android 启动镜像修改把 boot.img 拆成 kernel、ramdisk、dtb 等独立文件改完再按原格式重打包。刷第三方内核、给 boot 分区注入 Magisk本质都是这套 boot.img 解包重打包流程。这份 MagiskBoot 使用教程只写最短可跑通的路径。boot.img 解包后能得到哪些文件unpack解析镜像 header 后把各 section 按名导出到当前目录检测到压缩时会先解压再写盘-n可跳过解压保留原始格式文件内容kernelLinux 内核本体kernel_dtb与内核打包在一起的设备树部分机型才有ramdisk.cpio初始内存文件系统cpio 归档Magisk 的注入点dtb/extra/second独立设备树、附加数据、二级加载器存在才导出recovery_dtborecovery 的设备树 overlay存在才导出header加-h参数时导出含 cmdline 等配置repack 时可据此修改GKI 一类把 DTB 嵌在image里的机型拆出来的是image.*-dtb还需要split命令拆成kernel和kernel_dtb两份。三步主流程unpack 解包、修改组件、repack 重打包./magiskboot unpack boot.img ./magiskboot cpio ramdisk.cpio patch ./magiskboot repack boot.img new_boot.imgunpack解析 header导出全部组件这是所有后续修改的基础。修改动 ramdisk 用cpio子命令ls、add MODE ENTRY FILE、rm、patch等参数见 docs/tools.md换内核就替换kernel文件改 cmdline 等就编辑header文件。repack以原始镜像为模板重建只更新 section 大小、校验和等必要字段各组件按原格式重新压缩。注意它只读当前目录的文件目录里有多余文件可能被打进新镜像不指定输出名时默认生成new-boot.img。两个真实用途注入 Magisk 与替换内核给 boot 镜像注入 Magisk目标保留官方 boot 的内核与 cmdline只改 ramdisk拿到 root。操作./magiskboot unpack boot.img ./magiskboot cpio ramdisk.cpio patch ./magiskboot repack boot.imgcpio patch应用 ramdisk 补丁环境变量KEEPVERITY/KEEPEFORCEENCRYPT控制是否保留 verity 与强制加密完整流程会先用cpio backup备份原始 ramdisk。Magisk App 里的 Patch Image 按钮内部走的正是同一套流程手动执行的价值在于每一步都可控。刷入后在 Manager 首页确认 Ramdisk 状态为 Yes即注入成功注意先跑./magiskboot verify boot.img确认原镜像是否带 AVB 1.0 签名启用 AVB 的机型改完后签名问题要单独处理。替换自定义内核目标用第三方内核替换官方内核其余组件原样保留。操作./magiskboot unpack stock_boot.img # 用新内核覆盖当前目录的 kernel 文件 ./magiskboot repack stock_boot.img custom_boot.img注意DTB 嵌在image里的机型必须先split拆出kernel和kernel_dtb只替换kernel会把 DTB 弄丢header 里的偏移、大小字段由 repack 自动重算cmdline 不要顺手改改了大概率开不了机。翻车预防与自救bootloop、刷错 slot、OTA 覆盖现象原因处理unpack 报无效 header返回码 3文件不是标准 boot 镜像可能是 vendor_boot 或拿错了分区确认取的是官方固件里的 raw boot 分区别用其他镜像文件试重打包后 bootloop当前目录有无关文件被 repack 读入或 header 字段被改动在干净目录重新 unpack 再 repackheader 改动还原原值刷入后系统仍跑旧 bootA/B 设备刷错了 slot用 fastboot 查 active slot刷对应的boot_a/boot_bOTA 升级后 Magisk 没了更新覆盖了你改过的分区块校验失败升级前在 App 里执行 Restore ImagesA/B 设备 OTA 后用 Install to Inactive Slot 重装流程见 docs/ota.md换了压缩格式后不启动给已压缩的组件重复压缩或算法与设备不匹配交给 repack 按原格式自动压缩-n仅在组件本身已是压缩格式时使用支持 gzip/lz4/lzma/xz/bzip2 等回滚方案改坏了怎么刷回原镜像动手前先留底这是所有自救的前提cp boot.img boot_stock.img改坏后的标准动作两条命令刷回去fastboot flash boot boot_stock.img fastboot rebootA/B 设备把分区名换成实际的boot_a/boot_b。如果当初是通过 App 安装的 Magisk卸载对话框里的 Restore Images 会用安装时的备份把分区恢复成原厂状态只移除 Magisk 的改动不用电脑介入一句话备忘先备份原始 boot.img再碰任何文件流程先在模拟器或备用机上验证一遍repack 只读当前目录目录保持干净A/B 设备先确认 active slot 再刷改 header、动压缩格式之前先弄懂字段含义【免费下载链接】MagiskThe Magic Mask for Android项目地址: https://gitcode.com/GitHub_Trending/ma/Magisk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考