Asspp下载使用教程:iPhone多账号切换App Store、跨区下载应用神器
很多果粉都有这样的烦恼:想下载美区的 ChatGPT、日区的游戏,或者某个 App 更新后变难用了想退回旧版——但每次都要退出 Apple ID、重新登录、换区,操作繁琐又容易出问题。
Asspp 就是为了解决这个痛点而生的工具。简单来说,它能让你同时管理多个 Apple ID,在不同国家的 App Store 之间一键切换,下载任何区域的应用,而且完全不用退出你手机上的系统账号。
💡 使用 Asspp 下载外区应用时,你可能需要科学上网环境才能正常连接 Apple 服务器。 如果你还没有稳定的翻墙工具,可以先看看这篇 👉 2026年好用的翻墙机场推荐,找一个适合自己的线路。
Asspp 能做什么?

在开始安装之前,先了解一下 Asspp 到底有哪些实用功能:
| 功能 | 说明 | 适合谁 |
|---|---|---|
| 🌍 一键切换 App Store 区域 | 美区、日区、港区、国区……随意浏览,不用换区 | 想下载外区独占 App 的用户 |
| 👥 多 Apple ID 管理 | 添加多个账号,自动匹配对应区域下载 | 有多个 Apple ID 的用户 |
| 📦 下载 IPA 安装包 | 从苹果服务器直接下载正版 IPA 文件 | 需要备份 App 或用巨魔安装的用户 |
| ⏪ 下载 App 旧版本 | 查看并下载某个 App 的历史版本 | App 更新后变卡/变难用,想退回旧版 |
| 📱 支持 iOS + macOS | 两个平台都能用,体验流畅 | 苹果全家桶用户 |
Asspp 安装教程
方法一:iOS 手动安装(推荐新手)
这是最简单直接的方式,不需要折腾 GitHub:
- 下载 IPA 文件:打开 Asspp Releases 页面,找到最新版本,下载
.ipa文件 - 选择签名工具安装:
- TrollStore(巨魔)用户:直接用巨魔安装,最省心
- AltStore 用户:通过 AltStore 侧载安装
- SideStore 用户:WiFi 无线安装,不需要连电脑
- 打开 Asspp,登录你的 Apple ID 即可开始使用
如果你不知道什么是巨魔/AltStore,简单理解就是:它们是 iPhone 上安装第三方 App 的工具,类似安卓的 APK 安装。
方法二:iOS 自动构建(适合有开发者账号的用户)
如果你有 Apple 开发者证书,可以通过 GitHub Actions 实现自动构建和推送更新:
- 在 GitHub 上 Fork Asspp 仓库
- 配置 GitHub Actions,填入你的开发者证书信息
- 构建完成后会生成一个 OTA 安装链接,以后直接在手机浏览器打开就能安装/更新
详细配置指南(点击展开)
GitHub Actions 自动构建与签名指南
本指南介绍如何设置你自己 Fork 的 Asspp 仓库,通过 GitHub Actions 自动构建、签名并发布应用。
这样做的好处:
- 始终保持最新版本:工作流会自动拉取上游仓库的更新。
- OTA 安装:通过网页链接直接在 iPhone 上安装应用,无需电脑。
- 自动签名:使用你自己的 Apple 开发者证书完成签名。
1. 前置条件
- Apple 开发者账号:需要付费账号才能创建所需的证书和描述文件。
- 签名资源:
- 分发证书:从钥匙串访问(Keychain Access)导出的
.p12文件(需设置密码)。 - 描述文件:包含你设备 UDID 的 Ad Hoc
.mobileprovision文件。 - GitHub 账号:用于 Fork 仓库和运行 Actions。
2. Fork 并配置仓库
- 将 Asspp 仓库 Fork 到你的账号下。
- 进入 Settings -> Actions -> General。
- 在 "Workflow permissions" 下,选择 Read and write permissions(读写权限)。
- 点击 Save 保存。
- 进入 Settings -> Pages。
- 在 "Build and deployment" 下,将 Source 设为 GitHub Actions。
3. 配置 Secrets 和 Variables
你需要将签名密钥提供给 GitHub,这样它才能帮你签名应用。
方式 A:自动配置(推荐)
我们提供了一个脚本来自动生成所需的值。
打开终端,进入项目目录。
运行辅助脚本:
./Resources/Scripts/generate.github.action.inputs.sh \ --p12 /path/to/your/certificate.p12 \ --p12-password 'your-p12-password' \ --mobileprovision /path/to/your/profile.mobileprovision脚本会输出一组 Secrets 和 Variables 的值。你可以:
- 手动复制粘贴到 GitHub Settings 中。
- 或者使用生成的
apply-with-gh.sh脚本(需要安装ghCLI 工具)自动应用。
方式 B:手动配置
进入 Settings -> Secrets and variables -> Actions。
Secrets(新建仓库密钥)
| 名称 | 值 | 说明 |
|---|---|---|
IOS_CERT_P12_BASE64 | [Base64 字符串] | 你的 .p12 证书文件转换为 Base64 后的内容。 |
IOS_CERT_PASSWORD | [字符串] | 你的 .p12 文件的密码。 |
IOS_PROVISIONING_PROFILE_BASE64 | [Base64 字符串] | 你的 .mobileprovision 描述文件转换为 Base64 后的内容。 |
在 macOS 上获取 Base64: base64 -i certificate.p12 | pbcopy
Variables(新建仓库变量)
| 名称 | 值 | 说明 |
|---|---|---|
IOS_BUNDLE_ID | wiki.qaq.Asspp | 重要:必须与你的描述文件(Provisioning Profile)中的 App ID 一致。 |
IOS_EXPORT_METHOD | ad-hoc | 通常填 ad-hoc。 |
IOS_OTA_BASE_URL | (可选) | 如果你为 GitHub Pages 使用了自定义域名,在此填入(如 https://apps.example.com)。否则留空。 |
4. 触发构建
- 进入你 Fork 仓库的 Actions 标签页。
- 在左侧选择 Upstream Signed iOS Build 工作流。
- 点击 Run workflow。
- 输入项保持默认即可。
- 等待构建完成(通常需要 5-10 分钟)。
5. 安装应用
构建完成后:
- 进入你仓库的 Releases 页面,应该能看到一个新的发布版本。
- 在 iPhone 上用 Safari 打开 安装页面:
- 链接格式:
https://<你的用户名>.github.io/<仓库名>/ios/latest/install.html
- 链接格式:
- 点击 Install(安装)。
常见问题排查
- 提示"无法验证 App":前往 iOS 设置 -> 通用 -> VPN 与设备管理,信任你的证书。
- 安装一直等待中:确认你的设备 UDID 已包含在上传的描述文件中。
- 构建失败:查看 Actions 日志。常见错误包括 Bundle ID 不匹配或证书过期。
方法三:macOS 安装
Mac 端安装非常简单:
- 前往 Releases 页面 下载最新的
.zip文件 - 解压后,将
Asspp.app拖到「应用程序」文件夹 - 首次打开时,macOS 可能会弹出安全提示,按以下步骤处理:
如果提示"无法打开":
- 在 Finder 中找到
Asspp.app→ 右键点击 → 选择「打开」→ 在弹窗中再点一次「打开」 - 这样操作一次后,以后就能正常双击打开了
如果右键打开也不行:
- 打开「系统设置」→「隐私与安全」
- 滚动到底部,找到被阻止的 Asspp,点击「仍要打开」
- 输入你的 Mac 开机密码确认
这是 macOS 的正常安全机制(Gatekeeper),不是 Asspp 有问题,所有非 App Store 下载的应用都会遇到。
系统要求
- iPhone/iPad:需要 iOS 17.0 或更高版本
- Mac:需要 macOS 15.0 或更高版本
- Apple ID:至少需要一个 Apple ID 来登录(建议用备用号,原因见下文)
使用 Asspp 的注意事项
重要安全提醒
请一定使用备用 Apple ID 登录 Asspp,不要使用你的主力账号!
原因很简单:Asspp 使用的底层协议(和 ipatool 相同)并非苹果官方公开支持的方式。虽然目前还没出现过账号被封的极端案例,但理论上苹果有权对此类行为做出限制。如果你的主力 Apple ID 被封,可能会导致 iPhone 被激活锁锁定,后果非常严重。
另外,你的设备 GUID 类似于密码,千万不要泄露给别人。
关于协议稳定性
Asspp 底层使用的通信协议曾经历过几次失效,可能的原因包括:
- 太多人滥用,触发苹果风控
- 苹果修改了接口或协议
- 苹果加强了网关安全策略
如果将来协议再次失效,Asspp 可能无法修复。所以趁现在能用,赶紧把需要的 App 和 IPA 下载好。
没有外区 Apple ID?教你注册一个
要使用 Asspp 跨区下载应用,你至少需要一个外区 Apple ID。如果你还没有,可以参考我们的教程:👉 免费外区Apple ID获取方法
搭配科学上网效果更佳
Asspp 连接 Apple 服务器下载外区应用时,有时需要对应地区的网络环境。搭配一个稳定的翻墙工具,可以让下载更顺畅、连接更稳定。
如果你还没有合适的科学上网工具,推荐阅读:
- 👉 2026年便宜好用的翻墙机场推荐 — 精选高性价比机场,低至2元/月
- 👉 iPhone 翻墙教程(Shadowrocket) — 小火箭配合 Asspp 使用效果最佳
- 👉 电脑翻墙教程 — Mac 上使用 Asspp 时的翻墙方案
常见问题
Asspp 登录时报错怎么办?
检查你的网络环境,确保能正常连接 Apple 服务器。如果在国内直连不行,请开启 科学上网工具 后再试。
Asspp 和直接换区有什么区别?
直接在系统设置里换区需要退出当前 Apple ID,可能导致 iCloud 数据同步问题。Asspp 完全独立运行,不影响你手机上的任何设置和数据。
下载的 IPA 文件有什么用?
IPA 是 iOS 应用的安装包。你可以用它来:备份喜欢的 App、通过巨魔安装到其他设备、保存旧版本以备不时之需。
免费吗?
Asspp 是开源免费的工具,代码托管在 GitHub 上,任何人都可以查看源码。
免责声明
本文仅供学习和研究参考,Asspp 是第三方开源项目,与 Apple Inc. 无关。使用本软件产生的任何后果由用户自行承担。请遵守当地法律法规。