ipatool 使用指南：3 步在 Windows、macOS、Linux 上下载 IPA-育师

ipatool 使用指南：3 步在 Windows、macOS、Linux 上下载 IPA

【免费下载链接】ipatoolCommand-line tool that allows you to search for iOS, iPadOS, tvOS, visionOS, and macOS apps on the App Store, and download .ipa or macOS .pkg app packages.项目地址: https://gitcode.com/GitHub_Trending/ip/ipatool

从 App Store 手动拿到 IPA 一直没太好的路子：模拟器方案麻烦，抓包脚本不稳定，越狱也不是人人愿意做的选择。ipatool 是一个跨平台的命令行工具，把 IPA 下载这件事收敛成四步：搜索、查版本、登录、下载，iOS 应用管理从此可以在 Windows、macOS、Linux 上以同样的方式完成，全程无需越狱。

🧰 ipatool 能做什么，边界在哪

这一节先把话说清楚：ipatool 替你干到哪一步、哪些事不归它管，避免装上之后有落差。

它的能力大致是这五条：

应用搜索：覆盖 iOS、iPadOS、tvOS、visionOS、macOS 五个平台的 App Store 目录；
版本历史：列出某个应用当前可下载的全部版本，包括已经下架的老版本；
下载 IPA 或 macOS .pkg：默认拿最新版，也可以指定任意历史版本；
授权管理：付费应用需要许可证，ipatool 可以直接向 App Store 申请；
账户认证：用系统钥匙串安全保存 Apple ID 凭证，支持 2FA 验证码。

它只做取包和认证这一层。装包到设备、重签名、越狱环境操作，都不在它的范围内。

⚡ 三步上手：从装好到拿到第一个 IPA

这一节解决从零到跑通第一条命令的问题，照顺序做就行。

前提条件

只需要三样东西：

受支持的操作系统：Windows、Linux 或 macOS；
一个可以正常使用 App Store 的 Apple ID；
能访问 App Store 服务的网络。

三种安装方式，挑一种

macOS 用户最省事，一行命令装好：

brew install ipatool

Windows 和 Linux 用户去项目发布页（releases）下载对应平台的压缩包，解压后把二进制放进 PATH 即可。习惯源码的也可以自己编译：

git clone https://gitcode.com/GitHub_Trending/ip/ipatool.git cd ipatool go build -o ipatool

装完之后，各平台还有一步小配置。macOS 什么都不用做。Windows 上如遇脚本权限提示，执行一次Set-ExecutionPolicy RemoteSigned -Scope CurrentUser即可。Linux 上密钥存储依赖 libsecret 库，Ubuntu/Debian 执行sudo apt-get install libsecret-1-dev，Fedora/CentOS 执行sudo dnf install libsecret-devel。

首次登录

拿到第一个 IPA 前必须先登录 App Store：

ipatool auth login

按提示输入 Apple ID 和密码；开了双因素认证的账户，再补一次验证码即可。登录成功后凭证加密存入系统钥匙串，后续所有命令自动复用，不必反复输密码。

🎯 三个高频任务：搜索、查版本、下载

这一节演示最常见的三个操作，每个都是“最短命令 + 一句参数说明”。

搜索应用

想找某个应用的 App Store ID 或 Bundle ID 时：

ipatool search "微信" --limit 5

--limit控制返回条数，默认 5 条。加--platform iphone可以把范围限定到某个平台。

查看版本历史

下载前一般要先知道有哪些版本可选：

ipatool list-versions -b com.tencent.xin

-b传 Bundle ID，也可以用-i传 App Store 数字 ID。返回的 external version id 就是下载老版本时的“版本号”。

下载 IPA

拿到 ID 后，下载最新版：

ipatool download -b com.tencent.xin -o wechat.ipa

想指定历史版本就再加--external-version-id（值来自上一步的列表）；付费应用补上--purchase，工具会自动先申请许可证再下载。-o后面就是输出文件路径。

进阶：把 ipatool 接进工作流

这一节演示如何把单条命令变成批量能力，只点到为止。

本地批量下载，写一个循环脚本即可：

for app in com.tencent.xin com.zhihu.ios com.netease.news; do ipatool download -b "$app" -o "downloads/$app.ipa" --purchase sleep 5 done

sleep 5用来错开请求，降低触发限流的概率。同样的思路可以搬进 GitHub Actions、Jenkins 等 CI 系统，只需注意两点：自动化环境统一加--non-interactive跑非交互模式；凭证不能明文写进流水线，Apple ID 密码应放在平台的 Secrets 里，2FA 验证码则通过--auth-code参数传入。

遇到问题先看这里

这一节把最常碰到的三类问题按“现象 → 原因 → 解法”列清楚，先自查再找人。

现象：登录时提示需要 2FA 验证码，但脚本里没人可以手动输入。原因：账户开启了双因素认证，非交互环境不会提示输入。解法：重新执行登录命令并带上验证码：

ipatool auth login --email 你@例子.com --auth-code 123456

现象：之前能登录，现在报认证失败。原因：本地钥匙串里的凭据过期或损坏，App Store 拒绝复用。解法：清掉旧凭据再重新登录，两条命令：ipatool auth revoke，然后ipatool auth login。

现象：下载明显偏慢。原因：下载速度受账户所属地区、App Store 分片和自身网络共同影响。解法：先跑ipatool auth info确认账户实际所属地区，再换个网络或时段重试；仍不行就加--verbose看日志定位具体卡在哪一段。

命令速查表

任务	命令	关键参数	备注
登录 App Store	`ipatool auth login`	`-e`、`-p`、`--auth-code`	凭证存入系统钥匙串
查看当前账户	`ipatool auth info`	—	可确认所属地区
撤销认证	`ipatool auth revoke`	—	排障时的第一手段
搜索应用	`ipatool search <关键词>`	`-l`、`--platform`	默认返回 5 条
列出可下载版本	`ipatool list-versions`	`-b`或`-i`	含已下架版本
下载 IPA / pkg	`ipatool download`	`-b`、`-i`、`-o`、`--external-version-id`	默认最新版
单独获取授权	`ipatool purchase`	`-b`、`--platform`	付费应用适用
查询版本详情	`ipatool get-version-metadata`	`-b`、`--external-version-id`	解析具体版本元数据