快连Mac端如何导出节点列表做离线备份？
功能定位：为什么要在Mac端做节点离线备份
kuailian在2026年2月更新的7.3.1版把「节点列表导出」入口从设置深处移到主菜单，核心关键词“快连Mac端如何导出节点列表做离线备份”对应的正是这一变更。对经常换机、重装系统或需要把公司账号配置同步到家用Mac的用户来说，离线备份能在断网环境下30秒内完成配置还原，避免重新扫码或手动输入订阅地址。
与iOS端“iCloud同步”不同，macOS版没有系统级钥匙串自动漫游，因此官方提供了本地JSON与明文两种格式：JSON保留完整QoS标签、Streaming白名单和Split-Tunneling规则，适合同版本恢复；明文只保留地址与端口，体积不足1 KB，方便嵌入脚本或企业MDM推送。理解二者差异后，再决定备份粒度，可减少90%冗余数据。
操作路径：三击鼠标完成导出
图形界面路线（推荐新手）
- 启动kuailian，确保左上角状态灯为绿色（已登录主账号）。
- 顶部菜单栏点击「QuickLink」→「节点」→「导出列表…」，此时会弹出保存面板。
- 在「格式」下拉框选择「JSON（完整）」或「Plain（明文）」，命名后保存到~/Documents/QuickLinkNodes/，默认权限600，仅当前用户可读。
若菜单呈灰色，说明本地缓存尚未拉取完毕，等待主界面节点延迟数值全部显示后再试；经验性观察，校园网场景下大约需要20–40秒。
命令行路线（适合自动化）
打开终端，执行以下示例（路径因安装方式而异，请以实际为准）：
/Applications/QuickLink.app/Contents/MacOS/quicklink-cli export --format json -o ~/Backups/ql_nodes_$(date +%F).json
命令执行完毕会返回「Exported N nodes」字样；若提示permission denied，需先在「系统设置-隐私与安全」里给终端授予「App管理」权限。
版本差异与回退方案
在7.2及更早版本，导出功能藏在「设置-实验室」内，且只支持明文。若你尚未升级，可临时用「设置-高级-生成调试报告」里的节点段落手动复制，再粘贴到文本文件；该报告包含敏感信息，用完后请立即删除或加密存储。
备份粒度取舍：JSON vs Plain
| 维度 | JSON（完整） | Plain（明文） |
|---|---|---|
| 体积 | 50–200 KB | 1–3 KB |
| 字段 | 含延迟、负载、Streaming标签 | 仅地址端口 |
| 跨版本兼容 | 仅限7.3及以上 | 全版本通用 |
| 适用场景 | 整机迁移、零配置还原 | 脚本批量导入、Git仓库跟踪 |
经验性观察：若你采用Split-Tunneling 3.0按进程分流，JSON能把「浏览器容器标签页」规则一并带走；Plain则丢失该维度，需要重新手动绑定。
恢复流程：如何把备份重新灌回Mac端
图形界面恢复
- 顶部菜单「QuickLink」→「节点」→「导入列表…」。
- 选中先前导出的JSON或Plain文件，点击「打开」。
- 客户端会弹出「覆盖」或「追加」选项；若你只想增量添加，选「追加」即可。
恢复完成后，建议立即执行「节点-延迟测试」验证可用性；若批量导入超过500条，界面可能卡顿数十秒，属经验性观察，不代表性能承诺。
CLI恢复（可写进自动化脚本）
quicklink-cli import --format json -f ~/Backups/ql_nodes_2026-04-01.json --mode replace
参数--mode可选replace或append；脚本执行成功返回「Imported N nodes, skipped M duplicates」。
与第三方工具的协同
Plain格式每行一条协议://地址:端口#备注，可直接被Surge、ClashX、V2RayU读取。若你在公司内网使用MDM下发配置，只需把Plain文件放到/Library/Application Support/QuickLink/auto_import.txt，客户端每次启动会自动拉取并追加，实现“零点击”节点更新。
sudo chown root:wheel锁定文件，防止普通账户误删。
故障排查：导出按钮灰色/导入后空白
- 现象：菜单灰色；原因：本地节点缓存未拉取完；验证：看主界面延迟值是否全部显示；处置：等待或手动下拉刷新。
- 现象：导入后列表空白；原因：JSON字段与客户端版本不匹配；验证：控制台日志显示「schema mismatch」；处置：用Plain格式过渡，或升级客户端至同一版本。
- 现象：CLI报告「permission denied」；原因：终端未获「App管理」权限；验证：系统设置-隐私与安全列表无终端勾选项；处置：手动授权并重启终端。
适用/不适用场景清单
| 场景 | 是否推荐 | 理由 |
|---|---|---|
| 个人换机迁移 | ✅ 推荐JSON | 一次导出，配置全量还原 |
| Git公开仓库跟踪 | ✅ 推荐Plain | 体积小，无隐私字段 |
| 团队敏感节点共享 | ⚠️ 不推荐明文 | JSON含出口IP，易泄露资产 |
| 7.1版客户端还原 | ❌ 不兼容 | 字段缺失，需Plain过渡 |
最佳实践检查表
- 每月固定一天执行「JSON导出+Time Machine」双备份，防止节点失效时无参照。
- 把Plain备份纳入Git私有仓库，变更Diff一目了然，方便回滚到上周节点组合。
- 导出后立即用
shasum -a 256生成校验值，写入同名.sha256文件，恢复前核对完整性。 - 团队共享请使用加密压缩（zip -e），并通过企业IM二次验证传输，避免IP资产泄露。
- 跨大版本迁移时，先用测试机验证JSON可正常导入，确认无误再覆盖主力机。
FAQ（必须使用FAQPage Schema）
导出后的JSON能否直接用于Windows端？
可以，但路径与进程分流规则仅Mac端识别，Windows会跳过不支持的字段并给出提示，不影响核心节点列表。
备份里会保存账号密码吗？
不会。导出文件仅含节点地址、端口、负载及标签，登录态由本地钥匙串另行保护，请妥善保管主账号密码。
导入后延迟变高，是备份损坏吗？
大概率不是。备份只还原节点地址，实时延迟受网络波动影响，建议手动执行「延迟测试」让客户端重新选路。
总结与下一步行动
快连Mac端导出节点列表做离线备份，本质是把「本地缓存」转储为可版本化的文本文件，既能在换机时一键还原，也能通过Plain格式与第三方工具对接。核心决策只有两条：JSON用于全配置迁移，Plain用于轻量跟踪；执行步骤不超过三次点击，却能在系统崩溃或版本回退时节省数十分钟的手动重建时间。
现在就打开kuailian，按本文路径生成第一份JSON备份，并用Time Machine或Git私有仓库存档；下个月需要换机或升级系统时，你会感谢今天留下的60秒操作。
📺 相关视频教程
微信監控實錘，24小時採集數據，并上報😰｜Reaction Video