网站 / 开发者

GitHub 慢与图片裂:Git 代理与镜像配置

GitHub 的问题分两种:网页与 git 命令慢(域名解析与握手被拦),以及 README 图片裂开(图片 CDN 域名被单独阻断)。两者处理方式不同。

本篇要点
  • 网页能开但 clone 慢,是 Git 没走代理,不是网络不行。
  • 给 Git 单独配 http.proxy 最直接,比改系统代理稳。
  • raw 与图片裂开是另一回事,多与 CDN 域名被拦有关。
Git 代理镜像源4 类工具

两个问题,两种原因

  • 网页与 git 慢:github.com 的解析与握手被干扰,表现为页面转圈、clone 只有几十 KB/s
  • 图片裂开:README 的图片托管在独立域名(raw / avatars),该域名被单独阻断,页面本身能开

给 Git 单独配代理

终端默认不读系统代理。把 git 的流量指向本地代理端口,比全局改环境变量更精准:

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

# 取消
git config --global --unset http.proxy
git config --global --unset https.proxy

# 查看当前设置
git config --global --get http.proxy

端口号以客户端的混合端口为准(常见 7890)。如果只对 GitHub 生效、不影响公司内网仓库,用 --global 之外的按仓库配置更稳妥。

图片裂开的处理

  1. 确认是图片域名被拦:单独在浏览器打开一张图片链接,看是否超时
  2. 让规则覆盖 GitHub 相关域名(github.com、githubusercontent.com)
  3. 或改用安全 DNS 解析这些域名
  4. 仍不行时,把该页面的图片走代理加载(开 TUN 最省事)

开发工具镜像与代理

不必每个都走代理,多数生态有国内镜像。下表按工具列:

工具典型报错处理方式
Docker Hubdial tcp: i/o timeout配置镜像加速器,或给 Docker Desktop 设 HTTP Proxy
npm / pnpmETIMEDOUTnpm config set registry https://registry.npmmirror.com
pip / PyPIConnection reset / 403pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <包名>
Cargospurious network error在 config.toml 里配置国内 crates 镜像源
Hugging FaceHfHubHTTPError设置环境变量 HF_ENDPOINT 指向镜像站
Go modulesunrecognized import path设置 GOPROXY 为国内代理地址
镜像只解决下载速度,不解决需要真实地区身份的服务(例如某些 API 的注册与调用)。

怎么验证生效

git config --global --get http.proxy     # 应输出你设置的地址
curl -I https://github.com                   # 应返回 200
npm config get registry                       # 应输出镜像地址

大仓库怎么少下点

几十 GB 的仓库先浅克隆:--depth 1 只取最新一次提交,--filter=blob:none 做部分克隆,把历史文件留到需要时再取。先跑起来,确实要查历史再 git fetch --unshallow 补回。这比反复重试完整克隆省时间,也少受中途断流影响。

常见问题

配了代理 git 还是慢?

看是不是 SSH 方式克隆。SSH 走 22 端口,http.proxy 对它无效,需要单独配 ProxyCommand 或改用 HTTPS。

图片裂开会自己好吗?

不会。那个域名被单独处理,只有让它的请求走代理或换解析才恢复。

镜像源安全吗?

主流镜像(高校与云厂商)可信度高。不要在镜像站登录你的私有仓库账号。

公司内网仓库会不会被代理影响?

会。把公司域名加入直连规则,或只对 github.com 配代理。

需要一直开着代理吗?

拉代码时开即可。日常提交走内网或已缓存的路径,不必常开。

这些配置会留下痕迹吗?

git 的代理写在全局配置文件里,团队协作时注意别把带内网地址的配置提交进仓库。

Google 的问题不太一样

搜索、邮件与学术检索的阻断方式各不相同。