Safe Haven 一直加载不出内容，网络或后端维护怎么排查

症状

打开 Safe Haven 客户端后：

• 首页一直转圈，不加载任何内容
• 分类页一片空白
• 搜索无结果
• 应用详情页加载失败
• 偶尔能打开首页，但点进去某个应用就卡住

根本原因

Safe Haven 的所有联网功能都走 Cloudflare Workers 后端接口：

• 目录拉取 → api.colourswift.com（Cloudflare Workers 边缘节点）
• 搜索 → 同上
• 同步 → 同上
• APK 下载 → S3 存储桶 presigned URL

所以 Safe Haven 没有本地离线功能（没有内置索引）——所有内容都要从网络拉。这意味着：

• 完全断网 = 完全用不了
• Cloudflare Workers 维护 = 完全用不了
• Cloudflare 国内边缘节点不稳定 = 断断续续用不了

排查步骤

第一步：确认是不是 Safe Haven 自己的问题

1. 打开 store.colourswift.com（Safe Haven 的 Web 前端），看能不能加载
2. 如果 Web 前端也加载不出来 → Safe Haven 后端挂了，等一段时间再试
3. 如果 Web 前端正常 → 可能是客户端问题或你手机的网络配置问题

第二步：检查网络

1. 试试其他需要联网的 App（微信、浏览器等）能不能正常工作
2. 如果都不行 → 你的手机网络有问题，和 Safe Haven 无关
3. 如果只有 Safe Haven 不行 → 继续第三步

第三步：切换网络

Safe Haven 的后端节点在 Cloudflare，国内访问因运营商而异：

• 电信 → 通常最稳
• 移动 / 联通 → 偶尔抽风，特别是晚上高峰
• 海外网络 → 应该稳定

试试：

• 移动 → 电信 / 联通
• 运营商数据 → Wi-Fi
• Wi-Fi → 手机数据

第四步：用 VPN

如果以上都不行：

1. 用 VPN 连上（选稳定的节点）
2. 再打开 Safe Haven
3. 如果 VPN 下能正常加载 → 你的网络被 Cloudflare 边缘节点临时屏蔽或不稳定

Cloudflare 在国内没有自建节点，所有流量都走海外边缘节点，稳定性取决于当时的全球网络状况。

第五步：等

Safe Haven 目前是 ColourSwift 团队维护的早期项目，后端只有一台 Linux VPS（扫描器三服务）+ Cloudflare Workers + S3 存储桶。维护窗口和故障响应能力有限。Cloudflare Workers 偶尔的小维护或 VPS 重启可能导致几小时内服务不可用。

等几个小时再试，通常自动恢复。

客户端报错信息

v2.0.9+ 的客户端在设置页有调试日志开关。打开后：

• Network 类错误会记录具体的 HTTP 状态码
• SocketException 会记录连接超时
• Workers 返回 5xx = 后端问题
• Workers 返回 403/401 = 鉴权问题（罕见，通常是客户端版本过期）

如果你想帮 Safe Haven 排查问题，可以把调试日志打包后提交到 GitHub Issues。

为什么不做离线功能

Safe Haven 选择不内置离线索引（不像 F-Droid 客户端有本地 index-v1.json 缓存），原因：

1. 早期项目，索引文件不大（压缩后几 MB），BITS 七滚动窗口已经很高效
2. 保持简单——客户端只做渲染，索引全在服务端维护
3. 本地索引过期后还需要联网重新同步，不如一开始就只走联网

代价是完全断网或服务端挂掉时 Safe Haven 就用不了。如果这个痛点影响很大，可以去 GitHub Issues 提一个"缓存离线索引"的 feature request。