从零构建 ipadecrypt:Docker 工具链、credmint 包与 helper 重编译完整教程
从零构建 ipadecrypt:Docker 工具链、credmint 包与 helper 重编译完整教程
🔓 ipadecrypt 是一款开源的 App Store 应用 FairPlay 解密工具:给它一个 bundle ID,就能下载并解密出未加密的 .ipa。本文带你从零构建 ipadecrypt 的全部三个组件——Go 编写的 CLI、Docker 编译的 credmint 设备包,以及用于旧 32 位应用的 helper 解密程序,全程无需 Xcode 和 macOS。
🧩 先搞懂:ipadecrypt 由哪三部分组成?
按照 BUILDING.md 的说明,ipadecrypt 的构建产物分为三块:
| 组件 | 形态 | 存放位置 | 用途 |
|---|---|---|---|
| ipadecrypt CLI | Go 单文件二进制 | cmd/ipadecrypt/ |
日常开发和解密的核心程序 |
| credmint 设备包 | 3 个 arm64 iOS 程序 + 2 个数据文件 | internal/credmint/bundle/ | 首次 bootstrap 时一次性提取 Apple 账户凭证 |
| on-device 解密 helper | 单个 arm64 iOS 程序 | internal/device/ | 兜底解密仍携带 32 位 (armv7) 代码片的旧应用 |
其中后两者都已通过 go:embed 嵌入 CLI(见 internal/credmint/bundle.go 和 internal/device/ops.go),普通 go build 即可得到完整功能的二进制,Docker 重编译只在以下场景需要:
- 你修改了 helper/ 目录下的 C 源码
- 上游 fairplay-decrypt 的设备端代码有更新,需要刷新 credmint 包
💡 也就是说:日常使用者只需要第 3 节的
go build,第 4~6 节是给维护者和进阶用户的。
📦 环境准备:安装 Go 与 Docker
构建 ipadecrypt 只需要两样东西:
- Go 1.25+(当前 go.mod 声明为 go 1.26.5),CLI 是纯 Go 实现,
CGO_ENABLED=0可交叉编译到所有发布平台 - Docker(仅重编译设备端组件时需要,Linux / macOS 均可)
Docker 工具链镜像已经内置了三样关键工具(见 helper/Dockerfile):
clang+lld:目标为arm64-apple-ios,在 Linux 上交叉编译 iOS 程序- iPhoneOS SDK(26.4 版):提供头文件和 tbd 库
- ldid:用 entitlements 做 ad-hoc 签名,让程序能跑在越狱设备上
整个 Dockerfile 采用三阶段构建:ldid-builder 从源码编译 ldid,sdk-fetcher 拉取并裁剪 SDK,最终镜像只保留运行所需组件,保持镜像精简。
🚀 最快上手:一键构建 ipadecrypt CLI
进入仓库根目录(clone 地址为 https://gitcode.com/gh_mirrors/ip/ipadecrypt),执行:
# 普通开发构建
go build -o ipadecrypt ./cmd/ipadecrypt
想要发布级别的精简二进制(去掉调试符号和路径信息):
go build -trimpath -ldflags="-s -w" -o ipadecrypt ./cmd/ipadecrypt
构建完成后,ipadecrypt 就具备完整的 bootstrap / decrypt / versions 三大命令能力(命令定义见 cmd/ipadecrypt/main.go),并且由于 credmint 包和 helper 已嵌入,无需任何额外步骤即可进行凭证提取和解密。
⚠️ 一个细节:如果某次构建中 *.ios 文件被剥离成了占位符,CLI 仍可解密应用,但 credmint.Mint 会返回 ErrBinariesUnavailable 错误——此时才需要下面两节的完整重编译流程。
⚙️ 重编译 credmint 包:Docker 工具链实战
credmint 包含 5 个文件,通过 go:embed 嵌入 CLI,仅在执行一次性凭证提取时推送到越狱设备:
credential.ios、driver.ios、trigger.ios—— 签好名的 arm64 iOS 程序static-key-table.bin、core4-word-table.bin—— 数据文件
源码来自上游 fairplay-decrypt 项目的 credential-retrieval/ 目录(未内置在本仓库中)。build.sh 会将其锁定在固定 commit 上克隆,保证可复现。
方式一:使用官方发布的工具链镜像(推荐,脚本自动拉取):
# 自动克隆固定 commit 的 fairplay-decrypt 并构建
./internal/credmint/toolchain/build.sh
方式二:从零构建工具链镜像再打包(镜像由 internal/credmint/toolchain/Dockerfile 定义):
IPADECRYPT_CREDMINT_IMAGE=build ./internal/credmint/toolchain/build.sh
方式三:指向本地已 checkout 的源码:
./internal/credmint/toolchain/build.sh /path/to/fairplay-decrypt/credential-retrieval
构建脚本会依次完成:容器内 clang 交叉编译三个程序 → ldid 按各自 entitlements 签名 → 复制全部 5 个文件到 internal/credmint/bundle/ → 校验无占位符残留。整个过程字节级可复现,CI 中的 "credmint bundle drift" 任务还会重新构建并与仓库内提交的 bundle 做字节比对。
🔧 重编译 on-device 解密 helper
当 helper/ 下的 C 源码发生变化(例如 inject.c、spawn.c 等)时,需要重新编译 helper:
# 默认拉取官方工具链镜像
./helper/build.sh
# 或先用 helper/Dockerfile 在本地构建工具链镜像
IPADECRYPT_TOOLCHAIN_IMAGE=build ./helper/build.sh
helper/build.sh 的核心逻辑是在容器内执行一次 clang 编译,链接 11 个 C 源文件并指定 -target arm64-apple-ios,最后用 ldid -S helper/entitlements.plist 完成 ad-hoc 签名。
这里的 entitlements.plist 很关键,它授予了 helper 运行所需的私有权限:
task_for_pid-allow:附加到目标进程com.apple.private.cs.debugger:跨进程读取线程状态platform-application+no-sandbox/no-container:让 root 能读取已安装的应用包com.apple.springboard.launchapplications:由 SpringBoard 启动目标应用
编译成功后生成 helper/dist/ipadecrypt-helper-arm64,替换嵌入副本并提交:
cp helper/dist/ipadecrypt-helper-arm64 internal/device/ipadecrypt-helper-arm64
✅ 构建验证与常见问题速查
1. 如何确认嵌入的 helper 是最新的?
仓库保证提交的 internal/device/ipadecrypt-helper-arm64 与 helper/ 源码一致,因此 go build 出来的二进制天然完整;若你刚改过 C 代码,务必执行上面的 build.sh + cp 两步。
2. 出现 credential-mint device binaries are not built into this binary 怎么办?
这说明 *.ios 文件是占位符(标记为 IPADECRYPT_CREDMINT_PLACEHOLDER),按上一节的 credmint 流程重编译即可。
3. credmint 镜像和 helper 镜像有什么区别?
两者都基于 Debian + clang 18 + iPhoneOS SDK 26.4,但 credmint 镜像保留了 System/Library/Frameworks,因为设备程序需要链接 CoreFoundation 和 IOKit;helper 镜像则裁剪掉这些目录以节省约 256 MB。
4. 构建产物在哪看?
- CLI:
go build -o ipadecrypt ./cmd/ipadecrypt的输出 - credmint 包:internal/credmint/bundle/ 下的 5 个文件
- helper:
helper/dist/ipadecrypt-helper-arm64(正式位置在 internal/device/)
构建完成后,运行 ipadecrypt bootstrap 完成首次配置(App Store 登录 + 凭证提取),之后 ipadecrypt decrypt <bundle-id> 就能离线解密任意该账户下的应用了。🎉
📖 更多细节请参考官方构建文档:BUILDING.md,credmint 工具链说明见 internal/credmint/toolchain/README.md。