网络故障排查栏目问题解答
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 地址也走代理
仓库地址如果是 [email protected]:... 这种格式,走的是 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 文件下载慢
- 用浏览器下:浏览器一般会读系统代理,开着代理直接下就行。
- 在命令行里下:curl 可以用
-x参数指定代理,或者设置 HTTPS_PROXY 环境变量。 - 下到一半断了:换一个延迟低、丢包少的节点,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。