两个问题,两种原因
- 网页与 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 之外的按仓库配置更稳妥。
图片裂开的处理
- 确认是图片域名被拦:单独在浏览器打开一张图片链接,看是否超时
- 让规则覆盖 GitHub 相关域名(github.com、githubusercontent.com)
- 或改用安全 DNS 解析这些域名
- 仍不行时,把该页面的图片走代理加载(开 TUN 最省事)
开发工具镜像与代理
不必每个都走代理,多数生态有国内镜像。下表按工具列:
| 工具 | 典型报错 | 处理方式 |
|---|---|---|
| Docker Hub | dial tcp: i/o timeout | 配置镜像加速器,或给 Docker Desktop 设 HTTP Proxy |
| npm / pnpm | ETIMEDOUT | npm config set registry https://registry.npmmirror.com |
| pip / PyPI | Connection reset / 403 | pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <包名> |
| Cargo | spurious network error | 在 config.toml 里配置国内 crates 镜像源 |
| Hugging Face | HfHubHTTPError | 设置环境变量 HF_ENDPOINT 指向镜像站 |
| Go modules | unrecognized 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 的代理写在全局配置文件里,团队协作时注意别把带内网地址的配置提交进仓库。