快连节点列表为空时如何手动刷新并恢复显示？

功能定位：节点列表为何突然消失？

在快连（Kuailian privacy tool）里，节点列表就是可用出口的实时目录。客户端启动时会先向后台节点索引接口拉取最新数据，再写入本地缓存：Android 端位于 /Android/data/com.kuailian/files/node_cache.json，桌面端则在安装目录的 data/node_cache.json。一旦接口返回空数组、缓存文件损坏或本地时间戳过期，UI 就会直接显示“列表为空”。

手动刷新正是让客户端跳过缓存、重新请求索引并覆写本地文件。它与“智能选路”“AI 加速”无关，只解决“看不见”的问题，不解决“连不上”的故障。

操作路径：三平台最短入口

Android（v8.4.0 及之后）

1. 打开快连 → 底部导航节点页；
2. 顶部右侧“⟳”图标即为刷新；
3. 若按钮灰色，先下拉一次列表，系统会解除灰色状态。

经验性观察：部分国产 ROM 把后台弹窗权限关闭后，刷新会静默失败，界面仍空白。此时需手动授予“后台弹出界面”权限，再重试。

iOS（TestFlight v8.4.1）

1. 底部栏进入节点；
2. 在列表最顶端按住下拉 2 cm，出现转圈即触发刷新；
3. 若转圈 3 秒内消失且仍空白，说明接口返回空数组，需继续看下一节“缓存清理”。

Windows/macOS（桌面端）

1. 主界面左侧节点列表；
2. 右上角“⟳”按钮；
3. 若提示“刷新失败：-1001”，代表本地证书被安全软件拦截，需临时关闭SSL 扫描或把 api.kuailian.net 加入白名单。

缓存清理：当刷新仍无效时

刷新只是重新请求索引，不会修复已损坏的缓存文件。若接口实际返回正常，但本地写入失败，就需要手动删文件让客户端重建。

Android 路径（无需 Root）

• 系统设置 → 应用 → 快连 → 存储 → 清除缓存；
• 或手动删除：/Android/data/com.kuailian/files/node_cache.json（具体路径因版本和安装方式而异，请以实际为准）。

iOS 路径

• 系统设置 → 通用 → iPhone 存储空间 → 快连 → 卸载 App（保留文档与数据）→ 重新从 TestFlight 安装；
• 经验性观察：iOS 无法单删缓存文件，整体重装最快。

桌面端路径

• 退出客户端 → 进入安装目录 → 删除 data/node_cache.json → 重启即可。

例外与取舍：什么时候不该刷新

1. 账号已过期：刷新后依旧空白，但顶部会提示“订阅失效”。此时刷新无效，需先续费。

2. 出口被区域 DNS 污染：部分宽带把 api.kuailian.net 解析到 127.0.0.1，导致永远空列表。解决：把 DNS 临时改为 8.8.8.8 或 1.1.1.1，再刷新。

3. 公司网络屏蔽 UDP 443：节点索引接口走 KLP-UDP 443，若被防火墙丢弃，刷新会超时。可切手机热点验证，若热点正常即证明内网限制。

验证与观测方法

1. 用抓包工具（如 HttpCanary、Wireshark）过滤 host contains api.kuailian.net，看是否返回 200 且 body 长度 >2 KB；若 200 但 body 仅 []，说明后台真没节点。

2. 对比网页版个人中心：登录 https://account.kuailian.net → 节点状态页，若网页也显示“无可用节点”，则问题在账号权限，非客户端。

3. 看日志：桌面端开启设置 → 高级 → 导出日志，搜索 fetchNodeList，若出现 signature verify fail，则是本地时间错误，校准系统时钟即可。

适用/不适用场景清单

场景	是否建议手动刷新	原因
首次安装后列表空白	✅ 建议	首次未拉取到索引
续费后仍空白	✅ 建议	权限已恢复，需重新拉取
后台提示“维护中”	❌ 无效	全局无节点，刷新也返回空
公司网络屏蔽域名	❌ 无效	需先解决网络层屏蔽

最佳实践 4 步法

1. 看提示：先读顶部横幅，确认不是“订阅过期”或“系统维护”；
2. 切网络：用 4G/5G 热点 10 秒，排除宽带的 DNS 污染或 UDP 屏蔽；
3. 再刷新：按平台路径手动刷新一次，观察 5 秒；
4. 清缓存：若仍空白，退出客户端→删缓存→重启→再刷新。

FAQ（使用 FAQPage Schema）

总结与下一步

快连节点列表空白，90% 可通过“手动刷新+清缓存”两步解决；剩余 10% 需排查账号、网络或系统时间。按本文四步决策树操作，通常 2 分钟内可见节点重现。若走完流程仍空白，请把日志与抓包结果打包发至官方 QQ 群，中文客服承诺 10 分钟内人工复核。

下一步：把本文“最佳实践 4 步法”截图保存到手机，下次再遇空白可直接对照，减少无效重启与重复安装。