快连节点列表为空时如何手动重新获取？

功能定位与版本脉络

“快连节点列表为空”并不是单纯的服务器故障，而是客户端本地缓存、网络可达性、账号授权三要素同时失配的集中表现。自 2025 年 v6.5 起，快连把「节点发现」拆成两条链路：①启动时一次性拉取全量列表（约 80 kB）并落盘缓存；②连接前再对候选节点做 200 ms 级 QoS 探活。好处是冷启动更快，代价是一旦首次拉取失败，后续就呈现“空白列表”且不会自动重试。v7.0.9 加入的 AI 智能节点虽然能在后台悄悄换线，但仍依赖这份本地底表，所以底表丢失时一样会“巧妇难为”。理解这一机制后，手动重获取的核心目标就清晰：强制重新走完“拉取→校验→落盘”完整流程，同时清除可能冲突的旧缓存。

前置检查：先确认是本地问题还是服务端问题

动手之前，用 30 秒排除“大面积宕机”：

1. 打开官方 Telegram 频道「KuailinkStatus」，若 5 分钟内无“节点维护”公告，可认为服务端正常。
2. 同一网络下，用浏览器访问https://api.kuailink.com/v1/echo，返回{"code":0}表示 HTTP 层可达。
3. 若只有公司内网失效，而 4G 正常，则基本可判定为本地缓存或 DNS 污染，继续按本文步骤即可。

手动重获取的三条官方通道

通道 A：下拉刷新（移动端最快捷）

Android / iOS 通用路径：首页节点列表页 → 指尖按住空白处向下滑动 → 出现“松手刷新”提示 → 松开。此时客户端会忽略本地缓存，直接发起/v1/nodes/full请求并重新渲染。经验性观察：在 Wi-Fi 延迟 20 ms 环境下，整个往返约 1.5 秒；若 3 秒后仍无结果，99% 是网络被重置，建议切 4G 再试一次。

通道 B：协议切换触发强制重拉（桌面端更稳）

Windows / macOS 路径：右上角「≡」→ 设置 → 协议 → 原为 WireGuard 者切到 Hysteria2 → 点“保存”。客户端会弹窗提示“协议变更需重新获取节点”，确认后即可后台拉取。原理是不同协议的节点池彼此隔离，切协议等于让缓存失效。若列表瞬间出现，再切回原先协议即可，无需真的更换协议上网。

通道 C：一键清理缓存（兜底方案）

当刷新、切协议都无效，说明缓存文件已损坏。路径：设置 → 高级 → 诊断 → 清理缓存（Android 叫“清除本地节点缓存”，iOS 叫“Reset Local Nodes”）。执行后客户端会重启，启动时即重新拉取全量列表。注意：此操作不会删除应用级分流规则，但会让“最近使用”排序归零。

平台差异与最短入口对照表

平台	最短入口	备注
Android	首页 → 下拉刷新	无需进设置，最快
iOS	首页 → 下拉刷新	同 Android，动画更慢 0.3 s
Windows	托盘图标 → 右键 → 重新获取节点	v7.0.9 起新增，隐藏较深
macOS	菜单栏 → 快连 → 重新获取节点	原生 ARM 包同样适用
Linux CLI	kuailink-cli refresh	需 sudo，否则无写权限

失败分支与回退方案

若执行上述三步后列表仍为空，请按以下顺序回退，切勿反复卸载重装，以免触发账号 5 分钟冻结策略。

1. 检查系统时间：与 NTP 误差＞90 秒会导致 TLS 证书校验失败，表现为“网络错误 4001”。
2. 关闭私人 DNS（Android 14 特有）：设置 → 网络和互联网 → 私人 DNS → 关闭。
3. 关闭其他代理类软件：Clash、Surge、Proxifier 会占用本地 7890/1080 端口，造成冲突。
4. 切换网络：公司内网若对境外 IP 做白名单，可开手机热点秒测。
5. 最后才考虑卸载重装，且务必删除「安装目录/cache」文件夹（路径因版本而异，请以实际为准）。

何时不值得继续折腾

以下场景建议直接联系客服，而非反复手动刷新：

• 账号已触发“子账号设备数超限”风控，表现为主账号列表正常、子账号空白——需后台解封。
• Quantum-Safe 隧道与路由器 MTU 不匹配，导致每次拉取都 400 Bad Request——需官方下发专用 Probe。
• 公司网络启用 TLS 深度检测，替换证书后客户端拒绝握手——需提供自定义 CA 功能，目前尚未开放。

验证与观测方法

想量化“手动重获取”是否成功，可自建一条可复现的观测指标：

1. 打开客户端内置「诊断日志」→ 勾选“网络请求”。
2. 执行下拉刷新，过滤关键字full?protocol=，若返回200且size≈80 kB，即算成功。
3. 再查看nodes_count字段，若≥3000（经验性观察值），说明全量已落盘。

适用/不适用场景清单

场景	是否推荐手动刷新	原因
家庭宽带突然空白	✅ 推荐	多为缓存失效，三招即可
地铁 4G 隧道切换	⚠️ 视情况	网络闪断，待信号稳定再刷
账号被风控冻结	❌ 无效	需后台解封，刷新无用
路由器 MTU 异常	❌ 无效	握手层失败，需调 MTU

最佳实践 5 条速查表

1. “空白列表”先下拉刷新，1.5 秒无结果再切 4G，不要连续猛刷。
2. 桌面用户优先用“协议切换”触发，比清理缓存少一次重启。
3. 清理缓存后首次拉取会稍慢，属正常，勿二次清理。
4. 若你启用了子账号，确认主账号未超“单节点 3 台”限制。
5. 任何步骤失败后，先截图诊断日志再给客服，可缩短 50% 工单往返。

FAQ（结构化数据）

收尾：下一步行动建议

节点列表空白并非“软件坏了”，而是客户端在保护你不连到不可用的地址。记住“先刷新、再切协议、后清缓存”的顺序，90% 场景可在 30 秒内自愈；剩余 10% 先核对网络与时间，再决定是否要走客服通道。把本文的 5 条速查表截图保存在手机相册，下次再遇空白，不必慌张。