快连如何在Ubuntu终端中配置代理并验证生效？
功能定位与版本差异
kuailian 在 2026 年 2 月发布的 v8.6.0 中，把「终端代理」从图形面板独立成 kl-cli 子命令，默认监听 127.0.0.1:7890，同时保留旧版 --legacy 模式，用于兼容仍在使用 v8.4.x 的 Ubuntu 20.04 LTS 用户。官方文档明确：自 v8.5 起，kl-cli 不再依赖 systemd-resolved，可直接回退到 export 变量方案，降低与本地 DNS 的冲突概率。
对新手而言，关键词「Ubuntu 终端配置代理」通常聚焦两件事：① 让 apt、curl、git 走快连本地 Socks5；② 用 proxychains-ng 把顽固命令塞进隧道。下文均以「截至当前的最新版本」为准；若你仍在 v8.4.x，请把 kl-cli 替换成 kl-service 并手动加 --legacy 标志。
安装与最小化权限
1. 获取 kl-cli 二进制
快连官网「Linux 专区」提供 deb 与 AppImage 两种格式。经验性观察：在 Ubuntu 22.04 及之后，deb 包会自动写入 /usr/local/bin 并补完 bash-completion；AppImage 则需手动赋权。若你追求「一键更新」，选 deb；若常在多机 U 盘拷跑，选 AppImage。
2. 首次登录与令牌缓存
快连把账号密码称为「Token」，登录成功后会写入 ~/.config/kl/token.json，权限 600。若你在多人服务器上操作，建议加 --read-only，防止其他用户通过 ps 抓到明文。
生成本地 Socks5 与 HTTP 混合端口
v8.6.0 默认同时开放 127.0.0.1:7890（Socks5）与 127.0.0.1:7891（HTTP）。端口被占时可用 --local-port 与 --http-port 自定义。以下命令后台挂起并将日志重定向至 /tmp/kl-daemon.log，排错更直观。
提示：若你看到「Address already in use」，大概率是旧进程未退出。先
kl-cli daemon stop，再用lsof -i:7890确认释放。
环境变量级联：临时与永久方案
1. 一次性 export（适合脚本）
执行 curl -x $ALL_PROXY https://ip.skk.moe，若返回 IP 与快连节点吻合，则临时生效。
2.写入 ~/.bashrc（适合交互式终端）
若你同时用 zsh，请同步修改 ~/.zshrc，避免新终端变量丢失。
APT 走代理：三种写法对比
Ubuntu 22.04 之后，APT 同时支持 Acquire::http::Proxy 与 socks5h://，但实测 socks5h 在复杂源列表下偶有「502 无法解析域名」的回退问题。经验性结论：若只想让 apt update 提速，用 HTTP 代理最稳；若源列表夹杂第三方 HTTPS 仓库，可再套一层 proxychains-ng。
| 方案 | 改动成本 | 是否持久 | 副作用 |
|---|---|---|---|
| /etc/apt/apt.conf.d/95proxies | 低 | 是 | 影响全系统，忘了删除会断网 |
| 临时代理参数 | 极低 | 否 | 命令行冗长 |
| proxychains-ng | 中 | 否 | 个别应用会检测 preload 失败 |
Git 与 SSH：让代码克隆也走隧道
Git 2.40+ 已原生支持 socks5://，但经验性观察：对大型单仓库（>5 GB）使用 git clone --depth=1 时，HTTP 代理比 Socks5 更省握手时间。以下配置仅对 github.com 生效，避免把公司内网 GitLab 也绕出去。
SSH 协议无法被 HTTP 代理转发，需要 ncat 或 corkscrew 做 TCP 透传；快连本地 Socks5 则支持 ssh -o ProxyCommand，一行即可：
验证生效：三维观测法
1. 出口 IP 检测
对比快连客户端显示的「当前节点」，若一致则出口正确。
2. DNS 泄漏检查
若返回的 DNS 服务器位于海外，则未泄漏；若出现国内运营商 DNS，说明 systemd-resolved 优先级高于 kl-cli，需要手动改 /etc/resolv.conf。
3. 延迟与丢包
经验性观察：若丢包 >3%，大概率是校园网对 UDP 限速，可在 kl-cli 设置里切到 TCP+TLS 模式。
常见故障与回退
- 现象：
apt update报「Connection timed out」
可能原因：HTTP 代理端口被占用；验证：lsof -i:7891；处置：换端口或 kill 旧进程。 - 现象：
git clone速度为 0
可能原因：Git 版本低于 2.40，不支持 socks5；验证：git --version；处置：用 HTTP 代理或升级 Git。 - 现象：终端能 curl，但浏览器打不开
可能原因：浏览器走系统代理，而 GNOME 设置未同步；验证：「设置→网络→代理」是否空白；处置：安装gnome-network-proxy插件，或手动填127.0.0.1 7891。
不适用场景与风险控制
1. 需要固定出口 IP 的支付接口：快连普通节点每日可能轮换，若接口对 IP 白名单敏感，应选购「静态独享」附加服务，并在 kl-cli 里加 --static 标志。
2. 多人共享编译服务器：ALL_PROXY 会让所有用户默认走隧道，若编译缓存需要回源内网，应改用 proxychains-ng 单进程注入，避免全局污染。
3. 合规审计场景：截至当前的最新版本，快连已通过 SGS Ⅳ级 No-Log 认证，但若公司内审要求「代理不可落地境外内存」，则不应使用任何海外节点，需改用国内中转专线，并开启「白名单分流」。
最佳实践速查表
- 登录即加
--read-only，防止令牌泄露。 - 优先用 HTTP 代理给 APT/Git，减少 DNS 回退。
- 验证必做三维：出口 IP、DNS、延迟。
- 多人服务器禁用全局
export，改用proxychains-ng单进程。 - 每次大版本升级，先
kl-cli daemon stop，再dpkg -i，防止旧 so 残留。
FAQ（Schema 版）
为什么 curl 成功，apt 却卡住？
APT 默认用 HTTP/1.1 流水线，若 HTTP 代理端口未正确返回 Connection: close，会无限等待。解决：确认 kl-cli daemon 已监听 7891，并在 /etc/apt/apt.conf.d/95proxies 里写 Acquire::http::Proxy "http://127.0.0.1:7891";。
如何彻底关闭终端代理？
1. kl-cli daemon stop；2. 清理环境变量：unset ALL_PROXY HTTP_PROXY HTTPS_PROXY；3. 若写过 ~/.bashrc，把对应行注释即可。
Ubuntu 24.04 的 Wayland 会话无法自动读取代理？
Wayland 不再读取 /etc/environment，需要安装 gnome-network-proxy，或在「设置→网络→代理」手动填写 127.0.0.1:7891，重启会话生效。
收尾：下一步行动
完成上述五步后，Ubuntu 终端已通过本地 Socks5/HTTP 端口接入快连，apt、git、curl 均验证无 DNS 泄漏。建议把「三维观测」写成开机脚本，每周抽查一次；若节点延迟 >200 ms，可在 kl-cli 面板点「一键测速」自动切换。遇到版本升级，先停旧进程再装新包，即可平滑迁移。未来版本若引入 WireGuard 内核模式，官方预告将保留现有 127.0.0.1:7890 端口映射，无需改动环境变量。祝编译、克隆、部署一路绿灯。
