配置管理

快连kuailian如何导出配置文件备份节点列表?

作者:快连官方团队
配置备份导出
快连kuailian导出配置文件, 快连kuailian如何备份节点列表, 快连kuailian节点配置迁移步骤, 快连kuailian自动导出设置方法, 快连kuailian导出失败原因排查, 快连kuailian配置文件格式说明, 快连kuailian跨设备恢复节点

功能定位:为什么一定要导出节点列表

在 kuailian(Kuailian)里,节点列表就是加速路线的「导航图」。换机、重装或团队批量部署时,手动重新收藏 400+ 节点既耗时又容易遗漏专线入口。官方把「导出配置文件」做成独立按钮,让用户在数秒内拿到 JSON 格式的节点清单,连同分流规则、延迟数据一并带走,实现「一次备份,多端复现」。

与「账号同步」不同,导出文件可离线保存、可 Git 版本管理,也能嵌入自动化脚本,是运维者眼中的「基础设施即代码」。下文所有路径均以截至当前的最新版本(v5.7.0)为准;若你停留在 5.6 或更早,部分入口名称可能叫「导出服务器列表」,功能一致。

功能定位:为什么一定要导出节点列表
功能定位:为什么一定要导出节点列表

操作路径:Android / iOS / 桌面端最短可达

Android

  1. 打开快连,点击右下角「我的」→「高级设置」。
  2. 在「配置管理」区块,可见「导出节点配置」按钮,点选后弹窗提示「是否包含专线密钥」,默认开启。
  3. 选择保存位置:系统下载文件夹 / 自定义路径,文件名自动生成 kuailian_nodes_日期.json,约 200 kB。

iOS

  1. 底部导航进入「我的」→「设置」→「配置管理」。注意 iOS 18 以上需先允许「本地网络」权限,否则按钮置灰。
  2. 点「导出节点配置」→「存储到文件」,自动跳转到系统 Files;建议直接存入 iCloud Drive,方便 Mac 端读取。
  3. 若出现「无法写入」提示,经验性观察:重启「文件」App 可解决,属系统级沙盒缓存问题。

Windows / macOS

  1. 主界面右上角「⚙」→「配置中心」→「导出」。
  2. 桌面端额外提供「加密导出」选项,勾选后会要求输入 4-16 位数字密码,文件扩展名变为 .klex;恢复时必须输入同一密码,适合通过邮件发送给他人。
  3. 默认保存路径:Windows 为「下载」,macOS 为「用户/文稿/Kuailian」;可在设置里永久修改。

例外与取舍:什么不会被导出

官方文档已确认:导出内容仅含「节点地址、端口、协议、延迟快照、分流规则模板」,以下数据不会带走:

  • 账号令牌与流量统计——防止文件泄露后被二次贩卖。
  • 分应用代理的本地 App 列表——因涉及系统级包名,跨设备恢复会失效。
  • 网络医生日志——体积可达数十 MB,官方建议单独「一键发送客服」。

因此,若你依赖「白名单模式」给 200 款应用单独设规则,导出后仍需手动补录,或改用「黑名单模式」降低维护量。

警告

加密导出 (.klex) 一旦忘密无法找回,官方也無后门。建议把密码存入密码管理器再执行导出。

验证与回退:如何确认文件有效

快速校验

用任意文本编辑器打开 .json,首行应出现 "kuailian_version":"5.7.0",且节点数组长度 ≥ 300,即表示核心数据完整。若长度 < 50,可能是导出过程被系统清理后台,需重新操作。

回退场景

当新设备导入后发现延迟飙升,多半是「专线密钥」与当前运营商晚高峰策略冲突。此时可在「设置→恢复默认配置」一键清空,再手动导入旧版文件;或在导入弹窗取消「覆盖专线节点」,保留本地智能选路结果。

自动化协同:把导出塞进脚本

对于运维 50 台工位的跨境电商团队,可写一条 ADB 指令循环:

adb shell am broadcast -a kuailian.export --es path /sdcard/Download/

触发后客户端会在后台静默生成文件,文件名固定,方便 Python 脚本轮询并上传到内部 GitLab。注意:ADB 方案需提前在「开发者选项」打开「允许调试与后台导出」,否则广播会被拒绝。

自动化协同:把导出塞进脚本
自动化协同:把导出塞进脚本

故障排查:导出按钮灰色/失败

现象 可能原因 验证与处置
按钮置灰 iOS 本地网络权限未开 系统设置→隐私→本地网络→打开 Kuailian,返回即亮
导出 0 B 文件 后台被系统清理 锁定应用前台,重新导出;Android 可关闭电池优化
提示「密钥错误」 加密导出时输入密码格式不符 仅支持 4-16 位数字,字母符号会触发校验失败

适用/不适用场景清单

  • 适用:团队统一部署、个人换机、Git 版本化备份、合规审计留档。
  • 不适用:临时借账号给朋友——导出文件不含令牌,对方仍需你的账号密码登录;频繁导出做「增量同步」——文件为全量覆盖,无 diff 机制,效率低。

最佳实践 4 条

  1. 每月固定 1 日执行「加密导出+Git Tag」,文件名带年月,方便回滚。
  2. 把 .klex 与密码分开存储:文件放仓库,密码放公司密码管理器,降低单点泄露风险。
  3. 导入前先在测试机验证延迟,确认无丢包异常再推送到生产环境。
  4. 若使用「家庭云网关」Beta,记得在导出前关闭 443 端口监听,否则节点表会混入本地 NAT 地址,导致恢复后冲突。

版本差异与迁移建议

v5.5 及更早版本导出的节点表不含「AI 智能路径」权重字段,恢复到 v5.7 后会被标记为「兼容模式」,延迟预测精度下降。解决方法是:导入后手动触发「节点测速」一次,系统会自动补全权重,约数十秒内完成。

FAQ:导出配置文件常见疑问

导出文件能在第三方客户端使用吗?

不能。格式为 Kuailian 私有 JSON,含专线密钥与延迟快照,仅同生态客户端可识别。

加密导出与普通导出哪个更快?

文件大小相同,加密仅多一次 AES 层,耗时差异在亚秒级,可忽略。

导出后旧设备节点会清空吗?

不会,导出为只读操作;只有「恢复配置」才会覆盖本地列表。

文件太大无法邮件发送怎么办?

桌面端可勾选「压缩导出」,自动 zip 后体积降至 30% 左右,方便邮件附件。

导入时提示「格式过期」如何处理?

说明 JSON 版本号低于客户端最低支持,需在旧设备先升级到同版本再重新导出。

收尾:下一步行动

导出节点列表是 kuailian 生态里「可控可回滚」的第一步。建议你立即打开客户端执行一次加密导出,把文件与密码分离存放,并在测试机完成恢复验证。只有真正跑通「备份→验证→回退」闭环,才能在换机、合规审计或团队扩容时,做到心不慌、手不抖。