使用工具快速解包 Android 固件和 EROFS 分区镜像
本文字数：1912 字
阅读时长约为：20 分钟
阅读难度：中
前言随着 Android 引入无缝更新后，系统固件从原本简单直接的内容压缩包（下图一）转变成了并那么不直白的 payload.bin 镜像分区打包（下图二）。流行的 Root 工具 Magisk，KernelSU 等需要提取对应 init_boot 或者 boot 分区镜像修补刷入，增加了使用难度。
图一：MIUI 7 线刷包解压图二：一加 12 全量升级固件包解压5ec1cff 大佬修改的 payload-dumper 工具添加了对从来自网络的包含 payload.bin （的 zip 归档）的 url （如 OTA 更新地址）直接提取分区的支持，简而言之，提取所需的镜像不再需要下载数个 GB 的完整系统固件，只需要少量的时间和存储空间就能从 OTA 更新包或地址中提取你想要的分区。
另一方面，像 F2FS，EROFS 这些更新更高效的文件系统开始广泛应用，让提取和打包对应的分区镜像变的复杂。本文目的在于分享在线提取分区镜像以及解包 EROFS 镜像的简单办法。
payload.bin 简单转储办法在线提取分区镜像（感谢 PedroZ）用法比较简单，上方 Partition Name 填写所需要提取的分区名，例如 boot，init_boot，vendor_boot 等，注意一次只能填写一个分区，下放粘贴固件下载地址即可，完成后点击 submit 稍等片刻就会进行所需的分区下载。
FastbootEnhance（仅支持 Windows）适用于 Windows 的图形化工具，支持导入系统固件提取分区镜像，也支持 Fastboot 和 FastbootD 状态下刷写分区镜像。
命令行工具使用教程所需准备支持 Windows（WSL2），Linux，macOS 和 Android。Windows 推荐微软商店安装 Fedora WSL 方便操作，macOS 需安装 Homebrew 包管理器，Android 则需要安装 Termux 进行操作。
brew install pip python git erofs-utilssudo dnf install pip python git erofs-utils安装所需的包后，便可以安装我们所需的 payload-dumper 在线提取分区镜像。
pip install git+https://github.com/5ec1cff/payload-dumperAndroid 需要的额外准备“我”发现获取某些分区的时候仍然存在需要下载大量数据的问题。
经调查，发现原因是 python 的标准库 zipfile 直到 3.12 才支持在未压缩的 zip 中快速 seek 。在此之前， seek 的实现必须要完整读取 seek 到的位置之前的内容，这可能是由于压缩数据流必须完整读取才能解压。
不过 ota 更新包中的 payload.bin 在 zip 中往往是未压缩，并不需要完整读取。这意味着，在 python 3.12 之前，假如要读取的分区所在偏移恰好非常大，则仍然需要下载很多不必要的数据。
综上，建议使用 python 3.12 运行该程序以获得最佳性能。
由于 Termux 仓库的 Python 版本仍是旧版 3.11，存在需要大量下载文件的问题，好在有他人做好现成的 Python 3.12 for Termux，为我们省去了修补和编译的大量时间。以下是手动安装教程。
首先需要下载所需的 python-3.12.3-aarch64.tar.zst 二进制包并进行解压，为了方便，将两次解压后获得的 python-3.12.3 文件夹放置于手机内置存储根目录。之后打开 Termux 进行剩余操作。
pkg install stow python git erofs-utils
cd /sdcard #移动到内置存储根目录
mkdir -p $PREFIX/stow
mv python-3.12.3 $PREFIX/stow/ #移动解压后的二进制包到所需目录
cd $PREFIX/stow
stow -v --stow python-3.12.3
chmod +x python-3.12.3 #对文件添加执行权限
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py #下载 pip 安装脚本
python3.12 get-pip.py #运行 pip 安装脚本
python3.12 -m pip install git+https://github.com/5ec1cff/payload-dumper #安装 payload-dumper
echo export PATH=$PATH:/data/data/com.termux/files/usr/stow/python-3.12.3/bin >> ~/.bashrc #添加环境变量payload-dumper 用法我们可以通过命令查看 payload_dumper 用法。
payload_dumper -h
usage: payload_dumper [-h] [--out OUT] [--diff] [--old OLD]
[--partitions PARTITIONS] [--workers WORKERS] [--list]
[--metadata]
payloadfile
OTA payload dumper
positional arguments:
payloadfile payload file name
options:
-h, --help show this help message and exit
--out OUT output directory (default: 'output')
--diff extract differential OTA
--old OLD directory with original images for differential OTA
(default: 'old')
--partitions PARTITIONS
comma separated list of partitions to extract
(default: extract all)
--workers WORKERS number of workers (default: CPU count - 8)
--list list partitions in the payload file
--metadata extract and display metadata file from the payload不理解没有关系，下面说明会用到的命令结构。
payload_dumper payloadfile --out OUT --partitions PARTITIONS
调用的工具 系统固件，可以是文件目录也可以是在线链接 可选命令，不输入也不影响使用，out 后续跟文件输出目录，partitions 后续跟所需镜像分区需补充的是文件目录并不需要手动填写，用文件管理拖动对应的文件夹/文件即可粘贴文件目录（PS：WSL2 是以网络路径访问本机，第三方 Fedora WSL 可以自动转化添加 /mnt/ 可以直接拖动粘贴，因此推荐使用）
我们可以通过下面两个实例来理解使用。
通过在线链接提取例如我们需要从 一加 OnePlus ACE 3 Pro 全量包 提取 boot 镜像，我创建了一个镜像分区的文件夹，并将目录拖动到 --out 后方，回车稍等片刻需要的 boot.img 变回出现在新建的文件夹中。
payload_dumper
https://gauss-componentotacostmanual-cn.allawnfs.com/remove-4389ca2b1cc4aa10c775178c4edae79e/component-ota/24/06/25/33e6b8725c924367b8079b3add65a8db.zip # OTA 固件下载地址
--partitions boot # 分区声明，后面跟所需的 boot 分区
--out /Users/zhouyu/Downloads/镜像分区 # 文件输出路径，后面跟文件目录通过本地固件提取例如需要从下载完成解压完成的固件提取 system 镜像，我们如法炮制即可，稍等后所需的 system.img 便出现在相应的目录内。
payload_dumper
/Users/zhouyu/Downloads/d19651b82745466c8eb65426ef23c072/payload.bin # payload.bin 文件目录
--partitions system # 分区声明，后面跟所需的 system 分区
--out /Users/zhouyu/Downloads/镜像分区 # 文件输出路径，后面跟文件目录
EROFS 分区镜像解压根据官方文档 erofs-utils 分为如下四个部分，
erofs-utils
===========
Userspace tools for EROFS filesystem, currently including:
mkfs.erofs filesystem formatter
erofsfuse FUSE daemon alternative
dump.erofs filesystem analyzer
fsck.erofs filesystem compatibility & consistency checker as well
as extractor因为我们只需要解压分区镜像，所以只需要使用其中的 fsck.erofs 即可，解压方法如下。
fsck.erofs --extract[=X] IMAGE
调用的工具 可选命令，“=”后方跟解压目录 分区镜像我们使用上方解压获得的 system.img 作演示，并新建名为系统分区的文件夹，输入命令后即可获得所需的系统文件内容。
fsck.erofs
/Users/zhouyu/Downloads/镜像分区/system.img # 分区镜像目录
extract=/Users/zhouyu/Downloads/系统分区 # 解压目录