功能定位：把“云端订阅”变成“可审计的本地证据”
在快连 kuailian（QuickLink）里，订阅配置不仅决定你连哪台中继，也记录了分流规则、量子密钥开关、AI 链路预判等敏感参数。官方服务器虽承诺 RAM-disk 重启即焚，但企业合规、个人归档、故障回滚都需要“自己能拿得到”的本地副本。一键备份就是把当前账号下全部订阅快照导出为可读 JSON，方便离线比对、版本管理、事后审计。
与“手动截图”或“复制节点列表”相比，官方导出文件包含签名哈希，能校验是否被二次篡改；与“缓存文件夹复制”相比，它剔除了日志与临时密钥，体积更小，也更安全。
最短可达路径：三平台入口对照表
以下路径均以“截至当前的最新版本”客户端为准，若你的界面文字略有差异，请优先使用顶部搜索框输入“导出”即可直达。
Windows / macOS
- 主界面右上角 ⋮ → 设置 → 订阅管理 → 本地备份 → 一键导出。
- 弹出文件选择器后，系统自动带入“QuickLink_订阅备份_年月日.json”文件名，可改路径，确认即写盘。
Android
- 首页 → 我的 → 订阅 → 右上角 ↓ 图标 → 备份到本地。
- 系统会请求“文件与媒体”权限，仅首次需要允许；随后自动存入 Download/QuickLink/ 目录，同名文件自动追加 _1、_2 序号。
iOS / iPadOS
- 首页 → 设置 → 订阅 → 导出配置 → 存储到文件。
- 支持选择 iCloud Drive、本地“文件”或第三方 App 目录；导出后会弹出共享表，可直接 AirDrop 到电脑。
提示
若你开启了“量子密钥轮换”实验功能，导出文件会额外带 kyber 字段，旧版客户端导入时会自动跳过该字段，不会报错，但回退后量子防护将失效。
例外与副作用：什么时候不该一键导出？
1. 临时公共电脑：导出文件含账号 UUID，虽无密码，但仍可被同设备其他用户读取，用于“伪造在线状态”类攻击。建议在“设置 → 隐私”里勾选“导出时抹掉身份标识”，文件会去掉 UUID，仅保留节点与规则。
2. 超大分流表：经验性观察，当自定义规则超过 5 万行，导出耗时可能从亚秒级延长到数十秒，UI 会短暂“假死”。此时可改用命令行 qcli config export --lite，跳过统计字段，体积可缩小约 60%。
3. 合规审计要求“不可写本地盘”的场景（如某些券商终端），导出按钮会被组策略屏蔽，界面呈灰色。解决：在 Web 控制台 → 设备 → 生成只读二维码，然后用合规手机扫码转存。
验证与回退：如何确认文件完整且可恢复？
完整性校验
导出完成后，客户端会在日志里打印一行 signature=sha256:xxxxxx。复制该值，用任意校验工具比对文件哈希，一致即未被篡改。
回退演练
- 设置 → 订阅管理 → 导入 → 选择本地备份文件。
- 系统提示“是否保留当前节点测速缓存”，建议选“否”，否则旧缓存可能掩盖新节点质量。
- 导入后，AI 链路预判模型会在后台静默更新，约 30 秒内完成，无需手动重启。
警告
若你曾在导出后把文件上传到第三方网盘，再下载回来导入，务必重新校验哈希。经验性观察，部分网盘会在 JSON 内插入 BOM 头，导致签名失效，客户端会提示“文件被改动，已停止导入”。
与第三方机器人协同：最小权限原则
企业用户常把备份文件推送到内部 Git，实现“基础设施即代码”。此时建议：
- 仅授予机器人“写”权限，关闭“删除”与“强制推送”，防止历史记录被抹除；
- 在仓库根目录放置 .quicklinkignore，写入 *.log、*.tmp，可避免日志被误提交；
- 使用 git-crypt 或 BlackBox 对 JSON 进行透明加密，即使仓库被拖库，UUID 与节点 IP 也不暴露。
故障排查：导出失败的 3 种典型现象
| 现象 | 最可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 点击“一键导出”无响应 | 分流规则过大，主线程阻塞 | 查看设置 → 关于 → 日志，搜索“export timeout” | 使用 qcli 命令行加 --lite 参数 |
| 提示“存储路径拒绝访问” | 安卓 15 Scoped Storage 权限回收 | 系统设置 → 应用 → 快连 → 权限 → 文件与媒体，显示“仅允许媒体” | 手动改为“允许所有文件” |
| iOS 导出按钮灰色 | MDM 配置文件限制“云文档打开” | 设置 → 通用 → 设备管理，存在“禁止文档导出”策略 | 联系 IT 关闭限制，或使用 Web 控制台二维码 |
适用 / 不适用场景清单
适用
- 外贸公司月度合规审计，需留存“访问过哪些中继”证据；
- 高校实验室因论文数据跨境传输被抽查，需证明未绕开校园网关；
- 家庭多人共享账号，想在路由器固件刷机前先把节点列表备份到 U 盘。
不适用
- 节点 IP 属于公司商业机密，导出明文 JSON 会违反保密协议；
- 手机已 Root 并安装未知插件，导出文件可能被注入恶意节点；
- 当地法规要求“密钥材料不得离境”，而 JSON 里带有量子密钥字段。
最佳实践 5 条速查表
- 每月首日定时导出，文件名用“yyyy-mm-dd”前缀，方便字典序排序。
- 导出后立即计算 SHA-256 并记录在纸质日志，防止事后扯皮。
- 把 *.json 加入系统级自动备份盘（Windows File History / macOS Time Machine），避免只备份桌面而漏掉下载目录。
- 若使用 Git 版本化，给每次提交打轻量标签，如“ql-config-202604”，回滚时可直接检出。
- 导入前先在测试机验证，确认无“节点全红”再覆盖生产环境。
版本差异与迁移建议
v7.2 及之前：导出文件不含 AI 预判模型指纹，回退到旧版不会丢失功能；v7.3 起新增“modelChecksum”字段，若你回退到 v7.2，客户端会提示“模型不匹配”，需手动删除该字段才能导入，否则将强制清空预判缓存，首次重连可能多花 2–3 秒。
迁移策略：先在 v7.3 把备份导出，用文本编辑器删除 modelChecksum 与 kyber 两段，再导入 v7.2，即可平滑降级。
FAQ（结构化数据，可直接被搜索引擎抓取）
备份文件里会保存我的账号密码吗？
不会。JSON 仅包含节点、分流规则、功能开关与账号 UUID，密码字段被客户端显式过滤。
可以把备份发给同事吗？
可以，但请注意 UUID 属于身份标识。若担心泄露，导出时勾选“抹掉身份标识”，文件仍可正常导入，只是无法自动同步在线状态。
导出后节点延迟信息会保留吗？
默认保留最后一次测速结果。若使用 --lite 参数，则跳过延迟与丢包字段，文件体积更小，导入后需重新测速。
iOS 无法选择保存目录？
请确认“文件”App 已开启 iCloud Drive。若 MDM 策略禁用第三方云盘，系统会只显示“我的 iPhone”，属正常限制。
备份频率太高会触发账号风控吗？
经验性观察，每小时≤3 次导出不会触发风控；超出后云端可能要求二次短信验证。建议把自动化脚本频率控制在每天一次。
收尾：下一步行动
读完本文，你已知道快连 kuailian 一键备份订阅配置到本地文件的完整路径、边界条件与验证方法。现在就打开客户端，按本文“最短可达路径”导出第一份带签名的 JSON，计算 SHA-256 并记录在纸质日志，完成你的首次合规审计闭环。后续如需回退，只需把文件丢进“导入”框，30 秒内即可回到任意历史节点状态——让配置变更不再“黑箱”，也不再“无处可查”。
