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

功能定位：为什么需要把节点列表留在本地？

在快连（QuickLink privacy tool）里，节点列表就是你能调用的全部加速出口。官方虽提供云端同步，一旦触发「账号风控」「客户端重装」或「出差网络隔离」，本地若无备份，就得重新测速、重新收藏，业务流随时中断。把节点列表导出到本地，相当于给自己留一条“可审计、可回滚”的后路。

自 2026-02-28 发布的 v10.4.2「量子通道」版起，快连把“节点库”与“个人收藏”拆分存储：前者是官方全球 1200+ 节点的完整镜像，后者只保留你手动星标或 AI 常用推荐的几十条。导出功能仅针对后者，官方解释是“降低分发被滥用风险”。若你执意一次性倒出 1200 条，需要借助额外脚本，这已超出官方支持范围，后文给出经验性观察与验证步骤。

版本差异：v10.3 以前与 v10.4 之后的底层变化

v10.3 及更早版本把收藏节点以 JSON 明文存于安装目录的 user_data.json，复制即可。v10.4 之后引入「本地 Keystore + 云端双因子」混合加密，收藏节点被二次打包成 .qnpx 二进制，路径也迁进系统级沙盒：Android 位于 /Android/data/com.quicklink/files/Nodes，Windows 在 %LOCALAPPDATA%\QuickLink\Nodes。

变化带来两条直接后果：①手动复制文件后，跨设备恢复必须输入原账号 Token，否则无法解码；②旧版 JSON 导入新版会被直接拒绝，提示「格式已过期」。因此，导出前务必先确认客户端主版本号，再决定用「官方导出按钮」还是「手动文件复制」。

平台路径：Android、iOS、Windows、macOS 的最短入口

Android（以原生系统 13 为例）

打开快连，点击右下角「我的」→「节点管理」。
右上角「⋮」→「导出收藏」→选择「保存到本地文件」。
系统弹出 Storage Access Framework，默认保存在 Download/QuickLinkNodes/，文件名 QuickLink_Nodes_年月日.qnpx。

导出完成后，文件管理器会立即定位到该目录，可直接分享至加密网盘或 U 盘。

iOS（17.x 实测）

底部栏「我的」→「节点管理」→右上角「导出」。
iOS 生成 .qnpx 并唤起系统分享表，可「保存到文件」→「On My iPhone」→「QuickLink」文件夹；若目录缺失，系统会提示自动创建。
开启 iCloud Drive 后，同一目录实时同步到 macOS Finder 侧边栏，方便后续编辑。

Windows（10/11 22H2+）

主界面左上角「≡」→「工具」→「导出节点」。
弹窗默认定位到 %USERPROFILE%\Documents\QuickLinkExport\，可改路径。
若客户端以管理员身份运行，导出后可一键「打开所在文件夹」；非管理员时该按钮置灰，需手动进入目录。

macOS（13+）

菜单栏「QuickLink」→「File」→「Export Favorite Nodes」。
系统提示「是否包含 WireGuard 私钥」，默认不勾；若打算离线导入回同一客户端可勾选，但文件会标记为「敏感」，切勿上传网盘。
保存路径建议放在 ~/Documents/QuickLinkBackup/，Time Machine 会自动包含。

失败分支与回退：遇到「导出按钮灰色」怎么办？

经验性观察：当账号处于「风控审核」或「Token 过期」状态，客户端会禁用本地导出，防止用户借备份绕过限制。按钮呈灰色，悬浮提示「账号验证中，请稍后再试」。解决路径：①「我的→设置→账号安全」重新验证邮箱或手机；②已验证仍灰色，退出账号并重新登录，强制拉取最新权限表；③极端情况下提交工单，平均等待 2 小时解锁。

若卸载前忘记导出，而旧版 JSON 仍在，可尝试「导入旧格式」实验性功能（Windows/macOS v10.4.2+）。入口在「工具→高级→导入旧版收藏」，成功率并非 100%，官方注明「仅做尽力兼容」。导入失败就只能手动重新收藏常用节点。

手动全量节点备份：突破「仅收藏」限制的可复现方法

官方导出仅含收藏节点。若你确实需要 1200+ 节点的完整离线快照（如企业内部合规审计），可按以下步骤操作，但需自行承担合规风险：

Windows/macOS 端完全退出客户端，确保后台无 QuickLinkService 进程。
进入安装目录 resources\app\assets\db\，复制 node_cache.db（SQLite 格式）。
用 DB Browser for SQLite 打开，表「nodes」即完整节点列表，包含 IP、端口、协议、延迟、负载；导出为 CSV 即可。

注意：node_cache.db 受 AES-256 加密，密钥与本地 Token 绑定。Token 失效时，文件打开即乱码。此时需保持客户端在线，利用内存 Dump 提取密钥——该操作已超出普通用户范畴，建议仅作技术研究。

经验性观察：v10.4.2 每 6 小时整点重写 node_cache.db，若备份落在重写窗口，可能出现「零字节」临时文件。验证：备份后查看文件大小 >1 MB 即成功；若接近 0 KB，等 10 分钟再复制。

兼容性对照表：导出的 .qnpx 能否跨版本、跨平台导入？

场景	是否支持	备注
v10.4.x → v10.4.x（同平台）	✅	Token 一致即可无缝导入
v10.4.x → v10.3.x（高→低）	❌	客户端提示「格式版本过高」
Android → iOS	✅	需用同一 Token 登录
Windows → macOS	✅	私钥选项仅 WG 节点有效
含私钥 .qnpx → 不含私钥客户端	⚠️	可导入但 WG 节点需重新握手，延迟略升

风险控制：备份文件里到底存了什么？

官方文档披露，.qnpx 内包含：节点域名、IP、端口、协议类型、收藏夹分组、WG 公钥与可选私钥。不包含：账号 Token、历史连接日志、流量统计。换言之，他人拿到 .qnpx 只能知道你常用哪些服务器，却无法直接冒用你的账号。

然而，若在公司电脑备份后又把文件扔进公有云同步盘，IT 部门仍可读取节点 IP 列表，从而推测你访问了哪些地区服务。对合规要求高的场景，建议：①导出后立即用 7-Zip 加密压缩，密码长度 ≥12 位；②文件名避免含“QuickLink”“节点”等关键词，可改为「ProjectX_20260325.qnp」；③长期归档选离线硬盘而非网盘。

与第三方自动化工具协同：Git、Rclone、NAS 定时同步

经验性观察：技术社区常把 .qnpx 纳入私有 Git 仓库，每次导出自动 commit，用 git-diff 即可追踪收藏节点变更历史。步骤：①新建空仓库，.gitignore 排除 *.db *.log；②用 inotifywait 监听导出目录，检测到新文件即 git add & push；③在 NAS（群晖、TrueNAS）设 Webhook，收到 push 后自动拉取并二次备份到外部硬盘。

若用 Rclone 同步到加密云，建议加「--backup-dir」参数保留旧版本，防止误覆盖。示例命令（路径请按实际填写）：rclone copy /home/user/QuickLinkBackup cryptRemote:QuickLink --backup-dir cryptRemote:archive/`date +%F`

故障排查：导入时报「节点已失效」或「签名不一致」

现象：导入后客户端显示红色盾牌，提示「节点已失效」。可能原因：①节点下线或 IP 更换；②旧版 .qnpx 内 WG 公钥与服务器端不再匹配；③系统时间误差 >5 分钟，导致 TLS 证书校验失败。

处置：先点「刷新节点列表」拉取官方最新状态；若仍失败，进入「节点管理」→「批量测速」，把延迟显示为「-1」的条目删除后重新收藏；若大批量失效，直接重新导出最新收藏，而非继续导入旧备份。

适用/不适用场景清单

✅ 个人用户换机、双系统、防客户端崩溃
✅ 小团队 3~5 人共享同一批冷门游戏节点，减少重复测速
✅ 合规审计需留存「曾用出口」清单，配合时间戳日志
❌ 想靠备份文件实现「共享账号」绕过设备限制——Token 仍受官方六设备上限约束
❌ 试图修改 .qnpx 解锁未订阅节点——文件带 HMAC 签名，篡改后无法通过校验

最佳实践速查表

每月固定一天导出，文件名用「QL_nodes_年月日.qnpx」。
导出后立即用 SHA-256 计算校验值，写入同目录 txt，方便日后比对完整性。
双备份：本地加密硬盘一份，离线 U 盘一份，避免单点故障。
跨版本升级前，先导出再升级；升级完成确认无误后，把旧备份移入「归档」文件夹。
任何含私钥的 .qnpx 禁止上公有云；如需团队共享，用内网 Nextcloud+SSL。

FAQ（结构化数据）

导出的 .qnpx 会过期吗？

文件本身无时间戳限制，但节点可能下线。建议每次使用前执行「批量测速」清理失效条目。

能否把 .qnpx 转成 CSV 做审计？

官方无转换工具，可借助 SQLite 导出 node_cache.db 后自行处理；.qnpx 为加密容器，无法直接解析。

备份文件泄露会被溯源吗？

文件不含账号 Token 与日志，仅能看出节点列表；但仍建议加密存放，防止被推测业务区域。

iOS「文件」里找不到导出目录？

请确认快连拥有「文件与文件夹」权限；若仍缺失，重启设备后首次导出会强制创建目录。

能否定时自动导出？

官方未开放 API 或计划任务；如需自动化，可用脚本点击窗口，但属于非官方支持，可能随版本失效。

总结与下一步行动

快连的节点导出并不复杂，但版本差异、加密格式与合规要求让“备份”这件事多了几条隐藏分支。核心逻辑只有一句：收藏节点才是官方允许你自由迁移的数据；全量节点库受加密与签名保护，强行导出需评估风险。按「每月导出→双备份→校验→加密」四步执行，即可在换机、升级、风控隔离等场景把恢复时间从数小时压缩到几分钟。

下一步，你可以：①把最佳实践写进团队 SOP，指定专人每月检查备份完整性；②若节点列表大于 50 条，可写脚本调用批量测速 API（官方未公开，需抓包）做自动化清洗；③关注 v10.4.3 更新日志，观察量子通道夜间掉速与 AI-Route 绕路问题是否缓解，再决定是否升级。