笙亿网络策划

如何为Git配置代理解决克隆GitHub仓库超时？

约 5 分钟读完 2 阅
文章导读
克隆 GitHub 仓库超时不是只改个仓库地址就能解决的，先花两分钟确认问题出在哪一层。需要说明的是，下面的做法适合你自己能控制本地网络代理的情况，公司网络或云主机需要先确认出口规则。
📋 目录
  1. 一 先确认是哪一层断掉了
  2. 二 用轻量命令暴露 Git 的连接路径
  3. 三 代理作用域限定到 GitHub 域名
  4. 四 三个容易忽略的配置位置
  5. 五 没有 HTTP 代理时的备用通道
A A

克隆 GitHub 仓库超时不是只改个仓库地址就能解决的，先花两分钟确认问题出在哪一层。需要说明的是，下面的做法适合你自己能控制本地网络代理的情况，公司网络或云主机需要先确认出口规则。

先确认是哪一层断掉了

如果执行 git clone 时报错 `fatal: unable to access 'https://github.com/...': Failed to connect to github.com port 443: Timed out`，并且用浏览器访问 GitHub 正常，那么基本可以确定是 Git 的网络连接路径受阻。此时先运行 `ping github.com` 确认 ICMP 是否通（不通也正常，很多服务器禁 ping）。更可靠的办法是用 `nc -vz github.com 443` 测试 TCP 连通性，如果 443 端口不通而网页能开，多半是本地网络代理规则丢弃了 Git 的请求。不要急着改代码，先确认系统里是否已有代理工具在运行。

浏览器能访问，说明当前网络环境可以到 GitHub 的 443 端口；Git 超时，说明 Git 的请求和浏览器没走同一条出口。常见原因是浏览器读了系统代理，Git 没有。接下来用 Git 自带的方式直接看它的连接路径。

用轻量命令暴露 Git 的连接路径

用 `git ls-remote https://github.com/octocat/Hello-World.git` 做一次轻量验证。如果这条命令能返回 HEAD 信息，说明代理路径通。如果还超时，加环境变量 `GIT_CURL_VERBOSE=1` 再跑一次，这时会打印出 Git 实际访问的代理地址、连接耗时和 TLS 握手细节。重点看 `Connected to proxy` 这一行，如果显示的 IP 和端口不对，说明配置没生效或者被环境变量覆盖。

如何为Git配置代理解决克隆GitHub仓库超时？

我习惯先跑 `ls-remote` 而不是直接 clone，因为仓库大时一次失败要等很久。看到 `Connected to proxy` 之后，把显示的地址和本地代理软件监听端口对一下，不一致就检查环境变量和 Git 配置的优先级。

代理作用域限定到 GitHub 域名

如果确认要配代理，别直接写 `git config --global http.proxy`。这里有一段我之前记下来的判断：

--global 会把代理应用到当前用户的所有仓库，包括公司内网 Git 服务器。假如内网地址走代理，可能直接被代理服务器拒绝。建议为 GitHub 单独限定作用域：`git config --global http.https://github.com.proxy http://127.0.0.1:1080`，这样只有访问 GitHub 才使用代理，其他仓库不受影响。若配置后出现内网 clone 失败，用 `git config --global --unset-all http.proxy` 和 `unset https.proxy` 恢复，然后改用上面的域名限定写法。

如何为Git配置代理解决克隆GitHub仓库超时？

命令里的 `127.0.0.1:1080` 换成你本地代理软件实际监听的地址和端口。设置完用同一段 `ls-remote` 验证，确认只对 GitHub 生效。出现内网仓库访问异常时，按上面那段里的方法回滚。

三个容易忽略的配置位置

代理软件开了“全局模式”，Git 依然不走代理，这是最常见的情况。原因在 Git 的 libcurl 不会读 Windows 或 macOS 的系统代理设置，必须单独给 Git 配置。另一个容易踩的是监听地址：写 `http://localhost:1080`，但代理软件实际监听 `127.0.0.1:1080`。多数环境等价，不过系统启用 IPv6 时，localhost 可能解析到 `::1`，连接就失败。如果代理要认证，URL 里必须带用户名密码，Git 不会弹认证框。

如何为Git配置代理解决克隆GitHub仓库超时？

这三个位置都不难查：先看 Git 配置里的 http.proxy，再核对代理软件监听地址，最后确认认证信息有没有写进 URL。逐个排除之后，剩下的是外层网络的问题。

没有 HTTP 代理时的备用通道

如果机器上确实没有 HTTP 代理，或者出口只允许 443 端口，可以改用 SSH 连接 GitHub。编辑 `~/.ssh/config`，加入 `Host github.com`、`HostName ssh.github.com`、`Port 443`、`User git`，然后在 GitHub 后台配上公钥，clone 时用 `git@github.com:owner/repo.git`。这个方案依赖 ssh.github.com:443 能通，不通就说明网络出口把这类流量也过滤了，需要回到网络层解决。

换成 SSH 地址后，先用 `ssh -T git@github.com` 确认通道正常。它能返回你的用户名，再继续 clone，省得在仓库地址上反复试错。