网络故障排查栏目问题解答

GitHub clone、下载太慢:给 git 单独配代理的方法

GitHub 上 clone 仓库或下载 Release 很慢,多数是 git 没走代理。这一页讲清 git 怎样单独设置 HTTP 和 SSH 代理、浏览器下载怎样走客户端,以及设置后仍然慢时该怎么排查。

直接答案

GitHub clone 慢,多半是 git 没有读系统代理,还在直连。最直接的办法是单独给 git 配代理,比如 git config --global http.proxy http://127.0.0.1:7890,端口换成你客户端设置里的代理端口;用 SSH 地址的仓库要在 SSH 配置里另外设置,或者干脆打开客户端的 TUN 模式。

目录

在国内 GitHub 能直接连上,但速度和稳定性起伏很大,clone 大仓库时常常只有每秒几十 KB,或者下到一半就断。不少人开着代理客户端,浏览器打开 GitHub 飞快,git clone 却照样慢,原因是 git 这类命令行程序一般不看系统代理设置,依旧在直连。

有三条路可走:单独给 git 配代理、让 SSH 也走代理,或者打开客户端的 TUN 模式,把所有命令行工具一次性接管。

单独给 git 配 HTTP 代理

用 https://github.com/... 地址 clone 的仓库,这样设置:

# 所有 HTTPS 仓库走代理
git config --global http.proxy http://127.0.0.1:7890

# 或者只让 GitHub 走代理(推荐)
git config --global http.https://github.com.proxy http://127.0.0.1:7890

# 查看与取消
git config --global --get http.proxy
git config --global --unset http.proxy

例子里的 7890 只是一个常见端口。请到代理客户端的设置里看实际的 HTTP 或混合代理端口,不同客户端、不同版本的默认值都不一样;端口填错了,git 会报连接被拒绝。

仓库很大、又只要最新代码时,可以用浅克隆少下一些内容,下到一半断掉的机会也会小一些:

git clone --depth 1 https://github.com/用户名/仓库名.git

让 SSH 地址也走代理

仓库地址如果是 git@github.com:... 这种格式,走的是 SSH 协议,上面的 http.proxy 管不到它。通用做法是在 SSH 配置文件里给 github.com 指定一条代理命令,macOS 和 Linux 上常见的写法如下:

# 写入 ~/.ssh/config
Host github.com
  HostName ssh.github.com
  Port 443
  User git
  ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p

这段配置做了两件事:改连 GitHub 在 443 端口提供的 SSH 服务,避开 22 端口容易被干扰的问题;再经 SOCKS5 代理转发,所以端口得支持 SOCKS5(Clash 一类客户端的混合端口一般 HTTP 和 SOCKS5 都支持)。Windows 的 Git Bash 里 nc 的参数可能不一样,常见做法是换成 Git for Windows 自带的 connect 命令,或者直接用下面讲的 TUN 模式。

打开 TUN 模式

客户端的 TUN 模式可统一处理一般软件的网络流量。配置时请结合操作系统与客户端文档核对影响范围,并在不再需要时关闭相应设置。

开了 TUN 以后,最好把之前给 git 设的代理取消掉,免得重复代理出毛病。

Release 文件下载慢

  1. 用浏览器下:浏览器一般会读系统代理,开着代理直接下就行。
  2. 在命令行里下:curl 可以用 -x 参数指定代理,或者设置 HTTPS_PROXY 环境变量。
  3. 下到一半断了:换一个延迟低、丢包少的节点,GitHub 对地区不挑,日本、新加坡、香港、美国都可以。

碰到证书或 TLS 握手报错,参考 TLS 报错怎么排查。

小结

  • git 一般不读系统代理,clone 慢多半是命令行还在直连。
  • HTTPS 地址的仓库,用 git config 写一条 http.proxy,范围最好限定在 GitHub,端口照客户端里显示的填。
  • SSH 仓库要在 SSH 配置里设代理,或者改走 443 端口。
  • 命令行工具多的话,直接开 TUN 模式最省事。

问答

给 git 设了代理,拉国内仓库会不会变慢?

用全局的 http.proxy 的话,所有 HTTPS 仓库都会走代理,国内仓库也要绕一圈。只给 GitHub 设代理就能避免,命令是 git config --global http.https://github.com.proxy 后面跟代理地址。

设好代理后报连接被拒,怎么办?

一般是端口不对,或者客户端根本没开。先确认代理客户端在运行,再到它的设置里核对代理端口,改掉 git 配置里的端口。各客户端、各版本的默认端口都不同,别照抄例子。

取消 git 代理用哪条命令?

执行 git config --global --unset http.proxy 就行;如果设的是只针对 GitHub 的代理,就执行 git config --global --unset http.https://github.com.proxy。

搜索文章、品牌、AI 工具、客户端与问题

提示:直接输入 Claude、Codex、IEPL、订阅失败 等关键词。也可以打开 搜索页。