功能定位：订阅节点更新失败到底卡在哪
快连 privacy tool 的「lets订阅」本质是一段 HTTPS 短链，客户端定时拉取返回的 YAML/JSON 配置，再解析成 6500+ 节点的元数据。若更新失败，客户端会回退到本地缓存，但缓存过期或校验值不匹配时，就会出现「节点列表为 0」或「全部显示 Timeout」的情况。手动刷新配置的核心关键词正是快连lets订阅节点更新失败如何手动刷新配置，它解决的是「订阅链路可达，但客户端未成功落地」的中间层问题，而非账号失效或区域性封锁。
与「切换协议」「重选节点」不同，刷新配置只更新元数据，不会改变本地路由规则；因此即使刷新成功，也仍需手动触发一次节点重连才能生效。很多用户把二者混为一谈，导致反复刷新却看不到延迟下降，就是忽略了「元数据→活动连接」的二次握手。
刷新前的 30 秒自检：先区分网络层还是应用层
在动手刷新前，用系统浏览器访问订阅链接（可在「设置-订阅管理-复制链接」取得），若返回 200 并出现一行以「proxies:」开头的明文，则证明网络层可达，故障在客户端；若浏览器提示 403/404 或证书失效，则属于订阅链路被封或 URL 过期，需更换订阅地址，再谈手动刷新才有意义。
经验性观察：部分企业网对「*.letsapi.com」域名启用 SNI 重置，会导致浏览器正常而客户端失败。此时把订阅链接粘贴到 4G 热点环境再做一次对比，即可定位是局域网策略还是账号失效。
Windows / macOS 桌面端：最短手动刷新路径
步骤 1 打开隐藏入口
主界面右上角「≡」→「订阅管理」→ 选中 lets 订阅卡片 → 右下角「⋮」→「立即刷新」。整个入口深度为 3 级，无快捷键；若界面处于折叠模式，需先展开「高级功能」才能看到「订阅管理」。
步骤 2 观测回显日志
点击刷新后，客户端会在后台弹出「任务中心」迷你窗口，显示「Fetching…」「Parsing…」「Merged x nodes」三行回显。若卡在 Fetching 超过 15 秒，基本可判定为订阅链路被重置；此时应取消任务，回到浏览器自检环节，而非继续重复点击。
失败回退方案
若回显出现「Signature mismatch」，说明本地公钥与服务器不一致，属于版本向后兼容问题。关闭客户端→进入安装目录（默认在 %AppData%\QuickLink 或 ~/Library/Application Support/QuickLink）→删除「subscription.db」与「lets.cache」两个文件→重启客户端，系统会强制重新拉取全量配置，相当于「冷刷新」。
Android / iOS 移动端：路径差异与缓存清理
Android 最短路径
首页下拉即可看到「订阅刷新」按钮，这是 2026 版 Material You redesign 后的唯一快捷入口；若你仍停留在旧版，需要「我的→设置→订阅设置→⋮→刷新」。刷新过程会弹出通知栏进度条，成功后在通知栏显示「已更新 x 个节点」。
iOS 最短路径
由于系统后台限制，iOS 把刷新入口收在「设置-订阅管理-向左滑动 lets 卡片-刷新」。滑动手势必须按住卡片边缘 0.3 秒以上，否则容易误触为「编辑别名」。刷新完成后，若节点数量仍为零，可尝试切到「飞行模式」再恢复，强制让 URLSession 重建 TCP，经验性观察可解决 30% 的「假失败」。
缓存清理按钮在哪
移动端没有桌面级的「任务中心」，但提供「清理缓存」按钮（Android：我的-存储-清理缓存；iOS：设置-存储-清理缓存）。该操作会删除 lets.cache，不会清除用户自定义的分应用规则，因此可作为轻量级回退方案。
Linux CLI / OpenWrt 插件：命令行刷新方法
headless 环境没有 GUI，需要调用 qlink-util 子命令：qlink-util sub refresh --alias lets。若返回「code=200, nodes=6500」即成功；若提示「sub not found」，先用 qlink-util sub list 确认别名是否被误删。
OpenWrt 插件在「服务-快连-订阅」页面提供「Update」按钮，底层同样调用 qlink-util。部分固件默认把 /tmp 挂载为 tmpfs，空间不足会导致「写入失败」，此时把缓存路径改到 /mnt/sda1 即可，具体路径因版本和安装方式而异，请以实际为准。
常见失败码与处置对照表
| 回显关键词 | 可能原因 | 处置优先级 |
|---|---|---|
| Signature mismatch | 公钥轮换 | 删 db 冷刷新 |
| TLS handshake timeout | SNI 重置 | 换网络/换订阅域 |
| 403 Quota Exceeded | 账号流量封顶 | 后台升级套餐 |
| 0 node after parse | 格式不兼容 | 回退客户端版本 |
刷新后仍无法连接？三步验证法
- 在「节点列表」随机挑一个 5 字母节点，点击「诊断」，看是否「TLS 建立」「握手延迟」两项均打勾；若 TLS 失败，则是节点离线，与订阅刷新无关。
- 切到「日志」面板，搜索「handshake did not complete after」，若出现频次 >50%，说明当前网络对 UDP 443 进行 QoS 限速，需切到 TCP 模式或换协议。
- 开启「AI Ping 预测」观察 30 秒，若延迟曲线持续高于 350 ms 且丢包 >5%，建议换区而非继续刷新，因为元数据已是最新，问题在于动态负载。
什么时候不该手动刷新
1) 同一账号在 12 台设备同时在线，已触发「并发抢线」机制，此时刷新元数据无效，需先下线冗余设备；2) 企业后台启用了「强制节点白名单」，刷新后非白名单节点会被自动剔除，表现为「刷新成功但可用节点为 0」，需联系管理员改策略；3) 正在直播推流或游戏对局中，刷新会导致现有 TCP 长连接被 reset，出现瞬断 2-3 秒，建议在对局结束后再操作。
最佳实践清单：把刷新做成半自动化
- 桌面端启用「定时刷新」并设定 360 分钟周期，避开工作时段；
- 移动端关闭「省电模式」，防止小米/华为系统冻结后台定时任务；
- Linux CLI 写进 crontab
*/6 * * * * qlink-util sub refresh --alias lets > /var/log/qlink_sub.log 2>&1，配合 logrotate 避免磁盘打满； - 每次刷新后记录「节点数量-延迟均值」到本地 CSV，用 Excel 生成趋势图，当连续 3 个周期节点数下降 >30% 即人工介入。
FAQ：手动刷新配置常见疑问
刷新订阅会被封号吗？
不会。官方文档把订阅拉取归类为「只读操作」，不限频次；但连续 60 秒内超过 10 次会触发 5 分钟限速，表现为 429 状态码。
冷刷新后自定义规则消失怎么办？
删除 subscription.db 不会清除「分应用代理」与「自建 DNS」规则，它们保存在 profile.json；若发现丢失，大概率是误触「恢复默认」，可在「设置-配置管理-本地备份」找回最近 7 天的快照。
刷新成功但节点延迟反而更高？
元数据更新会把高负载节点重新纳入列表，AI Ping 预测需要 1-2 分钟完成二次排序；观察满 3 分钟后再看延迟曲线，若仍高于刷新前，可手动触发「AI 一键调优」让客户端重新选线。
总结与下一步行动
手动刷新快连 lets 订阅节点，本质是「在客户端侧强制重新拉取并校验元数据」，它不能解决网络被封锁或账号欠费的问题，但能快速修复因缓存损坏、公钥轮换或临时 503 导致的「零节点」假死。记住「浏览器可达→再刷客户端」「刷完必重连」「高负载等 AI」的三步口诀，就能把 90% 的更新失败在 1 分钟内自愈。
下次遇到节点列表空白，先别急着卸载重装，按本文对应平台的最短路径点一次「立即刷新」，再配合诊断日志定位，就能省下大量无谓的排队客服时间。若你还有多设备协同或企业级批量维护需求，可以把 qlink-util 封装进 Ansible playbook，实现真正的无人值守刷新。
