https://wiki.uotan.cn/index.php?action=history&feed=atom&title=Magiskboot
Magiskboot - 版本历史
2026-06-27T12:07:06Z
本wiki上该页面的版本历史
MediaWiki 1.41.0
https://wiki.uotan.cn/index.php?title=Magiskboot&diff=858&oldid=prev
InnoSofts-Bit：补全词条 magiskboot
2024-08-18T13:40:59Z
<p>补全词条 magiskboot</p>
<p><b>新页面</b></p><div>== 什么是Magiskboot ==<br />
magiskboot是magisk提供的一个解包boot/recovery的工具，magisk通过magiskboot来解包boot<br />
<br />
相对于其他解包工具（如AIK）而言，magiskboot的拆分较为简单<br />
<br />
你可以从[https://mrzzoxo.lanzoui.com/b02r7q0dg 来自KernelSU中文网的链接]下载magiskboot<br />
<br />
== 用法 ==<br />
输入magiskboot可直接查看用法<br />
<br />
'''注意，下文用法中，带<尖括号>的为必需参数，带[中括号]的为可选参数，传入参数时不要带上括号'''<br />
<br />
=== 解包 ===<br />
<br />
<pre>magiskboot unpack [-n] [-h] 镜像路径</pre><br />
<br />
解包镜像<br />
<br />
这将会把镜像解包成以下几个部分（如果有的话）:<code>kernel</code>, <code>kernel_dtb</code>, <code>ramdisk.cpio</code>, <code>second</code>, <code>dtb</code>, <code>extra</code>, <code>recovery_dtbo</code><br />
<br />
若指定<code>-n</code>参数，则每个部分都不会解压缩，保留原数据（如kernel会变成原有的压缩格式而不解压）<br />
<br />
若指定<code>-h</code>参数，则镜像头会被单独dump出来成为一个文件header，里面记录了<code>cmdline</code>，<code>android版本</code>和<code>android补丁</code>级别等数据<br />
<br />
可以查看程序输出以获得镜像的相关信息，如内核压缩方式等<br />
<br />
注意，即使指定了-h参数，打包时仍然需要传入原boot镜像路径<br />
<br />
程序返回值: 0:成功 1:错误 2:镜像来源为chromeos<br />
<br />
=== 打包 ===<br />
<pre>magiskboot repack [-n] <原镜像路径> [输出镜像路径]</pre><br />
<br />
将解包出的数据重新打包成镜像<br />
<br />
magiskboot将会从传入的boot路径读取相关信息（如cmdline）并打包<br />
<br />
若不指定输出boot路径，则输出到当前目录下的<code>new-boot.img</code><br />
<br />
若指定<code>-n</code>参数，则数据将不经过压缩操作就直接打包<br />
<br />
若unpack时未指定-n参数，则repack时也不应指定，反之亦然<br />
<br />
若在环境变量中设置<code>PATCHVBMETAFLAG</code>为true，则打包时会自动修补镜像中的'''vbmeta'''，添加禁用验证标识<br />
<br />
=== 验证 ===<br />
<pre>magiskboot verify <镜像路径> [x509.pem式的证书路径]</pre><br />
<br />
验证镜像是否被AVB1.0签名<br />
<br />
若传入证书路径，则会用证书验证镜像签名<br />
<br />
=== 签名 ===<br />
<pre>magiskboot sign <镜像路径> [name] [x509.pem/pk8私钥文件]</pre><br />
<br />
签名boot镜像<br />
<br />
若不传入私钥文件，则使用magiskboot内部的AOSP私钥签名<br />
<br />
TODO: <code>name</code>作用未知，默认为<code>/boot</code><br />
<br />
此操作将会直接覆写镜像<br />
<br />
=== 解包payload.bin ===<br />
<pre>magiskboot extract <payload.bin路径> [分区名] [输出路径]</pre><br />
<br />
解包payload.bin中的指定分区<br />
<br />
如果不指定分区，则解包init_boot.img（存在则解包这个）或boot.img<br />
<br />
默认输出路径为当前目录下<code>分区名.img</code><br />
<br />
可以通过将'''payload.bin路径'''传入<code>-</code>以接收标准输入，如在linux下可以<br />
<br />
<code>cat payload.bin | magiskboot extract -</code><br />
<br />
=== 十六进制修补 ===<br />
<pre>magiskboot hexpatch <文件路径> <hexpattern1> <hexpattern2></pre><br />
<br />
这将在文件中寻找<code>hexpattern1</code>，并替换为<code>hexpattern2</code><br />
<br />
示例: magiskboot hexpatch boot.img FE8067E4 A2586F7A<br />
<br />
这将直接覆写文件<br />
<br />
=== DTB相关 ===<br />
<pre>magiskboot dtb <文件> <动作> [参数]</pre><br />
<br />
magiskboot dtb相关功能<br />
<br />
动作:<br />
<br />
* <code>print</code> 以树的形式输出dtb内容，添加-f参数以仅输出<code>fstab</code>节点<br />
* <code>patch</code> 修补dtb，移除verity/avb验证，可通过环境变量<code>KEEPVERITY</code>控制<br />
* <code>test</code> 检测dtb中fstab的合法性，若程序返回值为0则合法，1则不合法<br />
<br />
=== 分割附加dtb的kernel ===<br />
<pre>magiskboot split [-n] <文件路径></pre><br />
<br />
将Image.*-dtb分割开为'''kernel'''和'''kernel_dtb'''<br />
<br />
若指定<code>-n</code>参数，则Image不会解压缩<br />
<br />
=== 输出文件sha1 ===<br />
<pre>magiskboot sha1 <文件路径></pre><br />
<br />
输出文件的sha1值<br />
<br />
=== 清理工作目录 ===<br />
<pre>magiskboot cleanup</pre><br />
<br />
清除magiskboot解包等操作的产物<br />
<br />
=== 压缩 ===<br />
<pre>magiskboot compress[=格式] <文件路径> [输出文件路径]</pre><br />
<br />
进行压缩操作<br />
<br />
文件路径与输出文件路径均可为<code>-</code>以接收标准输入/标准输出<br />
<br />
如果不指定格式，默认为gzip<br />
<br />
如果不指定输出文件路径，则为当前目录下'''文件路径加上该压缩格式的扩展名'''<br />
<br />
支持格式: gzip zopfli xz lzma bzip2 lz4 lz4_legacy lz4_lg<br />
<br />
=== 解压缩 ===<br />
<pre>magiskboot decompress <文件路径> [输出文件路径]</pre><br />
<br />
进行解压缩操作<br />
<br />
文件路径与输出文件路径均可为<code>-</code>以接收标准输入/标准输出<br />
<br />
若不指定输出文件路径，则为当前目录下'''文件路径去掉该压缩格式的扩展名'''<br />
<br />
'''注:如果要解压缩的文件无扩展名，则可能报错'''<br />
<br />
支持格式同压缩</div>
InnoSofts-Bit