要求与注意事项

每个容器一个 Apple ID

每个容器只绑定一个 Apple ID。当前不支持在同一容器内并存多个 Apple ID；若有多账号需求，请使用多个容器隔离。尽量使 Apple ID 的 App Store 商店地区与容器出口 IP 所在地区一致。

Linux 宿主机内存与 Swap

首次 Apple ID 登录可能比小内存 VPS 的常驻占用更高。

若宿主机内存不足 1 GB，建议增加约 2 GB swap：

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
swapon --show && free -h

首次登录在 swap 上可能较慢；Apple 可能要求邮件/短信 2FA，请耐心等待，避免重复点击。

如果你的出口 IP 位于机房等环境，有一定几率会被 Apple 边缘软拒绝，表现为 HTTP 301。详细请见 Apple ID 登录故障排查。

限流

所有 /v1/ HTTP API 按 IP 每分钟 100 次 限流。下载进度 WebSocket 不在 /v1/ 下，不受影响。

数据目录

持久化数据在 /app/data 卷：ipa 文件、users.db、以及 .ipatool 下的 ipatool 配置。