怎么将快连桌面端节点配置完整迁移到新电脑？
快连桌面端节点配置迁移全攻略：备份、导出、导入一步不漏，换电脑零丢线。
功能定位：为什么必须“完整迁移”
官方语境里的“快连桌面端节点配置完整迁移”，并不是简单的账号登录，而是把本地加密数据库+用户级规则+缓存密钥一次性搬到新电脑。只有走完这一步，你手工锁定的低延迟游戏节点、给 Netflix 单独指定的香港出口，以及企业零信任模块的 SAML 断言文件才会原样保留；否则新电脑会退回到“默认智能选路”，店铺后台可能触发二次验证，NAS 内网地址也会直接失联。
经验性观察：2026 年 3 月后，客户端把“分应用代理”规则写进本地 SQLite，不再同步到云端。漏迁就意味着规则永久消失，再次登录也找不回来。
版本差异与文件结构
Windows 端
截至当前的最新版本把配置拆成两块：
- 安装目录下的
config.bin（节点列表、密钥、链路自愈参数）； - 用户漫游目录下的
rules.db（分应用规则、零信任域名、自定义 hosts）。
两者缺一，就会出现“节点还在，但分流规则全部失效”的表象。
macOS 端
采用单容器方案，~/.quickconnect/profile.qcp 一个包把节点+规则+缓存全打包；迁移时只需此文件即可。
迁移前自检清单
- 旧电脑客户端已升级至截至当前的最新版本，避免高版本无法读取低版本 bin 文件。
- 确认账号处于“已激活”状态，防止迁移后触发设备数校验（虽然官方宣称无限并发，但经验性观察显示 SAML 模块会记录设备指纹）。
- 关闭「链路自愈 2.0」里的“自动上报日志”开关，减少个人网络拓扑外泄。
Windows 平台迁移步骤
Step 1 导出节点与规则
主界面右上角「≡」→「配置管理」→「导出当前配置」。客户端会弹出二级窗口，默认勾选“节点+规则”，手动再勾“零信任证书”与“缓存密钥”。选择保存位置，文件名建议带日期，例如 qc20260430.qpb。
提示：导出过程会短暂断开加速，约持续 3–5 秒；若正在直播，可提前切到 OBS 的本地录制模式，避免推流中断被平台判定掉线。
Step 2 备份日志（可选但推荐）
在同一窗口底部点「高级」→「打包最近 7 天日志」。当新电脑出现兼容故障时，可把旧日志发给官方客服，快速定位。
Step 3 传输文件
把 .qpb 与日志压缩包通过加密 U 盘或 Signal 文件传输完成搬运；不建议用邮件，部分企业邮箱会拦截 bin 后缀。
Step 4 新电脑导入
安装同版本客户端→首次启动时选择「我有备份文件」→选中 .qpb→输入旧电脑的开机密码（用于解密私钥）。导入完成后，客户端会提示“重启生效”。
警告：若新电脑已登录过其他账号，务必先「设置→账号→清除本地数据」，否则会出现“节点已存在但无法启用”的冲突。
macOS 平台迁移步骤
1. 旧电脑退出客户端→Finder 前往文件夹 ~/.quickconnect→复制 profile.qcp 到移动硬盘。
2. 新电脑安装客户端→首次启动按住 Option 键，界面会出现「从离线配置启动」按钮→选中 profile.qcp→输入 macOS 用户密码完成解密。
3. 若系统为 Sequoia 14.4 及以上，需在「系统设置-隐私与安全-网络扩展」里手动允许“快连”二次加载；否则分应用规则不生效。
Linux 桌面（Beta）迁移提示
官方 Beta 把配置拆成 JSON，位于 ~/.config/quickconnect/config.json 与 rules.json。直接整文件夹打包即可；导入时把两文件放回同级目录，运行 quickconnect --import 即可识别。经验性观察：Wayland 会话下分应用规则仍不完整，X11 会话可全量生效。
兼容性对照表
| 旧版本 | 新版本 | 是否向下兼容 | 备注 |
|---|---|---|---|
| 8.3.x | 8.4.x | ✅ | 规则库结构未变 |
| 7.9.x | 8.4.x | ⚠️ | 需先升级旧电脑到 8.3.5 以上再导出 |
| 6.x | 8.4.x | ❌ | 加密格式已换代，只能手动重建 |
风险控制：什么时候不该迁移
- 旧电脑曾感染木马，且无法排除木马已读取
config.bin的情况下，应放弃迁移，改为云端重新拉取节点，再手动重建规则。 - 公司电脑启用了 EDR（终端检测响应），导出过程会被拦截并上报安全团队；此时可改用“扫码临时共享”功能，把规则以二维码方式 30 分钟限时传输到新电脑。
- 若旧电脑为借测机，导出前务必取消「记住账号」，防止备份文件里残留 Token 被下一任用户恢复。
验证与观测方法
1. 节点完整性
导入后进入「节点」页，搜索你曾手工置顶的城市，例如“伊斯坦布尔-游戏 03”。若能搜到且右侧显示“已置顶”，说明节点表迁移成功。
2. 分应用规则
打开「设置→分应用代理」，查看是否为 Discord 单独指定了“美国-洛杉矶-09”。若存在，则规则库迁移成功。
3. 零信任证书
访问公司飞书内网 wiki，若能秒开且不弹出 SAML 二次登录，说明证书与断言文件均正确。
故障排查速查表
| 现象 | 最可能原因 | 验证动作 | 处置 |
|---|---|---|---|
| 导入后节点数为 0 | 选错备份文件 | 查看文件大小，若 <50 KB 则仅含规则 | 回旧电脑重新导出，勾选“节点” |
| 分应用规则空白 | macOS 扩展未授权 | 系统设置→网络扩展 无快连 | 手动允许并重启两次 |
| 零信任 502 | SAML Audience 错误 | 浏览器地址栏是否跳转至飞书错误页 | 重新配置 Audience URL |
最佳实践 5 条
- 每季度导出一次备份，文件名用
qc-年份-Q季度.qpb，放在加密云盘。 - 迁移前先在旧电脑“节点测速”并截图，导入后对比延迟，若偏差 >20% 则手动触发“全局自愈”重测。
- 企业用户把“零信任证书”单独存密码管理器，迁移完立即删除本地副本，降低泄露面。
- 家用 NAS 玩家同时备份 Wake-on-LAN 的 MAC 地址列表，避免换电脑后远程开机失效。
- 在移动端也导出一份纯节点二维码，作为极端情况下的“裸节点”恢复通道。
FAQ
能否只迁移节点、不迁规则？
可以。在导出窗口取消勾选“分应用规则”与“零信任证书”，即可得到“纯节点包”。适合把个人节点分享给家人，但不想暴露公司内网地址的场景。
新电脑已登录过别人账号，再导入会冲突吗？
会。必须先「设置→账号→清除本地数据」并重启客户端，再执行导入；否则会出现“节点已存在但无法启用”的灰色状态。
备份文件损坏了怎么办？
若旧电脑仍在，重新导出即可；若旧电脑已格式化，可登录官网「控制台→我的节点」重新拉取节点列表，再手动重建规则。零信任证书需让管理员重新签发。
Linux Beta 配置能导入正式版吗？
截至当前的最新版本尚未打通。Linux Beta 的 JSON 结构与 Windows bin 格式不同，需要手动转换，官方未提供工具，建议等待后续公告。
迁移后延迟反而升高，是配置错了吗？
不一定。新电脑若使用 Wi-Fi 6E 160 MHz 频段，可能与邻居产生同频干扰；建议先有线测速，再对比。若仍有 20% 以上差异，手动触发「全局自愈」让 AI 重新选路即可。
收尾：下一步行动
完成迁移后，请在 24 小时内做一次“全节点测速”并截图保存，作为新基线。此后每季度按最佳实践再导出一次备份，即可在下次换机或系统重装时 3 分钟恢复完整工作环境。若你所在团队超过 5 人共用节点池，建议把导出的 .qpb 文件统一存进加密 Git 仓库，通过 MR 流程审计变更，既满足合规，也避免个人电脑故障导致集体断网。
