如何在快连kuailian客户端中导出节点列表并保存到本地？
功能定位：为什么需要“导出节点列表”
在快连（QuickLink）里，节点列表就是所有可连线路的“身份证”。当公司 IT 要求提交合规备案、换机迁移，或想把公司账号与个人账号做物理隔离时，手动抄节点既不现实也容易出错。官方在最新版把“导出”入口从隐藏菜单挪到一级页面，既降低备份门槛，也满足企业审计对“配置可留痕”的硬性要求。
与“收藏节点”“历史记录”不同，导出文件是一次性快照，不含连接日志，也不带账号令牌，因此可放心传送给同事或保存在 Git 私有库。下文所有路径均以 2026-03-25 发布的 v11.2.0 为基准；若你停留在老版本，请先升级再对照操作，否则菜单名称可能缺失。
导出前的三件事：格式、权限、场景
1. 选格式：JSON 还是 TXT？
JSON 保留完整元数据（延迟、协议、运营商、星链标签），方便写脚本批量测速；TXT 仅输出“host:port#remarks”，适合直接导入 Clash、Surge 或路由器固件。经验性观察：节点数 ≤50 时，两种文件体积都在 10 KB 以内，差异可忽略；节点数＞200 时，JSON 比 TXT 大约 35%，但能一次性携带 QoS 标签，后续写自动化规则更省心。
2. 查权限：个人版 vs 企业版
个人版每日限导出 3 次，企业版无次数限制，但需“配置管理员”角色。若按钮呈灰色，先确认自己是否被管理员关闭了“节点可见性”。路径：Windows 客户端→设置→账户→角色权限清单，查看“ExportNodes”是否被设为 Deny。
3. 对场景：备份、迁移、审计
- 备份：导出后加密压缩，存两处（本地+网盘），恢复时直接“导入”即可。
- 迁移：新旧电脑同时在线，把文件用 U 盘一次性搬运，再在新电脑“导入”后注销旧设备，可避开 12 台上限的排队。
- 审计：企业用户把 JSON 文件传给合规组，配合官方无日志报告，即可证明“出口线路可追踪但不保留内容”。
示例：某金融团队每月 1 号自动导出 JSON，配合 GitLab CI 生成校验报告，审计时直接拉取 release 附件，全程无人值守。
四平台最短路径（含失败分支）
Windows / macOS
- 主界面左侧边栏→“节点”→右上角“⋯”→“导出列表”。
- 在弹窗选格式（JSON/TXT）、保存目录，点“确认”。
- 若提示“导出失败：-16”，说明本地缓存损坏；关闭客户端，删除安装目录下 cachepeers.db 后重启即可。
Linux（quickctl CLI）
返回“Export completed: 312 nodes”即成功；若提示“permission denied”，请检查 ~/.quicklink/token.json 是否过期，执行 quickctl login 刷新。
Android / iOS
App 内“我的→工具箱→导出节点”，选“分享文件”即可调用系统 Sheet 保存到本地文件夹或 AirDrop。iOS 若找不到“保存到文件”，请先在系统设置把“文件”App 的 iCloud 权限打开；Android 15 若出现“存储受限”，需手动授予“所有文件访问”权限。
导入与验证：确保文件真的可用
导出只是上半场，真正保险的做法是“当场导入验证”。在同一台机器新建一个临时配置文件，把刚导出的 JSON 导入，观察节点数量是否匹配、延迟是否正常。经验性观察：若数量差＞3%，通常是缓存节点已下线，属于正常浮动；若差＞10%，则文件可能被截断，应重新导出。
CLI 快速校验（Linux & macOS）
何时不该导出？三条红线
- 公共电脑：导出文件会明文存放，若忘记删除，可被任何管理员账号读取。
- 节点数＞1000 的企业大池：一次性 JSON 可能＞1 MB，部分老旧路由器导入时会内存溢出，应分批次导出或使用 CSV 精简模板。
- 合规禁止离境：某些地区要求“线路配置不得出境”，若你打算把文件同步到海外云盘，请先确认当地法规。
与第三方工具协同：最小权限原则
你可以把 JSON 丢给开源测速脚本（如 Node.js 版的 qkspeed），但务必在本地执行，避免把 token 或账号 UUID 一并上传。导出文件本身不含密钥，但 remarks 字段可能带有内部编号，上传公开仓库会泄露节点拓扑。工作假设：若备注含“CN2-GIA-Shanghai-B2B”，攻击者可据此绘制运营商骨干图。缓解方法：导出后用 sed 批量清 remarks，或改用 TXT 格式。
故障排查：从现象到处置
| 现象 | 最可能原因 | 验证手段 | 处置 |
|---|---|---|---|
| 导出按钮灰色 | 权限角色为 Guest | 设置→账户→角色 | 让管理员改 Role≥User |
| JSON 为空数组 | 筛选器开启“仅显示推荐” | 节点页顶部检查漏斗图标 | 关闭筛选重新导出 |
| iOS 分享面板闪退 | 系统内存不足 | 设置→隐私→分析与改进→分析数据 | 重启设备，或先导出到 Files 再转存 |
最佳实践清单：导出节点列表的 5 步闭环
- 每月固定日期导出，文件名带年月，例如 nodes_2026-04.json。
- 用 SHA-256 计算校验值，写入同目录 hash.txt，防止静默损坏。
- 加密压缩（zip -e）后双备份：本地 SSD+离线 U 盘。
- 导入验证通过后再删除旧文件，保持“一备一用”而非堆积。
- 若节点数＞500，采用 CSV 精简模板，分洲/分用途存放，降低单文件体积。
版本差异与迁移建议
v10.x 时代导出入口在“诊断-高级-导出配置”，且只支持 TXT；v11.0 起才增加 JSON。若你从 v10 直接跳到 v11，旧 TXT 仍可读，但缺失 QoS 字段，建议重新导出一次以获得完整元数据。企业控制台 v3.1 以上才支持 CSV 批量模板，老版本需先升级控制台插件，否则导入会报“column mismatch”。
FAQ（常见问题）
导出后的 JSON 能否直接发给同事？
可以，文件不含登录令牌，但 remarks 可能含内部编号，建议先脱敏。
每日 3 次额度用完怎么办？
升级到企业版或等 UTC 零点重置；也可用 CLI 在本地验证，不消耗额度。
导入后延迟全红，是文件坏了吗？
大概率是时间戳过期，重新测速即可；若仍全红，检查本地 DNS 是否被劫持。
总结与下一步
快连客户端把“备份、迁移、审计”三件事压缩成一次点击，只要遵循“先验证、后加密、再双备”的闭环，就能在换机、合规、故障回溯时省下大量重复劳动。读完本文，建议你立刻打开客户端按路径试导一次，并用上文 CLI 命令校验节点数是否一致；确认无误后，把加密压缩与双备步骤写成月度提醒，才算真正落地。
未来版本大概率会开放「增量导出」与「自动分片」选项，企业控制台也将支持 Git 式版本对比。提前把校验脚本和命名规范准备好，等新版推送即可一键接入，无需再回头整理历史文件。
