ipa 安装

IPA Harbor 侧重搜索与下载。安装方式请按设备选择。

推荐方式

• 较新 iOS/iPadOS：AirDrop 到设备。
• 较老设备：Mac 上 Apple Configurator，或 Windows 上 iTunes 12.6.3（ipsw.me/iTunes）。

本指南不推荐依赖第三方侧载商店。

Safari OTA 安装（可选）

满足条件时，IPA Harbor 可在 Safari 中显示 安装：

要求	说明
设备	iPhone、iPad 或 Apple 芯片 Mac
浏览器	设备上的 Safari
HTTPS	必须；纯 HTTP 不显示按钮
设置	设置 → 启用 OTA 安装（非 Apple 客户端默认关闭）
ipatool	下载须 v2.6.0+ 且 OTA 兼容

部署方式：

• 内置 TLS：-p 443:3443、HTTPS_PORT=3443、证书在 /app/certs
• 或通过 nginx 等反代提供 HTTPS

若仅在桌面下载 ipa 文件，普通 HTTP Docker 部署即可。

ipatool v2.6.0+

Safari OTA 通过 itms-services 触发安装时，系统会在线拉取并解压 ipa。旧版 ipatool 下载的部分包，其压缩方式与 iOS OTA 解压路径不兼容，会出现安装失败或无法完成，与 HTTPS、manifest 配置无关。

最新版 uuphy/ipa-harbor Docker 镜像通常支持 OTA 安装，但并非所有 tag 都基于原版 ipatool 构建；早期镜像曾通过补丁 scripts/legacy/ipatool-haughtyeyes-ota-compat.patch 构建 ipatool，目前已全部改为使用最新版官方 ipatool 构建。