功能定位：为什么需要手动刷新订阅
在快连（QuickLink）的 iOS 客户端里，“订阅”=一份加密节点清单，由官方或第三方托管的 URL 定期更新。当后台静默拉取失败——比如切到飞行模式后恢复、企业网络劫持证书、或节点突遭高负载——列表就会停留在旧版本，直观表现是“全部节点延迟 999 ms”或“提示无可用中继”。此时手动刷新订阅，可强制客户端重新下载并校验最新节点，是排除“假掉线”的第一步。
与“智能选路”或“AI 分流”不同，刷新订阅只解决列表本身是否过期，并不改变连接协议。理解这一点，可避免盲目反复刷新：若节点已下架，再怎么刷新也不会回来；若订阅 URL 被运营商 DNS 污染，刷新同样会失败。
最短路径：iOS 端三步手动刷新
以截至当前的最新版本为例，界面文案可能随小版本微调，但入口逻辑不变：
- 打开快连 → 底部导航“节点”页 → 右上角“⚙️”进入订阅管理。
- 在列表顶部找到“官方订阅”（或你自建的第三方订阅），左滑出现“刷新”按钮；若使用 TestFlight 内测版，按钮文案为Refresh。
- 点击后，客户端会弹出进度浮层：“正在同步…0/120”。待计数跑满且出现“✅ 已更新”提示，即完成。
经验性观察：全程在 200 节点规模下，蜂窝网络通常 <10 s；若超过 30 s 仍卡在 0/120，可判定订阅源被拦截，需进入下一步例外处理。
失败分支与回退
若浮层报错“下载失败，请检查网络”，优先尝试：
- 切到系统设置 → 蜂窝网络 → 找到“快连” → 关闭再打开无线局域网助理；
- 返回订阅管理页，长按“官方订阅”→ 选“复制 URL”，用 Safari 直接访问，看能否下载明文列表；
- Safari 同样打不开，说明 URL 被 DNS 污染，可临时把系统 DNS 改为 8.8.8.8 再刷新。
注意：iOS 不允许第三方描述文件以外的方式修改全局 DNS，若公司 MDM 锁定，只能切到 4G/5G 再试。
平台差异：iOS vs Android vs 桌面端
| 平台 | 入口差异 | 失败提示 | 特有回退方案 |
|---|---|---|---|
| iOS | 节点页 ⚙️→订阅管理→左滑刷新 | “下载失败，请检查网络” | 切 4G/改 DNS/重启网络扩展 |
| Android | 侧滑菜单→订阅→长按刷新 | “订阅地址不可达” | 允许 privacy tool 后台弹窗/关闭省电 |
| Windows | 主界面→订阅→右键立即更新 | “TLS 握手超时” | 手动导入本地 YAML 文件 |
可见，iOS 因系统沙箱限制，失败时可选手段最少；提前把订阅 URL 备份到备忘录，可在极端场景下手动导入。
例外与副作用：什么时候不该刷新
1. 节点已下架但本地仍缓存：刷新后列表变短，反而“看起来更少”。此时应确认官方公告，而非反复刷新。
2. 处于企业 Wi-Fi 且证书被替换：刷新会触发 HTTPS 校验失败，连续重试可能导致账号被临时限速。
3. 低电量模式＋弱网：iOS 会抑制后台网络扩展，刷新过程极慢，易误判为失败；建议先充电再操作。
提示：若你使用的是第三方订阅，刷新频次过高（>每 15 min）可能被托管仓库限流，返回 429 状态码。官方订阅暂无此限制。
验证与观测：怎么确认刷新成功
完成刷新后，按以下顺序验证，可避免“假成功”：
- 回到节点页，下拉一次，观察顶部时间戳是否变为最近 5 min 内。
- 任意点击一个“香港 05”节点，查看详情页的“订阅来源”字段，应显示Official-2026-04-13（日期随当天变化）。
- 返回首页点击“一键加速”，若延迟从 999 ms 降到 <200 ms，说明列表已生效。
若时间戳未更新，但进度浮层提示成功，工作假设：本地缓存未写入。此时可强制停止 App（上滑清掉后台）再重进，缓存会重新加载。
故障排查：按现象→原因→处置速查
现象 1：刷新按钮灰色不可点
原因：iOS 网络扩展未启动或系统 privacy tool 配置被其他描述文件占用。
处置：系统设置 → 通用 → privacy tool 与设备管理 → 移除过期描述文件，返回快连重新授权。
现象 2：进度卡在 50/120 后失败
原因：订阅源中途被重置连接，常见于公司网关对长连接限 60 s。
处置：切到 4G，或在凌晨低峰再刷新；若仍失败，把 URL 复制到 Safari 看是否完整下载，确认源本身正常。
现象 3：刷新成功但节点全红
原因：本地时间错误导致 TLS 证书校验失败。
处置：系统设置 → 通用 → 日期与时间 → 打开自动设置，再回快连重新连接。
适用/不适用场景清单
| 场景 | 是否建议手动刷新 | 备注 |
|---|---|---|
| 出国旅游，机场 Wi-Fi 连不上 | ✅ 建议 | 机场 captive portal 可能劫持 DNS，刷新可换新 IP 段 |
| 公司内网限制白名单 | ❌ 不建议 | 刷新会触发黑名单，导致整个域名被封 |
| 晚高峰游戏延迟高 | △ 先测速再决定 | 若旧列表延迟已 >300 ms，刷新可能拿到低负载新中继 |
| 第三方订阅日更 4 次 | ⚠️ 控制频次 | 每 15 min 刷新一次易被托管仓库限流 |
最佳实践：可落地的 4 条规则
- 刷新前先测旧节点：若延迟 <150 ms，无需刷新，避免“越刷越少”。
- 失败两次就换网：公司 Wi-Fi 与 4G 各试一次，仍失败则非网络问题，考虑订阅源失效。
- 记录时间戳：截图节点页顶部“更新于”时间，方便客服排查。
- 低电量不刷新：iOS 会降频网络扩展，极易超时；先充电到 20% 以上再操作。
FAQ：必须使用 FAQ Schema
快连 iOS 端多久自动刷新一次订阅？
官方订阅默认每 6 小时静默拉取一次；若期间网络中断，会等下次后台唤醒再试，不会无限重试。
手动刷新会消耗流量吗？
完整列表约 200 KB，200 节点规模下不到 0.3 MB，可忽略；但建议不在国际漫游时频繁操作。
刷新后节点反而变少，是 Bug 吗？
不是。官方会下线高丢包服务器，导致列表缩短；可在官网公告查看当日下线记录。
TestFlight 版与 App Store 版刷新逻辑一样吗？
核心逻辑一致，但 TestFlight 版支持 HTTP/3 拉取，极端网络下成功率更高；正式版后续会同步。
刷新订阅会影响已连接的游戏吗？
不会。刷新只更新本地列表，不会强制重连；当前隧道会保持到手动切换节点或断开为止。
收尾：核心结论与下一步行动
快连 iOS 端手动刷新订阅的核心价值，是在“静默同步失败”时给你一次低成本自救的机会：三步操作、10 秒完成、流量忽略不计。牢记“先测旧节点→再刷新→两次失败换网络”的口诀，可规避 90% 的无效尝试。
下一次遇到“全部节点 999 ms”时，别急着卸载或吐槽，先走完本文的验证清单；若仍异常，把时间戳截图+失败提示一并提交给官方工单，可显著缩短客服排查时间。保持客户端为截至当前的最新版本，并关注季度透明度报告，你就能在最低成本下维持节点列表常新。
