快连如何导出节点列表并备份到本地？

功能定位：为什么需要本地备份节点列表

kuailian 的“节点列表”本质上是客户端与服务端协商后生成的 server_cache.json，内含中继地址、端口、协议类型及上次延迟评分。官方云端每日凌晨同步一次，但本地缓存被误删、换机或降级安装时，重新拉取可能触发“429 限流”。把节点快照导出到本地，可在断网或账号异常时秒级恢复，避免高峰期排队。

版本差异与入口对照表

截至当前最新版本（5.6.0），导出功能已全平台上线，但入口深度不同：

平台	最短路径	最低版本
Android	我的→设置→高级→节点管理→导出	5.5.2
iOS	Settings→Advanced→Node List→Export	5.5.0
Windows	托盘图标右键→工具→导出节点	5.4.8
macOS	菜单栏快连图标→Preferences→Nodes→Export	5.5.1

Android 端操作详解

步骤 1：生成快照

打开 kuailian，等待首页延迟测试完成（右上角出现绿色对勾），确保本地缓存已写入。依次进入“我的→设置→高级→节点管理”，点击右上角“⋮”选择“导出节点列表”。系统弹出文件保存对话框，默认文件名格式为 kl_nodes_YYYYMMDD_HHMMSS.json，大小约 120–180 kB。

步骤 2：选择存储位置

Android 11 及以上受分区存储限制，推荐直接存到 Download/ 目录，后续用系统文件管理器或 USB 导出到电脑。若设备已 root，也可手动复制 /data/data/com.kuailian.privacy/files/server_cache.json，但路径因版本而异，需自行验证。

回退方案：导入失败怎么办

若未来导入时提示“格式不兼容”，先在旧版本客户端卸载更新，装回导出时的同版本号，执行导入后再升级。经验性观察：跨两个大版本（如 5.4→5.6）仍向下兼容，但字段新增会提示“未知 key 已忽略”，不影响使用。

iOS 端操作详解

iOS 因沙盒机制，导出后只能先存入“文件”App 的“快连”文件夹。点击 Export 后，系统跳转到分享面板，选择“保存到文件”即可。随后通过 AirDrop、iCloud 或数据线拖到电脑。注意：若开启“家长控制”白名单，导出功能会被隐藏，需先关闭青少年模式。

Windows & macOS 批量导出

桌面端支持一次性导出全部节点与自定义分组。Windows 托盘右键→工具→导出节点，默认保存在 %USERPROFILE%\Documents\Kuailian\；macOS 则在 ~/Documents/Kuailian/。文件含 nodes.json 与 groups.json 两份，恢复时需放在同一目录下。

兼容性与格式解析

导出文件为 UTF-8 编码的 JSON，顶层字段如下：

{
  "ver": 3,
  "export_at": 20260410T123456Z,
  "nodes": [...],
  "groups": [...]
}

其中 ver 为格式版本号，客户端导入时会先比对，低于本地支持的最小版本将拒绝写入。经验性观察：ver=3 自 5.5.0 起启用，老版本客户端无法识别，需先升级。

风险控制：什么时候不该用本地备份

• 节点密钥具有时效性（默认 7 天滚动更新），过期后导入仍能连接，但会被服务端强制重协商，延迟反而增加。
• 若账号已暂停或流量包用尽，导入节点后同样无法握手，错误码 401，此时应优先检查订阅状态。
• 青少年模式开启后，部分海外节点会被本地过滤，即使导入成功也不会出现在列表，需先关闭家长控制。

与第三方归档工具协同

高级用户可把 nodes.json 纳入 Git 私有仓库，配合 GitHub Actions 每日凌晨自动拉取最新快照，实现“配置即代码”。但注意：文件内含认证 token，务必加密或放在私有库，避免泄露导致账号被刷流量。

故障排查：导入后节点全灰

1. 确认导入文件未损坏：用任意 JSON 校验工具检查格式。
2. 检查系统时间：节点证书对时敏感，误差＞5 min 会触发 TLS 握手失败。
3. 查看日志：Windows/macOS 可在设置→诊断→导出日志，搜索 invalid_cert 关键字。
4. 仍无法解决：删除本地 server_cache.json，重启客户端重新拉取云端列表，再执行一次导入。

适用场景清单

场景	是否推荐导出	理由
换机迁移	✅ 强烈推荐	避免新机高峰排队
短期出差无网	✅ 推荐	离线仍可查看节点 IP
团队共享	⚠️ 谨慎	token 会泄露，需加密
合规审计	❌ 不推荐	文件不含访问日志

最佳实践 4 步法

1. 每月 1 号手动导出一次，文件名带日期，放私有云盘。
2. 升级大版本前，先导入旧快照验证兼容性，再覆盖安装。
3. 出差前用二维码把 200 kB 文件传到自己邮箱，无网时也能搜节点 IP。
4. 不再使用的旧快照及时 shred 删除，防止 token 残留。

FAQ（必须使用 FAQPage Schema）

总结与下一步行动

kuailian 的节点列表导出备份功能，本质是把云端动态配置拍一张“本地快照”。掌握三端最短路径、版本兼容边界与 token 保密原则，即可在换机、断网、账号异常三大场景下实现秒级恢复。建议你立刻动手导出一份今日快照，按“日期+平台”命名，存入私有云盘，并在下次升级前验证导入流程——完成这一步，你就拥有了真正意义上的“离线救生包”。