快连Mac端如何清除配置文件缓存解决节点加载失败？

功能定位：为什么缓存会导致节点加载失败

在快连 Mac 端，节点列表由本地 config.json 与 node-cache.db 共同驱动。启动时，客户端优先读缓存以省握手时间；若服务器已下线某节点，而本地仍保留旧指纹，就会触发“加载失败”或“超时 10060”。删除这两份文件等于强制重新拉取权威列表，属于官方文档里的“轻度排障”，不会影响账号或流量包。

经验性观察：节点数突然从 200+ 掉到 20 以下，且反复开关“智能选路”无效时，九成案例靠清缓存即可自愈；剩余一成需再核对本地时间或根证书。

前置检查：先确认是缓存问题而非网络层

动手前，让“线路医生”跑一圈。入口：顶部菜单栏图标 ▸ 帮助 ▸ 线路医生。报告若提示“节点列表拉取失败”且返回码 4xx，可按本文继续；若提示“TLS 握手 Reset”，则属传输层干扰，应改用 ShadowTLS 或 QUIC 模式，清空缓存并无帮助。

操作路径：图形界面三步完成（macOS 11 及以上）

步骤 1 退出客户端并防止后台残留

Dock 右击“快连”▸ 退出快连，随后打开活动监视器，检索“QuickLink”或“Kuailian”。若有残留进程，强制结束，否则下一步会因文件占用而失败。

步骤 2 定位配置目录

Finder 按下 Command+Shift+G，粘贴路径：~/Library/Application Support/Kuailian。系统语言为英文时，文件夹显示为“QuickLink”，实质相同。进入后可见 Profiles、Cache、Logs 三个子目录。

步骤 3 选择性删除缓存文件

保留 Profiles/userinfo.json（含账号与订阅到期日），仅删下列两项：

1. Cache/node-cache.db —— 节点指纹与延迟历史；
2. Cache/config.json.tmp —— 上次拉取失败的半成品。

清空废纸篓后重启快连，主界面会显示“正在更新节点 0/xxx”，数十秒内即可恢复完整列表。

无图形界面方案：终端一条命令（可选）

脚本化管理可直接执行：

rm -f ~/Library/Application\ Support/Kuailian/Cache/node-cache.db \
       ~/Library/Application\ Support/Kuailian/Cache/config.json.tmp

随后 killall -9 QuickLink 确保进程重启，效果与图形操作等同，也便于 MDM 批量下发。

回退方案：误删后如何自救

若误删整个 Profiles，启动后会提示“未找到订阅”。无需重装，只需重新扫码或粘贴订阅链接，服务器会重新下发 userinfo.json，流量包与到期日仍与账号绑定，不会丢失。

警告：删除 Logs 目录虽不影响功能，但排障需回传日志给客服，建议保留最近 7 日。

平台差异：Windows 与 Android 是否通用

Windows 同级目录在 %APPDATA%\Kuailian\Cache，Android 位于 /sdcard/Android/data/com.kuailian.privacy tool/cache/，文件名与 Mac 端一致；iOS 因沙箱限制，只能卸载重装以清除缓存，无法手动删单文件。

验证与观测：如何确认清理已生效

1. 启动后节点数应回升至订阅页所示总量（如 200+）。
2. 右上角 ⓘ ▸ 诊断信息 中，last_node_update 时间戳应为当前。
3. 随机测速 3 个节点，延迟与官网公告误差在 ±10 ms 内。

若仍低于预期，再跑一次“线路医生”确认是否属传输层问题。

最佳实践：减少再次积压的 4 个习惯

• 每周手动点一次 刷新节点，防止缓存过期。
• 开启 设置 ▸ 高级 ▸ 节点自动更新，间隔设为 48 h。
• 避免频繁切换“仅游戏模式”与“全局模式”，该动作会强制重写缓存，加大损坏概率。
• 睡眠唤醒后若提示“网络环境变化”，先刷新再连接，降低旧指纹冲突。

不适用场景：何时不要清空缓存

若你正使用“家长控制 2.0”并设有限时策略，清空缓存会重置本地规则，孩子端设备会短暂恢复默认白名单。建议先导出 parental.json 备份，再执行清理。

FAQ：常见疑问一次说清

结论与下一步

清除配置文件缓存是快连 Mac 端解决“节点加载失败”成本最低的自救手段：零命令行、不丢流量、可回退。把“线路医生 + 缓存清理”写进你的固定排障清单，并在设置里把自动刷新间隔调到 48 h，可大幅降低复发概率。若以上步骤仍无法恢复，请携带诊断信息联系官方客服，避免反复重装浪费时间。