uuphy/ipa-harbor repository overview

⁠IPA Harbor

Open-source IPA web management tool based on ipatool⁠. Search apps, download previous versions, and install IPAs from your browser.

⁠Quick Start (local)

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 \
  uuphy/ipa-harbor:latest

Open http://localhost:3388⁠ — you will be redirected to /setup automatically on first visit. Enter init PIN 20251024, then set the administrator username and password.

⁠Public deployment (HTTPS)

docker run -d \
  -p 80:3080 \
  -p 443:3443 \
  -e KEYCHAIN_PASSPHRASE=$(openssl rand -base64 15 | tr -dc 'A-Za-z0-9' | head -c10) \
  -e ADMIN_INIT_PIN=$(openssl rand -base64 24 | tr -dc '0-9' | head -c8) \
  -e PORT=3080 \
  -e HTTPS_PORT=3443 \
  -e ALLOW_LAN_ACCESS=false \
  -e ALLOWED_DOMAINS=example.com \
  -v ipa_data:/app/data \
  -v ipa_certs:/app/certs \
  --name ipa-harbor \
  uuphy/ipa-harbor:latest

Mount server.crt and server.key in /app/certs. Save the generated ADMIN_INIT_PIN for /setup. Use a random PIN in production — do not reuse 20251024.

nginx / Cloudflare reverse proxy, optional Passkey admin login, and other options: see the GitHub README⁠.

⁠Notes

Official image: uuphy/ipa-harbor⁠ — built from the IPA-Harbor repository⁠. Self-hosted only. Do not enter Apple ID credentials on untrusted instances.

Tags: Release tags follow x.y.z (e.g. 0.1.10). latest points to the most recent x.y.z release. Temporary dev tags such as x.y.z-dev or x.y.z-dev1 track the next in-progress version and may be deleted at any time — avoid them unless you intentionally follow development builds.

• One Apple ID per container; match account region to egress IP when possible.

If you use a x.y.z-dev tag and run into issues, stop the container, delete the ipa_data volume, and redeploy a stable x.y.z or latest tag.

Full docs: https://github.com/ij369/ipa-harbor⁠

⁠IPA-Harbor

基于 ipatool⁠ 的开源 IPA Web 管理工具。通过浏览器搜索 App、下载历史版本并安装 IPA。

⁠快速开始（本机）

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 \
  uuphy/ipa-harbor:latest

打开 http://localhost:3388⁠ — 首次访问会自动定向到 /setup。输入初始化 PIN为 20251024，然后设置管理员用户名和密码即可。

⁠公网部署（HTTPS）

docker run -d \
  -p 80:3080 \
  -p 443:3443 \
  -e KEYCHAIN_PASSPHRASE=$(openssl rand -base64 15 | tr -dc 'A-Za-z0-9' | head -c10) \
  -e ADMIN_INIT_PIN=$(openssl rand -base64 24 | tr -dc '0-9' | head -c8) \
  -e PORT=3080 \
  -e HTTPS_PORT=3443 \
  -e ALLOW_LAN_ACCESS=false \
  -e ALLOWED_DOMAINS=example.com \
  -v ipa_data:/app/data \
  -v ipa_certs:/app/certs \
  --name ipa-harbor \
  uuphy/ipa-harbor:latest

在 /app/certs 挂载 server.crt 与 server.key。请妥善保存命令中生成的 ADMIN_INIT_PIN 供 /setup 使用。生产环境请使用随机 PIN，不要复用 20251024。

nginx / Cloudflare 反向代理、Passkey 管理员登录（可选）等配置，见 GitHub README⁠。

⁠说明

官方镜像： uuphy/ipa-harbor⁠ — 由 IPA-Harbor 仓库⁠ 源码构建并发布。本项目仅供自托管使用。请勿在不受信任或来源不明的实例上输入 Apple ID 凭据。

标签规则： 正式版本使用 x.y.z（例如 0.1.10）。latest 指向最新的 x.y.z 版本。x.y.z-dev 或 x.y.z-dev1 等为下一版本的临时开发标签，可能随时删除 — 除非需要跟进开发进度，否则请勿使用。

• 建议每个容器仅登录一个 Apple ID，并尽量保持 Apple ID 所在地区与容器出口 IP 所在地区一致。

若使用 x.y.z-dev 标签遇到问题，请停止容器、删除 ipa_data 卷，再改用稳定的 x.y.z 或 latest 标签重新部署。

完整文档： https://github.com/ij369/ipa-harbor⁠