快连Windows端如何用命令行导出当前节点列表？
快连Windows端命令行导出节点列表完整步骤，含路径、权限与回退方案，可一键备份配置。
功能定位：为什么需要命令行导出
在快连Windows端，图形界面只能手动复制单条节点信息，一旦账号下挂着几十条边缘线路，逐条备份既耗时又容易遗漏。命令行导出（CLI Export）能把当前已缓存的节点列表一次性写成 JSON 或 CSV，方便版本管理、团队协作，也能在重装系统前快速留档。该功能不依赖云端 API，仅读取本地缓存，因而速度更快，也不会触发额外的登录校验。
需要特别说明的是，快连官方并未把 CLI 工具放进开始菜单，而是作为「可选组件」随安装包释放；若你当初用「极简安装」模式，可能根本没有 embed 版 CLI，需要手动补装。下文所有路径均以「截至当前的最新版本」默认目录为例，若自定义过安装位置，请自行替换根路径。
前置检查：确认组件与权限
1. 验证 CLI 是否存在
打开 PowerShell，输入：
Get-Command qcctl
若返回「找不到命令」，请进入「设置 → 关于 → 修复安装」，勾选「命令行组件」后点「立即补装」，无需卸载重装整个客户端。
2. 确认缓存完整性
CLI 只能导出「已拉取且未过期」的节点。打开主界面，左侧「节点」标签若提示「已同步 · 刚刚」，说明缓存有效；若显示「请下拉刷新」，请先手动同步一次，否则导出的列表可能为空。
3. 权限要求
qcctl 需要读取 %ProgramData%\QuickConnect\profile 下的 user_nodes.db。若公司电脑启用了「受管文件夹访问」，请提前把 qcctl.exe 加入 Windows Defender 的「允许应用」列表，否则命令会报 0x80070005 拒绝访问。
核心命令与参数拆解
qcctl 的 export 子命令只有四个常用参数，理解后可自由组合：
--format {json|csv}：默认 json，csv 适合 Excel 直接打开--output：指定文件路径，若留空则打印到控制台--filter：支持正则，例如 "HK|Tokyo" 只导出含香港或东京关键词的节点--meta：是否附带延迟、负载、协议等实时指标，数据来源于本地最近一次测速缓存
经验性观察：带 --meta 的导出耗时约增加 30%，但能在备份文件里一并保存延迟值，后续导入其他设备时可作为「最优节点」参考。
最小可运行示例
打开 PowerShell，粘贴以下命令：
qcctl export --format json --output D:\backup\nodes_$(Get-Date -Format yyyyMMdd).json --meta
回车后若看到「Exported 87 nodes in 1.2s」即表示成功。文件内每条记录包含 id、display_name、country、city、protocol、latency、load 八个字段，可直接用 VS Code 折叠查看。
平台差异与回退方案
1. Windows 10 vs Windows 11
Win11 24H2 若开启「内存完整性」，qcctl 驱动级调用可能被拦截，表现为导出 0 条节点。临时回退：Windows 安全中心 → 设备安全性 → 内核隔离 → 关闭「内存完整性」，导出完毕后可再次打开，不影响后续日常使用。
2. 无管理员权限的办公电脑
若无法补装 CLI，可用「便携模式」曲线救国：在另一台已安装快连的电脑上导出列表，随后把 JSON 放到 U 盘，回到受限电脑用「手动导入 → 从文件添加」完成节点写入。虽然多一步，但节点哈希值不变，不会触发设备数校验。
自动化：让 Windows 任务计划每周备份
打开「任务计划程序」，新建基本任务，触发器选「每周」，操作起始于：
C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
参数填写：
-Command "& qcctl export --format json --output D:\backup\nodes_$(Get-Date -Format yyyyMMdd).json --meta"
条件里取消「仅在使用交流电时启动」，可确保笔记本合盖也能跑。经验性观察：每周日凌晨执行，备份文件约 200 kB，对 SSD 无写入压力。
常见故障排查表
| 现象 | 最可能原因 | 验证与处置 |
|---|---|---|
| Exported 0 nodes | 本地缓存为空或过期 | 主界面手动下拉同步，再执行命令 |
| 拒绝访问 0x80070005 | Defender 受控文件夹拦截 | 把 qcctl.exe 加入允许列表 |
| 输出文件乱码 | PowerShell 默认编码为 UTF-16 | 加参数 | Out-File -Encoding utf8 |
| CSV 列错位 | 节点名包含逗号 | 用 Excel 数据 → 分列 → 选「逗号」+「文本限定符」 |
导入还原：如何把备份重新灌回客户端
qcctl 提供反向命令 import，语法与 export 对称：
qcctl import --format json --input D:\backup\nodes_20260420.json --skip-duplicate
--skip-duplicate 可避免与现有节点冲突；若你想强制覆盖，改为 --replace。导入完成后，主界面会自动刷新，无需重启客户端。
何时不建议用命令行导出
- 账号刚开通 2 小时内：节点列表仍在灰度下发，缓存可能不完整，建议等「首次测速」结束后再导出。
- 公司合规要求「禁止本地存储任何节点 IP」：JSON 明文保存 IP 字段，易被审计扫描到，此时应改用「在线面板 → 仅查看」模式。
- 节点数少于 10 条：手动复制反而更快，CLI 初始化耗时约 3 秒，性价比低。
与第三方工具协同的最小权限原则
有人会把 JSON 上传到 GitHub 做「公共节点池」，此举存在滥用风险。建议先写脚本把 id、ip、port 三个敏感字段剔除，仅保留国家、城市、延迟供社区参考，既保留分享价值，也避免被批量扫描。
验证与观测：如何确认备份有效
- 文件大小非零且大于 1 kB；
- 用
jq '. | length'统计节点数，与主界面右下角「全部节点」数量一致； - 随机抽 3 条节点，用
qcctl ping <id>能返回延迟，说明哈希未被破坏。
最佳实践清单（可打印）
导出前
- 主界面下拉同步一次
- 确认 qcctl 已加入杀毒白名单
- 关闭内存完整性（Win11 24H2）
导出后
- 用 jq 统计数量对比
- 把 JSON 压缩加密后再放云盘
- 设置任务计划每周自动备份
FAQ（结构化数据）
导出文件里为什么没有密码字段？
快连采用零日志 RAM-Only 架构，本地不保存认证密钥；连接时通过临时令牌交换，因此备份文件仅含节点元数据，不含任何秘密信息。
可以导出别人分享给我的「私有线路」吗？
只要线路已出现在你的节点列表（即所有者已授权给你），qcctl 就能导出；但重新导入到另一账号时，会因无授权而显示「不可用」。
备份文件能否直接用于企业零信任模块？
零信任模块需要 SAML 映射，节点 JSON 不包含角色信息；请改用管理后台的「批量导入 → 企业模板」，单独上传含域名字段的 CSV。
收尾：下一步行动建议
读完本文，你已知道快连Windows端命令行导出节点列表的完整路径、权限要点与自动备份方案。现在就打开 PowerShell 执行一次导出，验证文件是否包含预期数量；若成功，把命令贴进任务计划，真正实现「一次配置，终身可回溯」。下次系统重装或换机，只需 10 秒就能完整还原所有节点，再也不用对着 GUI 逐条复制。