GitHub 访问慢、git clone 失败怎么办:git 代理的正确写法
常见报错分别是什么意思
先看报错属于哪一类,再决定改哪里。
| 报错关键字 | 含义 | 该看哪一节 |
|---|---|---|
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 的时候,连接是建立了的,问题出在传输过程中断流。常见原因是节点不稳定、晚高峰丢包,或者节点正好发生了自动切换。
- 在客户端把节点从「自动选择」改为手动固定一个;
- 换一个延迟和负载更低的节点再试;
- 只需要最新代码时用浅克隆,传输量会小很多:
git clone --depth 1 仓库地址; - 之后需要完整历史,再执行
git fetch --unshallow补全。
晚上尤其容易断的话,属于线路问题,原因见晚高峰网速慢。
浏览器里打开 GitHub 也慢
如果不只是 git,连网页都加载缓慢、图片和头像显示不出来,问题就不在 git 的配置上。
- 模式和节点: 确认客户端处于规则模式并且选中了可用节点。节点负载高时,换同地区的另一个节点对比。
- 静态资源走了直连: GitHub 页面上的头像、图片、代码文件预览来自另外几个域名。规则太旧时,这些域名可能没有被列入代理,于是页面框架出来了,内容却一直转圈。更新订阅通常能解决。
- DNS 解析结果不对: 本地 DNS 返回了错误的地址时,表现为时通时不通。按 Clash DNS 设置检查客户端的 DNS 配置。
- GitHub 自身故障: 偶尔是服务端的问题,官方状态页会有说明,这时等待即可。
网页恢复正常之后,再回头处理 git 和下载的问题,判断起来会清楚很多。
下载 release 文件很慢
网页能打开,点下载 release 里的安装包却只有很低的速度,原因通常是分流规则。GitHub 的 release 附件、源码压缩包、raw 文件并不是从 github.com 这个域名下载的,而是由 GitHub 的另外几个域名提供。如果你使用的规则只把 github.com 列入代理,这些下载域名就可能被判定为直连。
处理办法:
- 在客户端的连接或日志页面,找到下载请求实际访问的域名,看它命中的是直连还是代理;
- 命中直连的话,更新订阅和规则,或者在规则里补上对应域名,写法见规则分流;
- 临时应急,可以把模式切到全局下载,下完再切回规则模式;
- 在终端里下载,用
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日,未经本站实测,购买前请以官网为准。整理方法见这里。
接着读
ChatGPT 反复验证、Too Many Requests 原因:网络角度解释
从网络角度解释 ChatGPT 反复验证、Too Many Requests 的原因:共享 IP 请求密集、IP 频繁切换、数据中心 IP 信誉等,并说明固定节点、换同地区节点、减少并发等做法,账号与地区政策以官方为准。
Claude Code 代理设置、Codex CLI 代理:TUN 与长任务断连
Claude Code 代理设置、Codex CLI 代理都依赖终端网络环境:本文讲代理环境变量与 TUN 模式两种方案,长任务中节点切换导致断连的处理方法,以及企业网络与证书问题的一般思路。
Cursor 代理设置教程:Cursor 连接失败、对话中断的原因与排查顺序
Cursor 代理设置与 Cursor 连接失败排查:如何在设置里配置 http.proxy,什么时候改用 TUN 模式,长连接为什么会被节点自动切换打断,并给出一套从易到难的排查顺序。
Docker 代理设置教程:拉取镜像、构建镜像、容器内三种情况分别怎么配
Docker 代理设置分三种场景:docker pull 超时要给守护进程配代理,构建镜像时用 build-arg 传入,容器运行时用环境变量或 config.json。附各场景命令与 127.0.0.1 不通的原因。