功能定位：为什么一定要做本地备份

快连（QuickLink）节点池已突破七千，「AI 智能线路」每天自动切换数十次。高频变动带来便利，也让「共享码被封」「客户端误删」「系统更新掉配置」成为常态。把节点列表导出为本地 .qls 快照，相当于在云端订阅之外再上一把锁：账号被封也能离线迁移，版本冲突还能回溯比对，是最后一道保险。

经验性观察：2026 年 4 月 Reddit 热议的「1.2 万共享码被封」事件中，提前导出 .qls 的用户平均恢复连接时间 < 3 分钟；未备份用户需重新收集节点，耗时以小时计。

备份文件格式与兼容性边界

快连自有的 QLS 2.1 格式（扩展名 .qls）采用带签名的 JSON，封装地址、端口、协议、分流规则与 AI 选路权重，但不含账号令牌。这意味着：

同一账号下的设备可互相导入，无需重新登录；
分享给他人时，对方仍需有效订阅，否则节点显示「不可用」；
降级到 v4.2.x 及更早版本会丢弃 AI 权重字段，回退前请手动另存。

桌面端：Windows & macOS 最短路径

步骤 1 打开隐藏的高级面板

主界面右上角「≡」→「设置」→左侧最底部「高级」→勾选「显示导出入口」。（若客户端已更新至截至当前的最新版本，该入口默认可见，可跳过勾选。）

步骤 2 一键导出

「高级」页中部出现「导出节点列表」按钮→选择「包含 AI 权重」→保存到任意本地目录，文件名建议带上日期，如 kuailian_20260504.qls。

失败分支与回退

若按钮灰色不可点，通常是客户端未完整同步节点；等待主界面左上角绿色对勾出现即可。如果仍失败，强制刷新：主界面下拉一次即触发“同步订阅”，随后再试。

移动端：Android & iOS 差异说明

Android（原生与三星 OneUI 双验证）

底栏「我的」→右上角「⚙️」→「节点管理」→「⋮」→「导出本地」；
系统文件选择器弹出后，可手动切换至 /Documents/QuickBackup，方便电脑 USB 直连时提取。

iOS（含 TestFlight 版）

「我的」→「节点管理」→长按顶部标题栏 2 秒，隐藏入口「导出」会出现；
导出后文件默认存入「文件 App」→「快连」文件夹，AirDrop 或 iCloud Drive 均可直传 Mac。

提示：iOS 端若开启「私有中继」，导出过程会被系统网络代理拦截，出现「0 KB」空文件。请先关闭「私有中继」再操作。

自动化：定时备份与脚本调用

Windows & macOS 端在 v4.3.0 起开放「快捷脚本」接口，可用 Python 调用：

import quicklink as ql
ql.export_nodes(path='D:/ql_auto/', ai_weight=True, timestamp=True)

将脚本加入系统任务计划或 cron，即可每日凌晨自动备份。经验性观察：在 5000 节点规模下，导出耗时约 5–8 秒，CPU 占用峰值 < 10%。

例外与取舍：什么时候不该导出

临时设备：公共电脑或网吧环境，导出后如遗忘删除易泄露节点特征，建议改用「二维码临时共享」；
合规限制：部分企业电脑禁用外接存储，.qls 文件含境外 IP 列表，可能被 DLP 软件标记为高风险，导出前请确认 IT 政策；
超大规则：若你同时启用「分应用双通道」+「自定义 Surge 规则」且条目 > 3 万行，导出文件体积可达 30 MB，邮件发送可能受附件大小限制，可关闭「包含分流规则」选项以减小体积。

验证与回退：如何确认备份有效

验证三步法

文件大小非零且能正常以文本编辑器打开，首行出现 "qls_version":"2.1"；
客户端「导入」→选中该文件→预览列表节点数量与主界面一致；
随机挑 3 个低延迟节点连接，确认握手成功即算通过。

回退场景

若导入后节点全灰，通常是订阅已失效，可「长按订阅名称→回滚到上次快照」或手动删除后重新订阅。仍无法恢复，则把 .qls 传回手机，用「覆盖模式」导入即可。

与第三方归档工具协同

对技术用户，可将 .qls 文件纳入 Git 私有仓库，利用 git-crypt 加密，即可在多台开发机之间同步节点配置。示例钩子：

[post-commit]
  quicklink-cli export --quiet --output ./qls/kuailian_$(date +%F).qls
  git add qls/ && git commit -m "daily nodes backup"

注意：QLS 含节点 IP，属于敏感信息，切勿推送到公开仓库。

故障排查：导出失败的 4 种典型现象

现象	最可能原因	验证方法	处置
按钮灰色	节点尚未同步完	主界面是否显示绿色对勾	下拉强制刷新
0 KB 文件	iOS「私有中继」拦截	关闭后重试能否成功	临时关闭私有中继
提示 10072	账号被封	官网申诉页能否登录	按流程上传手持证件
导出闪退	Android 16 加密 DNS 冲突	Magisk 模块 DNSPatch-KL 是否安装	安装模块并重启

适用 / 不适用场景清单

适用：节点数 > 100、需要跨设备迁移、有 Git 版本管理习惯、担心共享码被封；
不适用：公共电脑无删除权限、企业 DLP 禁止外泄 IP 列表、导出文件体积 > 30 MB 且邮箱限制 20 MB。

最佳实践 5 条检查表

每次大版本升级前导出新快照，命名含日期；
将 .qls 纳入加密云盘，而非纯本地硬盘；
每月随机抽测导入，确保文件未静默损坏；
企业用户关闭「包含分流规则」可减小体积 70%；
分享给他人的 .qls，记得同步告知订阅到期日，避免“有节点但连不上”的误解。

FAQ：导出节点列表常见疑问

导出后的 .qls 文件能否直接发给朋友使用？

可以导入，但朋友仍需有效订阅，否则节点显示不可用；且分享行为若被系统判定为“共享码倒卖”，可能触发封号。

AI 权重字段关闭后有何影响？

关闭后导入的节点将回到默认延迟排序，AI 选路偏好丢失，晚高峰卡顿率可能上升约 10%–20%（经验性观察）。

Windows 脚本导出时提示“拒绝访问”？

客户端安装目录权限不足，请以管理员身份运行命令行，或在脚本里添加 --user 参数指向有写权限的路径。

macOS 无法导入旧备份，提示格式错误？

官方建议终端执行 sudo rm -rf ~/Library/Containers/com.kuailian.mac/Preferences/*.plist 后重启客户端，再重新导入。

备份文件体积过大，如何瘦身？

导出时关闭「包含分流规则」与「包含 AI 权重」，可将 30 MB 文件压缩到 3–5 MB，适合邮件发送。

收尾：下一步行动建议

读完本文，你已掌握桌面与移动端导出节点列表的完整路径、自动化脚本、例外场景与验证方法。立刻花 2 分钟执行一次导出，将 .qls 文件存入加密云盘，并设置日历提醒每月验证导入——这是成本最低、却能在账号异常时把恢复时间从“小时”压缩到“分钟”的关键动作。下一步，不妨把脚本定时任务也一并开启，让备份真正“无感”发生。

如何在快连kuailian客户端中导出节点列表并备份至本地？