uuphy/sim-gallery

IPA-Harbor

https://github.com/ij369/ipa-harbor%E6%98%AF%E4%B8%80%E4%B8%AA%E5%9F%BA%E4%BA%8E ipatool 的开源 IPA 可视化 Web 管理工具 , 支持 App 搜索、历史版本下载与 Docker 容器化部署。

快速开始

本机快速启动命(local)

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

然后打开浏览器访问： http://localhost:3388

首次登录会进入配置管理员密码，用于后续进入面板。

参数说明

-p 3388:3080：将容器的 3080 端口映射到本地 3388 端口。

-e KEYCHAIN_PASSPHRASE：随机生成密钥，保证 Keychain 安全, 因为 Keychain 内存着 Apple ID 的访问权。

-e PORT 指定http端口，必须

-e HTTPS_PORT 指定https端口，非必须

-e ALLOWED_DOMAINS 指定允许的域名，如果使用了network参数，并配置了nginx proxy，建议还同时指定内部的 host 名，避免无法域名访问，域名访问还可以参考GitHub仓库的server/docker-compose.example.yml。

-v ipa_data:/app/data：持久化数据（IPA 文件、数据库等）。

-v ipa_certs:/app/certs：持久化证书。

--name ipa-harbor：容器名称。

如果你部署在公网一定要有ALLOWED_DOMAINS, 实现前端访问白名单，仅在浏览器层面禁止:

-e ALLOWED_DOMAINS=your-domain.com,another-domain.com \

注意

建议单容器，登录单个Apple ID，因为单个容器有独立的 MAC 地址，ID 最好使用和容器宿主机 IP 相同的地区。

目录结构

server/
├── api/
├── app.js
├── bin/
├── certs/
├── config/
├── data/
├── Dockerfile
├── ipatool/
├── middleware/
├── nodemon.json
├── package-lock.json
├── package.json
├── static/
└── utils/

The open-source release was done rather quickly; i18n translations will be added in future commits.

Acknowledgements

This project is based on the work of the following project: https://github.com/majd/ipatool/