功能定位：为什么需要“一键导出全部节点”
在快连（QuickLink）的迭代里，“节点配置本地备份”最早只是单节点二维码，用于手动分享到另一台手机。随着家庭套餐与路由器插件普及，用户手里往往握着几十条专线节点，逐一手动显然不可行。2026 年 3 月 v6.8.2 起，官方把「导出全部节点」做成独立入口，一次性生成加密归档，方便整机迁移、固件刷机或团队内部分发。核心关键词“快连一键导出全部节点配置”即指此流程。
该功能解决的痛点很明确：①批量备份，防节点被误删；②离线存档，合规审计时可用；③换机/刷机零配置恢复。它与「单节点分享」的边界在于：后者仅输出一条 WireGuard/Hysteria2 链接，而前者把所有节点、分流规则、自建专线 IP、备注、甚至能耗仪表盘开关都打成一个 .qbx 文件（QuickLink Bundle v2 格式）。
版本演进与兼容性速览
截至当前的最新版本（v6.8.2a）起，导出逻辑已稳定；但 v6.7 之前仅支持「节点列表 JSON」+「手动二维码」两步，且不含分流规则。若你仍在 v6.7 或更早，导出后仍需手动备份「规则库」文件夹，否则恢复时会丢失 3000+ 条分流。官方热修 6.8.2a 同时修复了 Mac M3 内存泄漏，因此建议先升级再操作，避免归档途中客户端崩溃。
向下兼容方面，.qbx 文件可被 v6.8.0 及以上版本直接导入；若目标设备停留在 v6.7，会提示「格式不匹配」，此时只能回退到「节点 JSON」方式，或先把目标端升级。经验性观察：Windows 端回退到 6.7.9 后，导入速度明显放慢，且能耗仪表盘数据会丢失。
桌面端：Windows / macOS 最短路径
Windows 10/11
- 主界面右上角 ⋮ → 设置 → 高级 → 配置管理 → 导出全部节点。
- 在弹窗里勾选「包含分流规则」「包含能耗仪表盘数据」→ 选择保存位置。
- 客户端会提示「正在生成 .qbx，请勿关闭窗口」，数十秒内完成。
若你启用了「防火墙兼容性模式」，导出前最好临时关闭，否则可能出现 handshake timeout 导致归档失败。失败日志可在「安装目录\logs\export.log」查看（路径因版本而异，请以实际为准）。
macOS (Intel & Apple Silicon)
- 顶部菜单栏 QuickLink → Preferences → Advanced → Export All Nodes。
- 同样勾选可选组件 → 选择存储路径。
- 归档完成后自动打开 Finder 并高亮文件，方便直接 AirDrop 到手机。
提示：M 系列芯片在 v6.8.2a 后已修复内存泄漏，若导出时风扇狂转，请确认是否更新到该热修版。
移动端：Android / iOS 差异
Android 12 及以上
- 首页 → 我的 → 配置管理 → 导出全部节点。
- 系统会弹出「允许访问文件」授权，确认后选择保存到 Download 或自定义文件夹。
- 导出成功可直接通过系统分享面板发送到 Telegram、邮件或 NAS。
经验性观察：部分国产 ROM 会强制清理 .qbx 后缀，导致文件变成「未知格式」。可在导出完成后立即重命名为「xxx.qbx.bak」，再传输即可绕过。
iOS 19.4
- 底部导航 我的 → 设置 → 高级 → 导出全部节点。
- iOS 会走系统 Files 接口，默认保存在「QuickLink」文件夹；若开启 iCloud Drive，可即时同步到 Mac。
- 文件生成后支持 AirDrop、微信、钉钉等方式分享，但微信会压缩大于 100 MB 的归档，建议分段或使用 AirDrop。
警告：iOS TestFlight 公测版 6.8.3b 曾出现导出 0 字节文件，官方已修复；若仍遇到，请回退到 App Store 正式版。
路由器插件：OpenWRT / 梅林
快连官方开源了 luci-app-quicklink，可在「服务 → QuickLink → 配置管理 → 导出全部节点」一键下载 .qbx。因路由器存储空间小，默认不勾选「能耗仪表盘」与「日志缓存」，若强行勾选可能出现「磁盘已满」导致 Web 界面卡死。经验性观察：AX6000 级别路由器导出 200+ 节点所需时间约一分钟，指示灯常红属正常，请勿重启。
梅林固件路径类似：Tools → QuickLink → Export All Nodes。注意，梅林导出文件默认放在 /tmp/mnt/sda1/，重启会丢失，需及时拷贝到 U 盘或 Samba 共享盘。
例外与取舍：什么不会被导出
- 账号令牌：出于零日志策略，登录态与订阅密钥不会被写入归档，恢复后需重新扫码或输入订阅地址。
- 本地缓存的 IPLC 专线 IP：若节点被官方下线，即使导入也无法连接，需等待后台刷新。
- 自定义 hosts：若你在「分流设置」里手动添加了 hosts 条目，需要单独备份「安装目录\config\user_hosts.json」。
- 能耗仪表盘历史数据：仅保存近 7 天，若导出文件在一周后导入，历史曲线会被清零。
因此，若你是团队管理员，需要把「节点 + 规则 + 本地 hosts」完整克隆给新成员，务必额外复制 user_hosts.json，并在导入后让成员自行更新订阅令牌。
与第三方工具的协同边界
.qbx 本质是 ZIP 改后缀，内含 nodes.json、rules.db、meta.ini 三个文件。你可以用任何归档工具打开并二次加工，例如把节点批量改名、删除延迟大于 300 ms 的条目，再打包回去。但请注意：
- 若修改后导致 JSON 语法错误，客户端会拒绝导入且不会给出具体行号，需自行校验。
- 不要尝试把 .qbx 直接改回 .zip 后发给第三方归档机器人，ZIP 注释段含有校验哈希，改动后会被判定为「篡改」。
经验性观察：有用户用 Python 脚本把 200 个节点按国家分组后重新打包，导入速度提升约 30%，但官方并不承诺长期兼容脚本二次打包，升级前请留原始文件。
故障排查：导出失败怎么办
| 现象 | 可能原因 | 验证方法 | 处置 |
|---|---|---|---|
| 卡在 0% | 节点数过多 & 内存泄漏 | 任务管理器看内存占用是否飙升 | 升级到 v6.8.2a 或重启客户端 |
| 提示“文件系统拒绝访问” | 国产安卓 ROM 禁止写入根目录 | 换保存到 Download 文件夹再试 | 授予「所有文件访问」权限 |
| 导出后文件 0 B | iOS TestFlight 旧 beta | 设置 → 通用 → privacy tool 与设备管理看版本 | 回退 App Store 正式版 |
适用 / 不适用场景清单
适用
- 家庭套餐 30 台设备以内，需统一节点与规则。
- 公司 IT 给海外同事批量下发节点，且允许手动更新订阅令牌。
- 路由器固件刷机前，完整备份节点与分流。
不适用
- 需要保留 30 天以上能耗历史（会被清零）。
- 节点数量超过 500 条且路由器只有 128 MB 闪存（导入可能失败）。
- 合规要求「不可离线存储 IP 地址」的企业，因 .qbx 含完整专线 IP。
最佳实践 6 条
- 升级至 v6.8.2a 以上再导出，避免内存泄漏。
- 导出前关闭「防火墙兼容性模式」，减少 handshake 超时。
- 把 .qbx 与 user_hosts.json 放在同一文件夹，方便一次性打包给同事。
- 重要节点变更后，当天重新导出并 Git 备份，文件名带日期。
- 微信分享大于 100 MB 时改用 AirDrop 或网盘，防止压缩损坏。
- 导入后第一件事：更新订阅令牌，再测延迟，避免“全红节点”误会。
FAQ（FAQPage Schema）
导出的 .qbx 文件能否直接发给家人导入？
可以，但家人仍需自己输入订阅令牌；归档不含登录态。
路由器只有 64 MB 空间，能导出吗？
建议取消勾选「能耗仪表盘」与「日志缓存」，否则可能提示磁盘已满。
导入后节点全红，怎么办？
先更新订阅令牌，再测延迟；若仍全红，检查是否被官方下线，必要时手动删除旧节点。
收尾：下一步行动
读完本文，你已知道快连一键导出全部节点配置的核心路径、版本差异与边界。现在就打开客户端，按对应平台操作一次，把 .qbx 与 user_hosts.json 一并存入加密盘，并给文件加上日期命名；若团队内部需要分发，记得同步更新订阅令牌，再让同事导入。完成这一步，换机、刷机、合规审计都不再手忙脚乱。
