快连Mac端如何手动降级并保留节点列表？
功能定位与版本演进
快连 Mac 端的手动降级，核心思路是把「用户配置」与「程序本体」彻底分离：先完整导出节点与偏好，再回退到旧版主程序，最后把配置写回。2026 年 4 月发布的最新版在签名策略与沙箱路径上做了收紧，直接覆盖安装会触发「配置不兼容」弹窗，因此必须走「卸载→重装→导入」三步曲，而非简单的拖拽替换。
前置检查：哪些数据必须留
1. 节点列表（Servers.plist）
位于 ~/Library/Containers/com.kuailian.mac/Data/Documents/，文件名固定为 Servers.plist，包含地址、端口、加密方式、备注。经验性观察：若此文件缺失，启动后会自动拉取云端默认节点，但个人备注与分组会被重置。
2. 用户偏好（Preferences.xml）
同目录下的 Preferences.xml 保存了自动更新、开机自启、通知开关等选项。降级后，新版不再识别的字段会被静默丢弃，不会报错，却可能导致「自动更新」默认开启，从而再次悄悄升到新版。
3. 订阅缓存（Subscription.cache）
若你用过「订阅地址」批量拉取节点，缓存文件会存最后一次响应。降级后若订阅地址失效，可手动导入该缓存快速恢复，无需重新请求。
提示：用 Time Machine 备份上述三文件即可在 30 秒内完成「快照」，比整机回滚轻量得多。
方案 A：图形界面导出法（新手友好）
步骤 1 导出节点
打开快连 → 顶部菜单栏「File」→「Export Servers…」→ 选择「Export as plist」。此操作会把当前列表与分组信息打包成一份 Servers.plist，默认落到 Downloads。
步骤 2 备份偏好
「Kuailian」→「Settings」→「Advanced」→「Export Config」，生成 Preferences.xml。若界面无此按钮，可手动复制上述路径下的文件。
步骤 3 卸载主程序
把「Kuailian.app」拖入废纸篓并清空；随后打开终端执行
rm -rf ~/Library/Containers/com.kuailian.mac
确保沙箱目录被移除，否则旧版启动时会读到新版残留配置，导致闪退。
步骤 4 安装旧版
从官网归档页下载「截至当前的最新旧版 dmg」，双击挂载后把 Kuailian.app 拖进 Applications。首次启动会提示「从互联网下载的应用」，允许即可。
步骤 5 导入配置
「File」→「Import Servers…」选中步骤 1 的 Servers.plist；随后「Settings」→「Advanced」→「Import Config」选中 Preferences.xml。重启客户端，确认节点与开关状态一致即完成。
警告：若旧版主程序版本号低于 2025Q4，导入后可能出现「加密方式不被支持」提示，需手动把该节点改为 aes-256-gcm 后再保存。
方案 B：命令行快照法（进阶可脚本化）
对需要批量维护多台 Mac 的 IT 管理员，可用一条命令完成「导出+压缩+时间戳」：
tar -czf kuailian_$(date +%Y%m%d).tgz -C ~ Library/Containers/com.kuailian.mac
降级后反向解压：
tar -xzf kuailian_20260405.tgz -C ~
经验性观察：tar 保留扩展属性，比手动复制 plist 更不容易出现「文件已损坏」弹窗。
常见失败分支与回退
1. 启动提示「配置损坏」
原因：新版生成的 plist 用了旧版不识别的字段（如 <key>UDPoverTCP</key>）。处置：用文本编辑器删除未知键，或只导入节点地址、端口、密码三要素，其余手工补填。
2. 节点列表空白但订阅地址仍在
原因：旧版默认关闭「订阅自动更新」。在「Settings」→「Subscription」手动点击「Update Now」即可拉回节点。
3. 系统拦截内核扩展
macOS 15 以后需要用户手动「允许」内核扩展。若降级后无法联网，请依次打开「System Settings」→「Privacy & Security」→「Allow developer『Kuailian Technology』software」。重启生效。
是否值得降级？三条判断标准
- 速度指标：在同等网络下，旧版握手时延比新版高 100 ms 以上，且持续 3 天可复现。
- 兼容性：新版与常驻安全软件冲突，导致 CPU 占用长期在 30 % 以上（活动监视器可查）。
- 功能冗余：你只用 aes-256-gcm 节点，不需要新版推出的「Smart Route」模块，却因此被强制后台更新。
若三项都不满足，建议留在新版并关闭自动更新，避免反复折腾。
验证与观测方法
降级完成后，用以下指标验证是否回到预期状态：
- 节点数量：导入前后对比，差值应为 0。
- 延迟中位数：用客户端内置「Latency Test」连续测 5 次，取中位数，与降级前记录对比，波动在 ±10 % 内属正常。
- CPU 占用：连接状态下，客户端进程 30 秒平均占用应 <5 %（M 系列芯片）。
若任一项偏离预期，回滚到备份包即可，全程不超过 2 分钟。
与第三方工具的协同边界
部分用户会用「自动切换网络位置」的脚本配合快连。降级后需检查脚本里是否调用了新版才有的命令行参数（如 --smart-route）。旧版不识别的参数会直接导致启动失败。建议脚本里只保留 --connect-by-name 与 --disconnect 两项，兼容性最好。
适用/不适用场景清单
| 场景 | 是否推荐降级 | 原因 |
|---|---|---|
| 个人笔记本，节点数 <30 | ✅ 推荐 | 备份恢复简单，收益明显 |
| 公司 MDM 统一管理，节点数 >200 | ❌ 不推荐 | 大规模回退需重新签名分发，成本高 |
| 需使用新版「Smart Route」功能 | ❌ 不适用 | 旧版无此模块，降级即丢失 |
最佳实践速查表
- 每次大版本升级前，先 tar 快照。
- 关闭「Auto Update」开关，防止后台静默升级。
- 导出 plist 后，用文本编辑器确认密码字段已加密，避免明文泄露。
- 降级后 24 小时内不清理废纸篓，确保可回滚。
- 把订阅地址另存为书签，即使本地缓存丢失也能一键恢复。
FAQ（结构化数据）
降级后订阅地址失效怎么办？
手动复制订阅链接→客户端「Settings」→「Subscription」→「Add」→粘贴→Update Now；若链接已下线，需联系提供方更换。
可以只降级主程序而不备份吗？
可以，但首次启动会强制拉取云端默认节点，个人备注与分组全部丢失；若节点数少于 10 条可接受，否则不建议。
如何阻止 macOS 再次自动升级快连？
在「System Settings」→「General」→「Login Items & Extensions」→「Background」里取消勾选 Kuailian 的「Auto Update Helper」；同时在客户端「Settings」→「General」关闭「Check for updates automatically」。
收尾：下一步行动
读完本文，你已掌握快连 Mac 端手动降级并保留节点列表的完整链路：备份→卸载→重装→验证。立刻执行一次 tar 快照，把订阅地址另存为书签，再关闭自动更新，即可在 10 分钟内完成可控降级。未来若再遇到「版本更新后速度变慢」或「功能冗余」问题，先对照「三条判断标准」评估，再决定是否回退，避免无效折腾。
