# img4tool Apple IMG4 容器工具

> tihmstar 开发的命令行工具和 C++ 库，用于处理 Apple 的 IMG4 固件容器格式。它可以打印 IMG4 文件、IM4P 载荷容器和 IM4M 签名清单的 ASN.1 内容，包括载荷类型、描述和密钥包（KBAG）；也可从 IMG4 或 SHSH 文件中提取 IM4P 或 IM4M、从 IM4P 中提取载荷，自动解压 LZSS 或 BVX2（LZFSE）压缩数据，并在提供 IV 和密钥时解密。此外，它能根据 BuildManifest 校验 IM4M 票据或已签名的 IMG4，把 IM4M 转换为 SHSH，并为恢复工具构建或重命名容器。

- 类型：工具
- 目标：固件
- 类别：固件工具
- 关联：基础工具
- 来源复核于：2026-10-27
- 收录于：2026-11-03
- 原始资源：<https://github.com/tihmstar/img4tool>
- 一手来源：<https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/img4tool/>
- 记录 JSON：<https://awesomerea.org/resources/img4tool/record.json>
- 英文版：[English](https://awesomerea.org/resources/img4tool/index.md)

## 使用条件与局限

- 审阅时最新版本为 build 218，发布于 2026-01-29，提供的是 CI 生成的 macOS 和 Ubuntu buildroot 压缩包，而非打包好的安装程序。所审阅的 master 提交（2026-08-20 合并）比它多两个提交，合并了一项 generator 参数修复。版本号即仓库的提交总数。
- 从源码构建需要 autoconf、automake、libtool、pkg-config 和支持 C++11 的编译器，并依赖 tihmstar 的 libgeneral。libplist-2.0（用于读取 SHSH、校验和格式转换）以及用于解密和载荷哈希校验的加密后端（OpenSSL，macOS 上也可用 CommonCrypto）均为可选依赖；缺少加密后端时无法解密，校验也会提示无法检查载荷哈希。BVX2 支持需要 Apple 的 libcompression 或 liblzfse；可选的 libfwkeyfetch 构建会增加一个密钥查询选项。
- 输入文件为使用者自有的 IMG4、IM4P、IM4M 或 SHSH 文件以及 BuildManifest。仓库只有源码，没有提交任何 Apple 固件、票据或密钥；解密载荷所需的 IV 和密钥须由使用者自行提供。按文件头说明，附带的 LZSS 解码器（lzssdec.c）改编自 Jonathan Levin 的 joker 代码。
- 采用 LGPL-3.0 许可。容器创建、重命名和 IM4R generator 选项服务于恢复流程。

## 一手来源

1. <https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/README.md>
2. <https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/img4tool/main.cpp#L44-L199>
3. <https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/img4tool/img4tool.cpp>
4. <https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/img4tool/lzssdec.c#L1-L8>
5. <https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/configure.ac>
6. <https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/.github/workflows/main.yml>
7. <https://github.com/tihmstar/img4tool/blob/bb2d63494c58993f5c8ce2ed7df207ab1063587b/LICENSE>
8. <https://github.com/tihmstar/img4tool/releases/tag/218>

## 同分区更多条目：固件与硬件

- [payload dumper Android OTA 分区镜像提取工具](https://awesomerea.org/zh/resources/payload-dumper/index.md) · 工具
- [PMCA-RE RELOADED 索尼相机分析与管理工具](https://awesomerea.org/zh/resources/pmca-re-reloaded/index.md) · 工具
- [ThisFirmwareDoesNotExist MicroFreak 固件分析与补丁工具](https://awesomerea.org/zh/resources/thisfirmwaredoesnotexist/index.md) · 工具
- [intel_ma：管理固件分析与修改工具](https://awesomerea.org/zh/resources/intel-ma/index.md) · 工具
- [qemu-rtd2841 Realtek RTD2841 芯片组模拟器](https://awesomerea.org/zh/resources/qemu-rtd2841/index.md) · 工具
- [MS4X Siemens 发动机控制单元逆向工具与文档](https://awesomerea.org/zh/resources/ms4x/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。
