Harbor · 帮助与支持

技术支持

适用版本：Harbor 1.0（build 1）· 最低系统：iOS 26.0 · iPhone 优先

从申请公测、接入媒体库，到空间隔离与缓存清理。这一页按你实际会遇到的顺序组织； 如果这里没有答案，可以直接写信给我们。

一、申请 TestFlight 公测

Harbor 1.0 目前通过 TestFlight 公测分发。申请方式：用你登录 TestFlight 的 Apple ID 邮箱， 给下面这个地址写一封邮件，主题注明「TestFlight 申请」。

testflight@harbor-browser.com

名额与开放时间视测试进度而定；是否收到邀请，以 TestFlight 的实际通知为准。 公测版本可能不稳定，请勿在不可替代的数据上使用。

邮件里请写清：用于 TestFlight 的 Apple ID 邮箱、iPhone 型号与 iOS 版本， 以及你希望重点测试的功能。这些信息能帮助定位问题。

二、接入自建媒体库

媒体坞保存的是网页地址，不是服务器类型。任意 HTTP / HTTPS 地址都可以——局域网 IP、 反向代理域名或公网地址。下面三步完成接入。

第一步：添加地址与账号

在起始页的媒体坞点击添加，填写名称、服务器地址与用户名。密码会保存在 iOS 钥匙串； 服务器地址与用户名保存在本机，并参与 iCloud 同步。使用 HTTP 地址时，保存前应用会提示连接不加密。

第二步：首次登录在网页内完成

点开媒体卡片，Harbor 会在当前空间的浏览器里打开该服务器网页。用网页自己的登录表单登录； Harbor 不会自动填充密码，也不会自动登录。

第三步：之后靠 Cookie 保持会话

登录状态由该空间的 Cookie 维持。清除该空间的 Cookie 或本地存储后，需要重新登录。 清除路径：更多设置 → 存储与缓存，选择对应的空间与清理范围。

边界：媒体坞不提供服务器 API 适配、自动登录、局域网自发现，也没有独立播放器。 播放由网页自身在 WKWebView 内完成。

三、空间与隔离

出厂有几个空间？可以自己加吗？

出厂自带 2 个空间：日常与私密。工作、学习、影视、探索、游戏、保险库是 6 种模板， 可一键套用后改名、换图标与颜色；也可以从空白新建任意数量空间。

空间之间真的隔离吗？

每个空间有独立的 WebKit 数据存储，标签页、历史、书签、网页黑名单与搜索引擎偏好各自独立。 同一个网站可以在不同空间登录不同账号。站点图标缓存与标签页预览缓存不参与账号隔离。

Face ID 门禁如何工作？

任意空间都可以单独开启 Face ID / Touch ID 门禁；生物识别不可用时回退到设备密码。 iPhone 锁屏或 Harbor 切到后台时，应用会从需要门禁的空间回到无需验证的空间。

搜索引擎可以每个空间不同吗？

可以。固定四选一：Google、Bing、DuckDuckGo、Yandex。私密空间默认 DuckDuckGo， 其余空间默认 Google。应用不提供自定义搜索引擎。

iCloud 会同步哪些空间？

同步默认开启。未开启门禁的空间（含日常与自建非私密空间）同步标签页、书签、历史、 媒体账号与快捷方式；私密空间默认不同步，开启需生物识别；网页黑名单与搜索引擎偏好仅保存在本机。 详细去向见隐私政策的数据去向表。

配色和图标能改吗？

可以。界面提供 7 款预设色与系统取色器，16 个 SF Symbols 图标可选，空间名称也能改。

四、页面加载与播放排查

网页打不开

  • 先确认网络连接正常，再尝试打开其他网站，判断是单站点问题还是网络问题。
  • 访问局域网内的自建服务器时，确认 iPhone 与服务器在同一网络，并允许系统弹出的「本地网络」权限。
  • 自签名 HTTPS 证书需要在 iOS 中正确安装并信任，否则网页会被拦截。
  • 如果地址以 HTTP 开头，注意页面内容未加密，部分网页会拒绝加载。

缓存与登录状态怎么清？

网页缓存与 Cookie / 本地存储分开清理：更多设置 → 存储与缓存，可选四个时间窗口。 历史记录不在这里清，请到历史页逐条删除或清空。

媒体播放卡顿

播放由网页自身完成，Harbor 没有独立播放器。卡顿通常来自服务器转码能力、局域网带宽或公网链路。 可以先在同一网络下用 Safari 打开相同地址对比，以判断是服务器侧还是手机侧的问题。

五、系统要求与设备

  • 系统：iOS 26.0 或更高版本，具体以 App Store 兼容列表为准。
  • 设备：为 iPhone 设计；工程同时支持在 iPad 上安装，当前未做 iPad 专项布局。
  • 版本：Harbor 1.0（build 1）。
  • 网络：访问局域网媒体服务器时，需要与服务器处于同一网络，并允许本地网络访问。

六、联系与反馈

遇到闪退、显示异常或想提功能建议，可以直接写信：

邮件由开发团队直接处理。请尽量附上 iOS 版本、Harbor 版本号、出问题的网页地址与截图， 便于复现和定位。我们不对回复时间作时限承诺。

隐私相关说明见隐私政策， 使用条款见用户协议。