AI 与开发工具网络

GitHub 访问慢、git clone 失败怎么办:git 代理的正确写法

更新于 · 约 15 分钟读完 · 登机口编辑整理

常见报错分别是什么意思

先看报错属于哪一类,再决定改哪里。

报错关键字 含义 该看哪一节
Failed to connect to github.com port 443 HTTPS 连接建立不起来,git 没走代理或代理不通 HTTPS 代理
Connection timed out、Connection was reset 连接超时或被中断 HTTPS 代理
RPC failed、early EOF、transfer closed 连上了,但传输中途断开,多见于大仓库 大仓库与断流
ssh: connect to host github.com port 22 超时 SSH 的 22 端口不通 SSH 代理
Connection refused,地址是 127.0.0.1 代理端口填错,或客户端没在运行 核对端口
Permission denied (publickey) 网络是通的,SSH 密钥没配好 与代理无关

最后一类不是网络问题,改代理没有用,需要检查 SSH 密钥是否已添加到 GitHub 账号。

先分清仓库地址用的是哪种协议

git 有两种常用的远程地址,走代理的方式完全不同:

  • HTTPS: https://github.com/用户名/仓库.git
  • SSH: git@github.com:用户名/仓库.git

git config 里的 http.proxy 只对 HTTPS 地址起作用。很多人设置了代理仍然失败,就是因为仓库用的是 SSH 地址。在仓库目录里执行 git remote -v 可以看到当前用的是哪一种。

下面的命令都用 7890 作为本地代理端口的例子,请换成你自己客户端设置页显示的端口。

HTTPS 仓库:只让 github.com 走代理

推荐写法,仅对 GitHub 生效:

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

这条配置的意思是:访问 https://github.com 开头的地址时使用这个代理,其他地址照常直连。公司内网仓库、国内代码托管平台都不受影响。

全局写法,所有 HTTPS 仓库都走代理:

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

http.proxy 这一项同时覆盖 http:// 和 https:// 地址,不需要再另外设置一项。

只想临时用一次,不写入配置:

git -c http.proxy=http://127.0.0.1:7890 clone https://github.com/用户名/仓库.git

客户端提供 SOCKS5 端口时,也可以把地址写成 socks5h://127.0.0.1:7890。带 h 表示域名由代理端解析,可以避开本地 DNS 解析结果不对的问题。

设置完,用一个小仓库测试一下能否 clone 成功。

SSH 仓库:在 ssh config 里配置 ProxyCommand

SSH 协议不读 git 的代理配置,也不读 http_proxy 环境变量。它有自己的配置文件 ~/.ssh/config,通过 ProxyCommand 指定「连接之前先经过哪个程序转发」。

macOS / Linux,用系统自带的 nc,经由 SOCKS5 端口:

Host github.com
    HostName github.com
    User git
    ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p

其中 -X 5 表示使用 SOCKS5 协议,-x 后面是代理地址,%h 和 %p 会被自动替换成目标主机和端口。如果想走 HTTP 代理,把 -X 5 换成 -X connect。不同系统自带的 nc 版本不一样,个别发行版的 nc 不支持这些参数,需要安装 OpenBSD 版本的 netcat。

Windows,Git for Windows 自带一个 connect 工具,在 Git Bash 环境下可以这样写:

Host github.com
    HostName github.com
    User git
    ProxyCommand connect -S 127.0.0.1:7890 %h %p

-S 表示 SOCKS 代理,换成 -H 则是 HTTP 代理。

另一个思路:让 SSH 走 443 端口。 有些网络只是封了 22 端口。GitHub 官方提供了通过 443 端口连接 SSH 的方式:

Host github.com
    HostName ssh.github.com
    Port 443
    User git

配置完成后,执行 ssh -T git@github.com 测试。看到带有你用户名的欢迎信息,说明连接和密钥都没问题。

如果觉得这些配置麻烦,有两条更省事的路:把远程地址改成 HTTPS(git remote set-url origin https://github.com/用户名/仓库.git),或者在客户端开启 TUN 模式,SSH 流量也会被一并接管,见系统代理与 TUN 模式。

大仓库 clone 到一半断开

报 RPC failed、early EOF 的时候,连接是建立了的,问题出在传输过程中断流。常见原因是节点不稳定、晚高峰丢包,或者节点正好发生了自动切换。

  1. 在客户端把节点从「自动选择」改为手动固定一个;
  2. 换一个延迟和负载更低的节点再试;
  3. 只需要最新代码时用浅克隆,传输量会小很多:git clone --depth 1 仓库地址;
  4. 之后需要完整历史,再执行 git fetch --unshallow 补全。

晚上尤其容易断的话,属于线路问题,原因见晚高峰网速慢。

浏览器里打开 GitHub 也慢

如果不只是 git,连网页都加载缓慢、图片和头像显示不出来,问题就不在 git 的配置上。

  • 模式和节点: 确认客户端处于规则模式并且选中了可用节点。节点负载高时,换同地区的另一个节点对比。
  • 静态资源走了直连: GitHub 页面上的头像、图片、代码文件预览来自另外几个域名。规则太旧时,这些域名可能没有被列入代理,于是页面框架出来了,内容却一直转圈。更新订阅通常能解决。
  • DNS 解析结果不对: 本地 DNS 返回了错误的地址时,表现为时通时不通。按 Clash DNS 设置检查客户端的 DNS 配置。
  • GitHub 自身故障: 偶尔是服务端的问题,官方状态页会有说明,这时等待即可。

网页恢复正常之后,再回头处理 git 和下载的问题,判断起来会清楚很多。

下载 release 文件很慢

网页能打开,点下载 release 里的安装包却只有很低的速度,原因通常是分流规则。GitHub 的 release 附件、源码压缩包、raw 文件并不是从 github.com 这个域名下载的,而是由 GitHub 的另外几个域名提供。如果你使用的规则只把 github.com 列入代理,这些下载域名就可能被判定为直连。

处理办法:

  1. 在客户端的连接或日志页面,找到下载请求实际访问的域名,看它命中的是直连还是代理;
  2. 命中直连的话,更新订阅和规则,或者在规则里补上对应域名,写法见规则分流;
  3. 临时应急,可以把模式切到全局下载,下完再切回规则模式;
  4. 在终端里下载,用 curl -L -x http://127.0.0.1:7890 -O 文件地址,-L 表示跟随跳转,不能省。

网上有不少第三方的 GitHub 加速镜像。它们相当于替你中转下载,文件是否被改动你无从验证。下载可执行程序时,尽量从官方地址获取,并核对发布页提供的校验值。

查看与取消设置

查看当前 git 里和代理有关的配置:

git config --global --get-regexp proxy

取消:

git config --global --unset http.https://github.com.proxy
git config --global --unset http.proxy

SSH 的配置则是到 ~/.ssh/config 里删除或注释掉对应的 ProxyCommand 一行。

提醒一点:这些配置是写死的。客户端没开的时候,git 会因为连不上本地代理端口而报 Connection refused。如果你长期开着 TUN 模式,就不需要这些配置,取消掉更省心。

连上了但报 TLS 或 HTTP/2 相关的错误

除了超时和断流,还有一类报错发生在握手或协议层。它们的共同点是:代理多半已经生效了,问题出在这条链路的质量或中间环节上。

报错关键字 一般原因 处理
SSL_read、gnutls_handshake() failed、schannel: failed to receive handshake TLS 握手过程中连接被中断 换节点重试;确认端口填的是客户端的代理端口
HTTP/2 stream 相关、curl 92 传输用的 HTTP/2 连接被中途打断 换节点;或让 git 改用 HTTP/1.1
SSL certificate problem 证书校验不通过 检查是否处在会替换证书的网络或软件环境里

让 git 改用 HTTP/1.1 的写法:

git config --global http.version HTTP/1.1

这只是换一种传输方式来避开问题,线路本身不稳的话仍然可能断,恢复默认用 git config --global --unset http.version。

证书校验失败时,网上常见的建议是执行 git config --global http.sslVerify false。不要这样做。这等于让 git 不再确认对面是不是真的 GitHub,之后拉到的代码有没有被替换就无从保证。证书报错通常出现在两种环境里:公司网络会检查加密流量,或者本机有软件在做 HTTPS 解密。前者需要按公司 IT 的要求配置证书,后者关掉对应的功能即可。

想看 git 到底有没有走代理、卡在哪一步,可以在 Git Bash 或 macOS、Linux 的终端里临时打开调试输出:

GIT_CURL_VERBOSE=1 git ls-remote https://github.com/用户名/仓库.git

输出里会显示它连接的是本地代理地址还是直接连 GitHub。git ls-remote 只读取远程的分支列表,不下载内容,适合拿来做测试。

另外,git 访问 HTTPS 仓库时也会读取 https_proxy、all_proxy 这类环境变量;git config 里设了 http.proxy 的话,以 git 的配置为准。两处的端口写得不一致,是「明明设了代理却连不上」的一个常见原因。

网上流传的其他办法,哪些有用

搜这个问题会看到很多五花八门的方案,逐个说一下:

  • 调大 http.postBuffer。 这个配置项控制的是 git 通过 HTTP 向远程提交数据时的缓冲区大小,影响的是 push。clone 失败是下载方向的问题,改它没有作用。
  • 把仓库导入国内代码托管平台再 clone。 可行,相当于让那个平台替你下载一次。缺点是多一步操作,导入的副本不会自动跟随原仓库更新,只适合临时拉一次代码看看。私有仓库和公司代码不要这样处理。
  • 在网页上下载 ZIP 压缩包。 只需要某个版本的源码时最省事,但拿到的不是 git 仓库,没有提交历史,也不能直接 pull 更新。
  • 部分克隆。 仓库历史很长、文件很多时,git clone --filter=blob:none 仓库地址 只先下载提交记录和目录结构,文件内容用到时再取,初次传输量比完整克隆小得多,又保留了完整历史,比浅克隆更适合之后还要参与开发的情况。
  • 改 hosts、用加速前缀。 前面已经说过,前者会过期,后者无法验证文件是否被改动,都不推荐作为长期方案。

常见问题

设置了 http.proxy,git clone 还是超时,为什么?

按顺序检查三件事:仓库地址是不是 SSH 格式;端口号是否和客户端一致;客户端当前节点能否正常访问 GitHub。可以用 curl -I -x http://127.0.0.1:7890 https://github.com 单独验证代理本身通不通。

git push 很慢或者失败,和 clone 的处理一样吗?

一样。push 和 clone 走的是同一条连接、同一套代理配置。push 大文件失败时,除了网络,也要留意 GitHub 对单个文件大小有限制,这种情况报错信息里会明确写出来。

要不要用修改 hosts 文件的办法?

不推荐。hosts 里写死的 IP 会过期,过期之后的表现是莫名其妙连不上,而且很难想起来是它的原因。走代理是更稳定、也更容易撤销的做法。

调大 http.postBuffer 能解决 git clone 失败吗?

不能。这个配置项只影响通过 HTTP 推送数据时的缓冲区,对 clone 这种下载操作没有作用。clone 中途断开要从节点稳定性、浅克隆或部分克隆这几个方向处理。

可以关闭 SSL 校验来解决证书报错吗?

不建议。关闭校验之后,git 不再验证服务器身份,中间环节替换内容也不会被发现。应该先弄清证书为什么不被信任,是公司网络的证书检查还是本机软件在解密 HTTPS,再对应处理。

git clone 走代理会消耗机场流量吗?

会。经过节点的下载都计入套餐流量,克隆大仓库、拉大体积的 release 文件消耗比较明显。只看代码不需要历史的时候用浅克隆,可以省下不少。

其他命令行工具也拉不下来依赖,要一个个设置吗?

可以逐个设置,方法见终端代理设置教程。工具多的话,直接开 TUN 模式更省事。

接下来看什么

节点选择会直接影响 clone 的稳定性,怎么测、怎么选见切换节点与延迟测试。

本文中的套餐与价格整理自公开资料,核对日期为 2026年11月14日,未经本站实测,购买前请以官网为准。整理方法见这里。

接着读