为命令行 Git 启用代理

1 问题描述

在 Mac 上使用 ClashX 进行科学上网时，浏览器能够正常访问 GitHub，但在命令行使用 Git 命令时经常无法连接。通过 GIT_TRACE=1 GIT_TRACE_PACKET=1 GIT_TRACE_CURL=1 git fetch 进行调试，发现 Git 并没有使用代理，而是直接访问 GitHub 服务器：

Hw-MacBook-Pro:images hw$ GIT_TRACE=1 GIT_TRACE_PACKET=1 GIT_TRACE_CURL=1 git fetch
13:05:29.021638 exec-cmd.c:139          trace: resolved executable path from Darwin stack: /Applications/Xcode.app/Contents/Developer/usr/bin/git
...
13:05:29.151861 http.c:756              == Info: Connected to github.com (20.205.243.166) port 443

从输出中可以看出，Git 并没有使用代理。

2 解决方案

根据 StackExchange 文章^[1] 的提示：

For command line tools like curl etc. "system proxy settings" is exactly what you have set in your second example - that is, the variables `$http_proxy` etc. Does the GUI tool you use for setting "system proxy settings" set these variables for terminal sessions? If not, then you have the answer why the settings are not used. Simply your GUI proxy setting application is incompatible with command line tools.

命令行 Git 需要配置环境变量 $http_proxy 和 $https_proxy。

我的 ClashX 在 127.0.0.1:7890 端口开启了 HTTP、HTTPS 和 SOCKS5 代理服务。

通过以下命令为 Git 配置代理：

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

配置完成后，再次执行 git fetch，可以看到 Git 现在走了代理：

Hw-MacBook-Pro:images hw$ GIT_TRACE=1 GIT_TRACE_PACKET=1 GIT_TRACE_CURL=1 git fetch
13:06:29.140435 exec-cmd.c:139          trace: resolved executable path from Darwin stack: /Applications/Xcode.app/Contents/Developer/usr/bin/git
...
13:06:29.211802 http.c:756              == Info: Connected to 127.0.0.1 (127.0.0.1) port 7890
...
13:06:29.211903 http.c:756              == Info: Establish HTTP proxy tunnel to github.com:443

3 在 Ubuntu 虚拟机上的配置

虚拟机与宿主机通过桥接模式连接，虚拟机的 IP 地址为 10.211.55.18，宿主机的 IP 为 10.211.55.2。为虚拟机上的 Git 配置代理：

git config --global http.proxy http://10.211.55.2:7890
git config --global https.proxy http://10.211.55.2:7890

同时，确保 ClashX 设置为允许局域网连接。

在虚拟机中执行 Git 命令并确认代理设置：

hw@hw-Parallels-Virtual-Platform:~/images$ GIT_TRACE=1 GIT_TRACE_PACKET=1 GIT_TRACE_CURL=1 git fetch
13:07:29.255333 git.c:463               trace: built-in: git fetch
...
13:07:29.281054 http.c:845              == Info: Connected to 10.211.55.2 (10.211.55.2) port 7890
...
13:07:29.281179 http.c:845              == Info: Establish HTTP proxy tunnel to github.com:443

4 参考文章

1. Why git, curl and such tools can’t use system network proxy? ↩