快连CLI如何查看实时延迟并一键排序节点？

功能定位：为什么需要 CLI 看延迟

2026 年 v7.3.0 起，快连把「AI 智能路由 2.0」设为默认策略，GUI 只告诉你结论，却不给过程。脚本党、NAS 玩家、CI 流水线要想拿到毫秒级原始数据并按自己的规则重排，快连CLI如何查看实时延迟并一键排序节点 是目前唯一的入口。

经验性观察：家庭组 6 台设备同时抢“推荐节点”时，GUI 端常报 429，而 CLI 因绕过可视化队列，可直接读到负载数值，提前避开高占用线路。

版本演进与兼容性边界

截至当前，Windows/macOS/Linux 三端已统一用 qlc（QuickLink CLI）单二进制；Android/iOS 仍沿用旧名 qlcli，子命令集 90% 重合。下文以桌面端为主，移动差异单独标注。

注意：v7.2 之前的老客户端未内置 latency 子命令，需先完整卸载再装 7.3.0，否则会出现「unknown subcommand」错误。

安装与首次登录

桌面端（Windows 11 24H2 示例）

官网下载 QuickLink-CLI-7.3.0-x64.exe，双击后自动写入 %ProgramFiles%\QuickLinkCLI；
PowerShell 执行 qlc login，按提示扫码或输入订阅码；
出现 Login OK, license valid until 2027-04-28 即完成凭证缓存。

移动端（Android 15 示例）

Play 商店页滑到「其他应用」，找到 QuickLink CLI Plugin，安装后会在 Termux 或系统终端生成 qlcli。首次运行需授权「附近设备」权限，用于扫描本地代理端口，防止重复登录。

核心命令：latency 子命令拆解

语法骨架：qlc latency [--fresh] [--tcp] [--top N] [region]

--fresh 强制跳过本地缓存，直接向 340+ 边缘节点发 ICMP/TCP SYN；
--tcp 改用 443 端口三次握手测速，适合 ICMP 被丢包的环境；
--top N 只返回延迟最低的 N 条，默认 10；
region 可写 HK、TKY、SG 等简码，也可省略表示全球扫。

一键排序：把结果喂给 connect

CLI 默认按「延迟 ↓」输出，一行命令就能完成测速+连接：

qlc latency --top 1 --tcp | jq -r '.[0].id' | xargs -I{} qlc connect {}

解释：先用 jq 抽节点 ID，再管道给 connect；若系统无 jq，可加 --raw 让 qlc 直接输出纯 ID。

平台差异与回退方案

系统	是否支持 --tcp	回退提示
Windows 11 24H2	✅	若报 KERNEL_SECURITY_CHECK，需更新自带 TUN 驱动
macOS 15	✅	首次需授权「输入监控」权限，否则 ICMP 回环失败
iOS 19	❌	系统禁止 raw socket，只能用 GUI 内置延迟库
Android 15	⚠️	需 root 才发 ICMP；无 root 时自动降级为 --tcp

常见故障排查

现象：latency 子命令返回空表

可能原因：本地缓存损坏。验证：执行 qlc config show | jq .cache_last_update 若显示 null，执行 qlc cache clean 后重测即可。

现象：--tcp 测速全部超时

可能原因：企业内网对 443 端口做 DPI 重置。处置：改用 --tcp --port 80 或回退 GUI 的 QUIC-T 隧道。

是否值得用 CLI？三条判断标准

你需要把选节点逻辑写进自动化脚本（如游戏启动前自动换线）；
家庭组多人共享，想避开 429 超载；
设备无图形界面（OpenWrt、NAS、GitHub Actions）。

若只是偶尔追剧，GUI 的「一键直连」已足够；CLI 带来的 1–2 ms 提速对体感影响不大，却要多维护一条命令行。

验证与观测方法

建议把 qlc latency --top 5 --fresh 写进 crontab，每 10 分钟输出到 CSV，字段含时间戳、节点名、延迟、负载。连续跑 24 h 后，用 Excel 透视即可看出晚高峰哪几条线路最稳定，再手动锁定到 GUI「常用节点」列表，实现「CLI 跑数据、GUI 享结果」的混合策略。

最佳实践清单（检查表）

脚本开头先 qlc version 判断 ≥7.3.0，否则退出；
永远加 --fresh 做关键任务，防止读到昨日缓存；
若节点用于游戏，再加 --tcp 模拟真实握手；
输出用 jq -c 压缩，方便后续管道；
连上后立刻 qlc connect --stats 二次确认丢包 <1%，否则 30 秒后重选。

FAQ（结构化数据）

iOS 能用 qlc latency 吗？

系统限制 raw socket，CLI 无法发 ICMP，只能回退到 GUI 内置延迟库。

--tcp 与 ICMP 差多少？

经验性观察：校园网 ICMP 丢包 30% 时，--tcp 测速仍稳定，但绝对值高 5–15 ms，适合只求可用性的场景。

脚本里如何优雅重试？

用 bash 的 timeout 限定 8 秒，失败则 sleep 3 倍递增，最多 3 次；qlc 自带返回码 124 表示测速超时，可直接判断。

收尾：下一步行动

如果你符合「自动化选线」或「多人共享避 429」任一条件，现在就升级 7.3.0，把 qlc latency --top 1 --tcp | xargs qlc connect 写进开机脚本，跑一晚 CSV 日志，再对比 GUI 默认线路的延迟曲线，就能量化 CLI 带来的实际收益。否则，继续用「一键直连」即可，别让命令行成为新的维护负担。