快连 CLI 命令行工具使用指南

对于习惯脚本化和自动化工作流的技术用户来说，图形界面并不是效率最高的配置方式。快连在 Linux 平台提供 CLI 命令行工具 kuailian-cli，可以完成并行路径数量、传输协议、加密方案的配置，并支持状态查询与一键诊断。所有 CLI 配置立即生效、无需重启客户端，因此非常适合批量部署、自动化运维与故障排查场景。

本文基于快连 v2.6.1 的官方命令说明整理，包含安装验证、常用命令参考表、典型场景示例与脚本化配置方法。更完整的图形界面操作说明见 快连使用指南。

安装与版本验证

CLI 工具随快连 Linux 版本（v2.6.1）提供，支持 Debian / Ubuntu / CentOS / Arch 等常见发行版，可在 快连下载 页面获取对应平台的安装包。安装完成后，将 kuailian-cli 所在目录加入 PATH，即可在任意终端中使用。

安装后建议先运行 kuailian-cli --help 验证工具可用，并查看全部支持的命令选项：

$ kuailian-cli --help
用法: kuailian-cli [选项]
--set-path 设置并行路径数量（2-8）
示例: kuailian-cli --set-path 4
--set-protocol 设置传输协议（wireguard / bbr / quic）
示例: kuailian-cli --set-protocol quic
--set-encryption 设置加密方案（aes-256-gcm / chacha20-poly1305）
示例: kuailian-cli --set-encryption aes-256-gcm
--status 查看当前配置与通道状态
--diagnose 运行诊断测试并生成报告

核心命令参考

下表汇总了快连 CLI 的全部常用命令。所有命令均为原子操作，执行后立即生效，无需重启客户端。

命令 作用 可选值 / 示例
--set-path 设置并行传输路径数量 2–8；示例：kuailian-cli --set-path 4
--set-protocol 切换传输协议 wireguard / bbr / quic；示例：kuailian-cli --set-protocol quic
--set-encryption 选择加密方案 aes-256-gcm / chacha20-poly1305；示例：kuailian-cli --set-encryption aes-256-gcm
--status 查看当前配置与各通道状态 直接运行：kuailian-cli --status
--diagnose 运行诊断测试并生成报告 直接运行：kuailian-cli --diagnose
--help 显示命令帮助与全部选项 直接运行：kuailian-cli --help

典型场景：如何用 CLI 应对不同网络环境

场景一：高丢包弱网环境，优先保证吞吐稳定

根据快连 v2.6.1 更新说明，QUIC 协议在高丢包环境下的吞吐表现已进一步优化。若您的网络丢包率偏高，可以切换至 QUIC 协议：

$ kuailian-cli --set-protocol quic

场景二：需要更高带宽时，扩展并行路径

快连默认使用自动模式，多路径并行传输可在 2–8 条通道间调节。自 v2.5.0 起通道数量已扩展至 4 条（用户可调 2–8 条）。需要更高吞吐时，可手动提升并行路径数量：

$ kuailian-cli --set-path 6

并行路径越多，单条通道故障时剩余通道的负载能力越强；路径调度机制详见 《快连的多路径并行传输如何提升数据传输效率？》。

场景三：按设备性能选择加密方案

AES-256-GCM 支持硬件加速，适合桌面设备；ChaCha20-Poly1305 在移动设备上更高效。CLI 同样可以指定加密方案：

$ kuailian-cli --set-encryption aes-256-gcm

脚本化配置示例

CLI 的全部命令都是单行原子操作，天然适合写入脚本。以下是一个简单的初始化脚本示例（供参考，可按实际环境调整）：

$ #!/bin/bash
# 快连 CLI 初始化脚本示例
kuailian-cli --set-protocol quic
kuailian-cli --set-path 4
kuailian-cli --set-encryption aes-256-gcm
kuailian-cli --status

将上述脚本保存后赋予执行权限，即可在多台设备上以一致策略批量完成配置。登录同一账号后，配置会在设备间自动同步（最多 5 台设备保持同一策略，同步延迟 ≤ 2 秒），详见 《快连电脑版与移动端的传输配置是如何实现跨平台同步的？》。

验证配置与故障排查

每次修改配置后，建议按以下步骤验证：

  1. 核对配置：运行 kuailian-cli --status，确认协议、路径数量与加密方案与预期一致。
  2. 运行诊断：执行 kuailian-cli --diagnose 生成诊断报告，检查各通道的延迟、丢包与吞吐情况。
  3. 查看日志：日志文件位于 ~/.kuailian/logs/ 目录，可按时间戳定位最近一次连接的详细记录。
  4. 提交工单：如果问题无法自行定位，将 --diagnose 生成的诊断报告附上，通过 联系我们 提交给技术支持团队。
📌 提示： 快连默认使用自动模式，无需任何配置即可开始传输。CLI 主要用于需要精细控制或批量部署的高级场景；若您的网络环境变化频繁，建议保持默认自动模式，由系统根据实时网络质量选择最优协议栈与路径。

常见问题

CLI 配置修改后需要重启吗？

不需要。快连的 CLI 配置立即生效，修改后可直接用 kuailian-cli --status 确认最新状态，无需重启客户端。

CLI 只在 Linux 上可用吗？

是的。CLI 工具随快连 Linux 版本提供；Windows / macOS 客户端提供图形化的高级设置面板，支持相同的路径数量、协议优先级与加密方案配置，两种方式的配置结果完全一致，并可通过同一账号跨设备同步。

想进一步了解三种传输协议的适用场景，推荐阅读 《WireGuard、TCP-BBR与QUIC，快连电脑版该选哪个协议？》；完整的图形界面操作与故障排查方法，参见 快连使用指南。