快连Linux终端如何命令行连接并设为系统代理？

为什么要在Linux终端里用命令行接管快连

在服务器、CI容器或远程开发机里，图形界面往往不可用，而快连Linux终端如何命令行连接并设为系统代理正是解决这一痛点的关键。相比手动点开App再复制配置，CLI方式可以一次性写入systemd服务，实现开机自启、故障自动重连，也方便Ansible、SaltStack批量下发。

经验性观察：在同等网络环境下，命令行直连比GUI中转少一跳本地回环，TCP握手延迟可下降约5–15 ms；对于批量爬取或Git克隆大仓库，整体耗时缩短肉眼可见。

前置条件与版本边界

截至当前的最新版本（请以实际安装包为准），快连官方提供quicklink-cli二进制，支持x86_64、aarch64两种架构，最低内核要求3.10。若系统为CentOS 7、Debian 9、Ubuntu 18.04及以上，可直接使用；若在内网Docker环境，需确认--cap-add NET_ADMIN权限已打开，否则无法写入TUN。

警告：若服务器已运行其他全局代理（如v2rayA、clash-meta），请先停止其systemd单元，避免双写iptables导致规则冲突。

安装快连CLI的三种常见路径

1. 官方一键脚本（推荐）

curl -fsSL https://pkg.quicklink.io/install.sh | sudo bash
# 脚本会自动识别发行版，写入/etc/yum.repos.d或/etc/apt/sources.list.d

脚本末尾会提示quicklink --version，若回显“quicklink version 2026.x.x”则安装完成。

2. 手动下载tar.gz（适用于内网隔离）

wget https://pkg.quicklink.io/stable/linux/amd64/quicklink-cli.tar.gz
tar -xzf quicklink-cli.tar.gz
sudo mv quicklink /usr/local/bin/
sudo chmod +x /usr/local/bin/quicklink

3. 容器镜像（CI场景）

docker run --rm --cap-add NET_ADMIN \
  -e QUICKLINK_TOKEN=<你的NFT通行证> \
  quicklink/cli:2026-latest quicklink connect --proxy-mode system

登录与NFT通行证写入

快连采用Polygon链NFT作为订阅凭证，首次使用需绑定：

在桌面端导出“CLI凭证”→复制Token字符串；
Linux终端执行
quicklink login --token <Token字符串>
成功后会写入~/.config/quicklink/credentials.json，权限600。

提示：若服务器多人共用，可把credentials.json放在/etc/quicklink/并设置组只读，避免重复登录。

一条命令启动并设为系统代理

sudo quicklink connect --proxy-mode system --tcp-port 7890 --udp-port 7891 --daemon

参数说明：

--proxy-mode system：自动写入环境变量http_proxy/https_proxy/ALL_PROXY，并下发iptables规则，使本机所有进程默认走快连；
--tcp-port/--udp-port：指定本地SOCKS5监听端口，后续可给curl、dnf、apt、git等显式调用；
--daemon：后台运行，失败自动重试10次，日志写入/var/log/quicklink/daemon.log。

验证代理是否生效

1. 环境变量检查

env | grep -i proxy
# 预期回显：http_proxy=socks5://127.0.0.1:7890

2. 外部IP变更检测

curl -s ipinfo.io | jq .country
# 经验性观察：若返回CN，说明已切到回国专线；若仍显示原属地，则规则未命中。

3. systemd状态

systemctl status quicklink-daemon
# Active: active (running) 表示守护进程正常

分流（Split-Tunneling）CLI配置

若只想让特定用户或CIDR走代理，可编辑/etc/quicklink/rules.yaml：

bypass:
  - 192.168.0.0/16
  - 10.0.0.0/8
force:
  - "*.cn"
  - 123.207.0.0/16

修改后执行sudo quicklink reload无需断连即可生效。经验性观察：在爬虫场景下，把国内API站点加入force列表，可显著降低被限流概率。

开机自启与故障回退

sudo systemctl enable quicklink-daemon
sudo systemctl start quicklink-daemon

若节点全部失效，CLI会在30分钟内尝试切换5跳混淆链；若仍失败，自动清理iptables并退出，防止“断网”事故。此时systemd会按Restart=on-failure策略重拉，直到网络恢复。

常见故障排查表

现象	可能原因	验证与处置
curl返回“Timeout”	本地端口未监听	ss -lntp \| grep 7890，若无回显，daemon未启动
Git clone仍走原IP	git自身代理未配置	git config --global http.proxy socks5://127.0.0.1:7890
Docker容器内不生效	容器网络隔离	加--network host或手动export代理变量

何时不该用CLI系统代理

服务器对外提供公网服务（如Nginx、SMTP），全局代理会把回源IP也替换，导致日志失真；
需要本地抓包审计，走TUN后原始报文被加密，tcpdump只能看到loopback；
合规要求数据不出境，NFT通行证绑定的是海外出口节点，需改用“回国专线+白名单”模式。

最佳实践速查表

先在测试机跑--proxy-mode socks，确认业务逻辑无误后再切system；
把/var/log/quicklink加入logrotate，防止daemon.log撑满/；
CI场景用--oneshot参数，任务完成后自动logout，避免Token泄露；
每月底在桌面端检查NFT剩余时长，二级市场挂牌前先在CLI执行quicklink logout解除绑定。

FAQ（结构化数据）

快连CLI是否支持32位ARM？

截至当前最新版本，官方仅提供x86_64与aarch64二进制，32位ARM需自行交叉编译，官方未给出编译文档。

如何彻底卸载并清理iptables？

执行sudo quicklink disconnect --flush会自动删除添加的iptables规则；随后sudo systemctl disable quicklink-daemon并删除/usr/local/bin/quicklink即可。

能否同时运行多个NFT通行证？

经验性观察：同一台机器可启动多个quicklink实例，但需指定不同端口与路由表，否则iptables冲突；官方未承诺多实例稳定性，生产环境请谨慎。

结论与下一步行动

通过官方CLI，快连在Linux终端里可一条命令完成“连接+系统代理”双动作，兼顾开机自启与故障回退。若你正维护海外爬虫、CI流水线或远程开发机，不妨先在测试机按本文步骤跑通，再批量下发到生产集群。记得每月检查NFT时长与节点健康，必要时二级市场转手，降低沉没成本。