如何在Linux终端下通过命令行启动快连代理？

功能定位：为什么需要命令行启动

图形客户端在远程服务器、Docker 或最小化系统里往往无法运行，而kuailian提供的官方 CLI（quicklink-cli）能在纯终端环境完成登录、选线与守护进程管理，方便 CI/CD、爬虫、海外部署脚本一键拉起代理，无需桌面依赖。

前置条件与版本边界

截至当前的最新版本，官方 CLI 仅支持 x86_64 与 arm64 两种架构，内核要求 ≥3.10，glibc ≥2.28。经验性观察：在 Alpine Linux（musl）下启动会提示 version `GLIBC_2.28' not found，需改用 Debian/Ubuntu 容器或自行静态编译。

下载与安装路径

官网「Linux 客户端」页提供两种格式：deb 与 tar.gz。若机器已启用 dpkg，可直接 sudo dpkg -i quicklink-cli*.deb；无包管理器时，把 tar.gz 解压到 /usr/local 并把 bin/quicklink 软链到 /usr/local/bin 即可完成全局调用。

最小可用启动流程

首次登录：quicklink login --email 你的账号 --password 你的密码，令牌默认写入 ~/.quicklink/token.json，权限 600。
列出节点：quicklink list --region CN 可只看国内入口，返回节点 ID、延迟、负载。
启动守护：quicklink daemon --node auto --protocol wireguard-ng，其中 auto 让后台按 AI 测速挑选最优节点。
验证出口：curl -4 ip.sb 若返回非本地 IP，则隧道已生效。

systemd 托管（推荐）

新建 /etc/systemd/system/quicklink.service：

[Unit]
Description=QuickLink CLI Daemon
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/quicklink daemon --node auto --protocol wireguard-ng
Restart=on-failure
RestartSec=10
User=nobody

[Install]
WantedBy=multi-user.target

执行 systemctl daemon-reload && systemctl enable --now quicklink 即可开机自启，日志通过 journalctl -u quicklink -f 实时查看。

平台差异与参数对照

系统	默认配置文件路径	是否支持 Split-App
Debian/Ubuntu	~/.quicklink/config.json	否（仅 GUI）
CentOS 8/9	同上	否
OpenWRT 22	/etc/quicklink/cli.json	是（需 luci-app-quicklink）

常见分支与回退方案

若遇到 Protocol negotiation failed，经验性观察多为校园 NetWall 对 UDP/443 做 RST，可回退到 TCP 模式的 Trojan：

quicklink daemon --node 1024 --protocol trojan --transport tcp

此时延迟可能增加 10–30 ms，但穿透率提升。切换后无需重新登录，仅需重启守护。

自动化脚本示例

在 GitHub Actions 里，让构建机访问海外容器仓库：

- name: Start QuickLink CLI
  run: |
    sudo dpkg -i quicklink-cli.deb
    quicklink login --email ${{ secrets.QL_EMAIL }} --password ${{ secrets.QL_PASS }}
    quicklink daemon --node auto --protocol wireguard-ng &
    sleep 5 && curl -4 ip.sb

工作假设：免费 runner 的出口被限速 30 Mbps，实际拉取镜像时间从 3 min 降到 40 s 左右（因仓库而异）。

故障排查速查表

现象：TLS handshake timeout → 可能 UDP 被丢包，改用 TCP 传输或端口 443 伪装。
现象：账号提示「区域不符」 → 订阅码与账号归属地不一致，需绑定 +86 手机或在个人中心切换区域。
现象：daemon 启动后 10 s 自动退出 → 检查 /var/log/quicklink/daemon.log 是否因 token 过期，重新 login 即可。

不适用场景与风险提示

CLI 版本暂不支持广告拦截与 Split-App 分流，若需在路由器层给游戏主机单独线路，应改用 OpenWRT 完整固件。另因守护进程以 nobody 身份运行，日志目录需提前 mkdir /var/log/quicklink && chmod 755，否则写日志失败会导致无限重启。

FAQ（结构化数据）

CLI 是否支持双栈 IPv6 出口？

目前仅 IPv4 隧道，IPv6 会在 7.5 版加入，可关闭系统 IPv6 避免解析泄漏。

能否同时开多条隧道？

官方 CLI 单进程仅维护一条路由表，多实例会冲突；如需 8 路并行，请用 Vision Pro 2 客户端或路由器版。

token.json 泄露怎么办？

立即执行 quicklink logout --all 强制踢掉所有会话，再重新 login 生成新令牌。

核心结论与下一步

在 Linux 终端里，官方 CLI 提供了不依赖图形、可脚本化的最小路径：login→list→daemon，配合 systemd 即可稳定自启。若你仅需 IPv4 出口、无需应用级分流，命令行方案足够；否则等待 7.5 的 IPv6 与多隧道更新，或转向 OpenWRT 全功能固件。现在就把 quicklink daemon 写进你的 CI 脚本，验证出口后安心跑任务吧。