功能介绍

登录 IPA Harbor 管理员账户后，主界面顶部导航包含：搜索、已购 App（需 Apple ID 登录）、下载管理、设置。未绑定 Apple ID 时会提示前往 Apple ID 登录。

管理员入口（首次或异常时）

路径	用途
/setup	新容器首次访问：创建管理员账户
/login	管理员登录（密码 / Passkey）；可点 忘记密码？管理员恢复 进入 /recover
/recover	启用 ADMIN_RECOVERY_ENABLED 后重置管理员密码 —— 忘记管理员密码

详见 管理后台（Setup、Passkey、设置）。

搜索（/）

在首页按 App Store 搜索（地区随设置变化）。进入 App 详情可查看版本、元数据；在设置中开启时可看截图。选择版本后加入下载队列。

已购 App（/purchases）

Apple ID 登录后列出账号已购 App，便于快速定位与下载（须先完成 Apple ID 登录故障排查 中前提条件）。

下载管理（/dl）

展示进行中与已完成任务；运行中任务通过 WebSocket 推送进度。从详情页发起的下载会出现在此。

若使用 OTA 安装，须用 ipatool v2.6.0+ 下载 ipa（原因说明）。

设置（/settings）

管理员选项、Apple ID 状态、OTA 开关、Passkey、LAN HTTPS、版本与更新检测等 —— 见 管理后台 — 系统设置。

Apple ID 登录（/apple-id）

绑定用于 ipatool 的 Apple ID（与管理员登录分离）。说明与故障排查见 Apple ID 登录故障排查。

局域网 CA（/lan-ca）

启用自动证书（LAN HTTPS）时，用于在 iPhone/iPad 上信任自签 CA 的引导页；无需管理员登录即可打开。

添加到主屏幕

在 iPhone 或 iPad 的 Safari 中，可将 IPA Harbor 像 App 一样固定到主屏幕，获得更沉浸的浏览与导航（standalone 模式：独立顶栏/底栏，更接近原生 App）。

入口：打开 设置，找到 添加到主屏幕 卡片，点击 查看说明 —— 与界面内分步引导一致。配置 LAN HTTPS 时，相关区域也提供同一说明入口。

Safari 简要步骤（细节以设置内引导为准）：

1. 在 iPhone 上打开 Safari，访问你的 IPA Harbor 地址。
2. 轻点 共享（标签栏在底部或顶部时，图标可能为「…」或分享按钮）。
3. 在列表中选择 添加到主屏幕；若未出现，可在列表底部 编辑操作 中添加入口。
4. 打开 作为网页 App 打开，然后轻点 添加。

主屏幕会出现 IPA Harbor 图标；点按图标以网页 App 方式打开，退出方式与其他 App 相同。

提示

• 每个容器一个 Apple ID —— 系统要求
• 首次 Apple ID 登录可能较慢 —— 见上文 Apple ID 文档
• 限流：/v1/ API 每 IP 每分钟 100 次