怎么把快连Windows节点配置完整迁移到另一台电脑？

把快连Windows节点配置完整迁移到另一台电脑

核心关键词“快连Windows节点配置迁移”在2026年v11.2.0之后依旧依赖本地SQLite+JSON混合存储，官方尚未提供云端一键同步。于是“换机不丢节点”成了用户最集中的痛点：手动重加3200+线路显然不现实，而直接复制文件夹又常因路径、权限、加密令牌差异导致启动时报“配置损坏”。本文用“问题—约束—解法”的视角，给出一条可复现、可回退、跨版本兼容的迁移路线，兼顾新手“点点鼠标”与进阶“脚本批量”两种需求。

功能定位：迁移到底搬走了什么

快连Windows客户端把“节点列表、分组、测速历史、分流规则、API令牌”拆成三块存放：

节点与分组：%AppData%\QuickLink\data\nodes.db（SQLite），表node、group、latency。
分流与进程规则：同目录下rules.json，Split-Tunneling 3.0的各条策略以JSON数组保存。
登录令牌与设备指纹：encrypted_token.bin与device_id.txt，加密密钥绑定主板UUID，直接复制会导致“令牌失效”而退回登录页。

因此“完整迁移”≠全盘复制，而是“搬列表、搬规则、不搬令牌”。

前置检查：版本、权限与网络

经验性观察：v11.1→v11.2数据库表结构新增column starlink_udp，老版本若回滚会报“table mismatch”。操作前请保证新旧电脑均升级至“截至当前的最新版本”。

警告

若源电脑已启用“AI节点医生”自动迁移，请在设置-诊断-关闭“自动迁移”，防止迁到一半被后台切节点，导致latency表写入冲突。

迁移路线总览

官方UI暂未提供“导出配置”按钮，因此采用“官方CLI+手动补全”双通道：

新手通道：quickctl export+import，两条命令完成节点+规则搬迁，令牌重新登录即可。
进阶通道：PowerShell脚本调用SQLite3.exe做差异化合并，适合IT管理员一次性推送500+设备。

通道A：quickctl三步法

在源电脑以管理员身份打开CMD，执行
quickctl export --with-rules -o d:\ql_backup.zip
该命令会跳过encrypted_token.bin，仅打包nodes.db与rules.json。
把ql_backup.zip拷到目标电脑，安装同版本客户端后不要启动，先执行
quickctl import d:\ql_backup.zip --skip-token
启动快连，输入账号密码重新获取令牌；启动后节点列表、分组、测速历史均在。

通道B：SQLite合并法

当企业后台已推送部分默认节点，直接import会覆盖现有数据，此时可用“合并”而非“覆盖”。步骤如下：

目标电脑安装SQLite3.exe（官方下载页提供绿色包）。
把源电脑nodes.db重命名为nodes_old.db，拷贝到目标电脑。
执行下列SQL完成差分插入：
ATTACH 'nodes_old.db' AS old; INSERT OR IGNORE INTO node SELECT * FROM old.node; INSERT OR IGNORE INTO group SELECT * FROM old.group; DETACH old;
rules.json手动diff合并后覆盖，重启客户端即可。

平台差异与路径速查

平台	配置文件根目录	CLI名称
Windows 10/11	%AppData%\QuickLink	quickctl.exe
macOS	~/Library/Application Support/QuickLink	quickctl
Linux	~/.config/QuickLink	quickctl

注意：Windows商店版与官网EXE版路径不同，商店版在
%LocalAppData%\Packages\QuickLinkWin...，若找不到nodes.db，请在资源管理器地址栏直接输入%AppData%\QuickLink回车即可。

常见失败分支与回退

现象：import时报“database is malformed”。原因：源电脑未正常退出，SQLite处于WAL模式且-wal文件缺失。解决：在源电脑重新打开客户端再正常退出，确保-wal与-shm被合并。
现象：启动后节点0延迟且无法连接。原因：encrypted_token.bin被误搬，客户端校验失败后拒绝刷新。解决：删除encrypted_token.bin与device_id.txt，重新登录。
现象：rules.json里自定义的“域名关键词”失效。原因：新旧电脑区域格式不同导致编码BOM冲突。解决：用VS Code把rules.json转为“UTF-8无BOM”后重新导入。

验证与观测方法

迁移后请按以下顺序验证，确保“零丢节点、零丢规则”：

打开节点列表，检查分组名称与星标数量是否与源电脑一致。
进入“分流中心”，随机抽查三条应用规则，确认进程名与路径匹配。
ping任意海外游戏节点，观察latency列是否出现历史数据（说明nodes.db的latency表已恢复）。
在设置-诊断-导出日志，确认无“token mismatch”或“database corrupted”关键字。

适用/不适用场景清单

适用：个人换机、公司IT批量发放笔记本、电竞酒店镜像模板、实验室还原快照。

不适用：①已开启“企业控制台锁定”的设备——后台策略会定时覆盖本地节点库；②使用侧载修改版客户端（如去广告补丁）——数据库schema被改动，import直接报错；③需要保留“临时令牌”供无头路由器自动拨号——因令牌与主板UUID绑定，迁后必失效。

最佳实践速查表

提示

把以下命令保存为migrate.bat，双击即可备份到U盘根目录，减少培训成本：
@echo off quickctl export --with-rules -o %~d0\ql_backup_%date:~0,4%%date:~5,2%%date:~8,2%.zip echo 备份完成，文件名：ql_backup_%date:~0,4%%date:~5,2%%date:~8,2%.zip

FAQ（结构化数据）

迁移后是否必须重新登录？

是的。encrypted_token.bin与主板UUID绑定，搬过去会校验失败，重新输入账号密码即可，节点数据不会丢失。

可以把备份文件放到NAS做自动同步吗？

可以，但务必排除encrypted_token.bin与device_id.txt，否则多设备同时在线会触发“令牌抢占”导致频繁掉线。

为何import后部分节点延迟显示为0？

latency表虽迁移，但首次启动需重新测速；点击“节点测速”按钮或等待后台静默扫描两分钟即可恢复。

收尾：下一步行动建议

完成迁移后，建议立即在目标电脑做一次“设置-诊断-备份”，把干净状态再存一份快照；同时把quickctl加入系统PATH，后续换机只需两行命令。若你负责企业批量部署，可把SQLite合并脚本集成到MDT/SCCM任务序列，实现新机开箱自动拉取最新节点库，真正做到“配置跟着账号走，设备只是壳”。