技术 / 排查

命令行代理:为什么 git clone 还是慢

浏览器走代理了,`git clone` 却卡住——因为命令行程序不读系统代理设置,它们只认环境变量或自己的配置。

环境变量GitTUN
本篇要点
  • 命令行只认环境变量或自身配置,不读系统代理。
  • Git 有独立配置,优先级高于环境变量。
  • WSL 与容器是独立网络命名空间,127.0.0.1 指向自己。

为什么不读系统代理

系统代理是给愿意读它的程序准备的设置。浏览器读,Git、npm、curl、ssh 多数不读。于是出现「网页能开、命令行不动」的分裂状态。

Git 与其他工具

Git 支持单独配置代理,只影响 Git。换网络后记得清理,否则在别的网络下会连不上:

git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897
# 取消
git config --global --unset http.proxy

npm、pip、docker 各有自己的配置入口:npm 用 config,pip 用配置文件或环境变量,docker 要在守护进程层配。逐个配置很碎,这也是很多人直接开 TUN 的原因。

环境变量

  • HTTP_PROXY / HTTPS_PROXY:给 http(s) 客户端用
  • ALL_PROXY:给支持 SOCKS 的程序用
  • NO_PROXY:排除本地与内网地址
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1,192.168.0.0/16

WSL 与容器

WSL 与容器是独立网络命名空间,127.0.0.1 指向自己而不是宿主机。要用宿主机的代理,得换宿主机局域网 IP,并在客户端开启「允许局域网连接」。

怎么验证

在同一个终端里请求一次目标地址,能返回就说明生效。三个环境分别测,结果常常不同。

curl -I https://github.com --max-time 8

ssh 与容器的补充说明

ssh 不走 HTTP 代理,这是很多人配完环境变量仍连不上服务器的原因。它需要 ProxyCommand 指向一个 nc 或 connect 命令,或者干脆开 TUN 让流量在网卡层被接管。

容器同理:容器内的 127.0.0.1 是容器自己。要么给容器传 --network host,要么注入宿主机 IP 的环境变量,否则配了也没用。

什么时候干脆开 TUN

当要配的东西超过三个(git、npm、pip、docker、ssh),就不要逐个改了。开 TUN 一次解决,代价是与容器网段可能冲突,把 172.17.0.0/16 加进绕过列表即可。

常见问题

设了还是慢?

确认是否走 HTTPS 且被 http.proxy 覆盖。

ssh 走代理吗?

不走,需要 ProxyCommand 或 TUN。

怎么彻底取消?

unset 环境变量 + git config --unset。

需要重启终端吗?

环境变量只对新会话生效。