快速上手

以下为本机快速部署，其他部署方式请参阅左侧栏的「部署」。

安装 Docker

安装 Docker 的方式很多：

• Windows 推荐使用 Docker Desktop；macOS 推荐使用 OrbStack
• Debian / Ubuntu 等 Linux 发行版可执行：

apt install -y curl && curl -sSL https://get.docker.com | sudo sh

部署 IPA Harbor

打开终端，选择以下任意一种方式进行部署。

A. 一键脚本部署（推荐）

bash <(curl -fsSL https://raw.githubusercontent.com/ij369/ipa-harbor/main/quick-deploy.sh)

B. 手动部署

docker run -d \
  -p 3388:3080 \
  -e KEYCHAIN_PASSPHRASE=$(openssl rand -base64 15 | tr -dc 'A-Za-z0-9' | head -c10) \
  -e ADMIN_INIT_PIN=20251024 \
  -e PORT=3080 \
  -v ipa_data:/app/data \
  --name ipa-harbor \
  --restart unless-stopped \
  uuphy/ipa-harbor:latest

配置

浏览器打开 http://localhost:3388。

首次访问会自动进入 /setup，创建管理员用户名和密码，并填写初始化 PIN：20251024。

注意 此处使用的是固定 PIN，仅用于快速上手。实际部署时建议将 ADMIN_INIT_PIN 设置为随机值。*该 PIN 仅用于初始化管理员配置，配置完成后将不再使用。**

首次 Apple ID 登录

首次 Apple ID 认证会运行 Unicorn/SAP 模拟。建议宿主机 >1 GB 可用内存，或 配置 ≥2 GB Swap。

下一步

• 要求与注意事项
• Docker 部署
• 部署脚本