453 字
2 分钟
Git 配置代理访问 GitHub

在部分网络环境下,直接访问 GitHub 会出现拉取代码、克隆仓库连接超时、访问失败等问题

这种场景下为 Git 配置代理访问是最稳妥的解决方案

Git 原生内置代理配置能力,只需简单配置即可完成 Git 代理配置。同时支持 HTTP/HTTPS 代理 和 SOCKS5 代理

既可以设置全局代理让所有 Git 请求走代理通道,也能按需配置域名定向代理

例如仅针对github.com域名启用代理,兼顾使用灵活性与网络效率

一、设置代理#

1.1 仅对 GitHub 域名启用代理(推荐)#

其他仓库不走代理,避免影响日常内网、Gitee 等仓库使用

只让github.com的 HTTPS 请求走 HTTPS 代理

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

只让github.com的 HTTPS 请求走 SOCKS5 代理

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

1.2 全局 HTTPS 代理#

所有通过 HTTPS 协议的 Git 请求全部走 HTTPS 代理

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

所有通过 HTTPS 协议的 Git 请求全部走 SOCKS5 代理

Terminal window
git config --global https.proxy socks5://127.0.0.1:7890

二、取消代理#

2.1 取消 GitHub 专用代理#

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

2.2 取消全局 HTTPS 代理#

Terminal window
git config --global --unset https.proxy

2.3 一键清空所有 Git 代理#

Terminal window
git config --global --unset http.proxy
git config --global --unset https.proxy

三、带身份认证的代理(账号密码代理)#

若代理服务需要账号密码校验,在代理链接拼接用户名:密码@
注意:该账号是代理服务账号,和 GitHub 登录账号无关

Terminal window
git config --global http.https://github.com/.proxy http://username:password@127.0.0.1:7890
NOTE
  • 如果用户名或密码中包含特殊字符(如 @:#),需要进行 URL 编码:
    • @%40
    • :%3A
    • #%23
  • 例如密码 pa@ss:word 应写成:
    http://user:pa%40ss%3Aword@127.0.0.1:7890

四、查看当前代理配置#

确认代理是否生效:

Terminal window
git config --global --list

出现类似内容即生效:

http.https://github.com/.proxy=http://127.0.0.1:7890
Git 配置代理访问 GitHub
https://www.self4m.com/posts/git-http-https-proxy-github/
✍️作者
Self4m
📅发布于
2025-09-15
©️许可协议
CC BY-NC-SA 4.0

商业用途必须事先获得作者授权;
非商业用途可以使用,但必须注明出处;
若有改编需采用相同许可协议发布。