ghcr.io/lakr233/assppweb:da580eb

AssppWeb

一款基于Web的工具，用于在App Store之外获取和安装iOS应用。通过Apple ID进行身份验证、搜索应用、获取许可证，并直接将IPA安装到设备。

零信任架构

AssppWeb采用零信任设计，服务器绝不会看到您的Apple凭据。所有Apple API通信均通过WebAssembly（带有Mbed TLS 1.3的libcurl.js）在浏览器中直接进行。服务器仅作为盲TCP中继（Wisp协议），并处理来自公共CDN下载的IPA编译。

[!IMPORTANT] 重要安全提示：Asspp Web没有官方实例。使用任何公共实例均需自行承担风险。虽然后端无法读取您的加密流量，但***主机可能会提供修改后的前端，在加密前捕获您的凭据。因此，请勿盲目信任公共实例。我们强烈建议自行托管实例或使用可信合作伙伴提供的实例。始终验证SSL证书并确保连接到安全、真实的端点。

[!IMPORTANT] 重要安全提示：Asspp Web没有官方实例。使用任何公共实例均需自行承担风险。虽然后端无法读取您的加密流量，但***主机可能会提供修改后的前端，在加密前捕获您的凭据。因此，请勿盲目信任公共实例。我们强烈建议自行托管实例或使用可信合作伙伴提供的实例。始终验证SSL证书并确保连接到安全、真实的端点。

恳请所有转发项目的博主对自己的受众进行网络安全技术科普。要有哪个不拎清的大头儿子搞出事情来都够我们喝一壶的。

快速开始

部署到Cloudflare

使用Cloudflare Workers + Containers和已发布的镜像ghcr.io/lakr233/assppweb:latest。

要求：

• Cloudflare Workers付费计划（免费计划不支持Containers）
• 具有以下权限的部署/构建令牌：
  • Workers Scripts Edit
  • Containers Edit
  • Cloudchamber Edit

如果构建日志在“Deploy a container application”步骤失败并显示“Unauthorized”，则您的构建令牌缺少必要的Containers/Cloudchamber权限。

部署到Railway

1. 访问 railway.com/new/image → 输入 ghcr.io/lakr233/assppweb:latest
2. 在服务设置中，将健康检查路径设置为 /api/settings 并部署
3. 右键点击服务 → 附加卷 → 挂载路径：/data
4. 在变量中，设置 DATA_DIR = /data 并部署
5. 在设置 → 网络中，生成公共域名或添加自定义域名

注意：

• 免费试用版可用但有局限性（卷过期、网络限制）。建议使用Hobby计划（$5/月）或更高版本以确保可靠使用。
• 在服务设置中启用Serverless，可在空闲期间缩容至零
• Railway会自动更新GHCR中的:latest镜像 — 新版本将在几小时内自动部署

[!IMPORTANT] 与Cloudflare配合使用自定义域名：Railway的Cloudflare集成默认创建启用代理（橙色云）的DNS记录。授权后，前往Cloudflare DNS设置，将CNAME记录切换为仅DNS（灰色云）— Railway会自动处理TLS。如果保持Cloudflare代理开启，必须将SSL/TLS模式设置为Full（非Flexible或Full Strict），否则会出现无限重定向循环。详见Railway文档。

[!IMPORTANT] 与Cloudflare配合使用自定义域名：Railway的Cloudflare集成默认创建启用代理（橙色云）的DNS记录。授权后，前往Cloudflare DNS设置，将CNAME记录切换为仅DNS（灰色云）— Railway会自动处理TLS。如果保持Cloudflare代理开启，必须将SSL/TLS模式设置为Full（非Flexible或Full Strict），否则会出现无限重定向循环。详见Railway文档。

使用Docker Compose自行托管

设置Docker Compose

curl -O https://raw.githubusercontent.com/Lakr233/AssppWeb/main/compose.yml
docker compose up -d

环境变量

反向代理（iOS应用安装必需）

iOS要求itms-services://安装链接使用HTTPS。您必须将AssppWeb部署在具有有效TLS证书的反向代理之后。

[!IMPORTANT] 重定向循环（ERR_TOO_MANY_REDIRECTS）？某些反向代理（如NAS内置代理）即使客户端通过HTTPS连接，也始终发送X-Forwarded-Proto: http，导致无限重定向循环。如果无法配置代理发送正确的头信息，作为最后的解决办法，可设置UNSAFE_DANGEROUSLY_DISABLE_HTTPS_REDIRECT=true。这将禁用HTTP→HTTPS重定向 — 您必须确保代理在外部强制使用HTTPS。

以下是Caddyfile配置示例：

asspp.example.com { reverse_proxy 127.0.0.1:8080 }

[!IMPORTANT] 确保WebSocket正常工作

AssppWeb依赖通过WebSocket（/wisp/）实现的Wisp协议来支持其零信任架构。确保您的反向代理或CDN（如Nginx、Cloudflare）已配置为允许WebSocket连接，否则应用将无法与Apple服务器通信。

安全建议

DDoS防护

IPA文件可能有数百兆字节。如果您的实例可公开访问，请将其部署在Cloudflare等CDN之后，以吸收带宽并防止滥用。

许可证

MIT许可证。详见LICENSE。

🥰 致谢

对于被借鉴并大量使用的项目：

• ipatool
• Asspp

对于帮助测试和提供反馈的朋友：

• @lbr77
• @akinazuki