问题背景
在开启 Clash Verge TUN 模式后，为了解决 GitHub 的 SSH 连接问题，之前配置了全局 Git 代理：
1
2
git config --global http.proxy "http://127.0.0.1:7897"
git config --global https.proxy "http://127.0.0.1:7897"
随后在拉取内网 GitLab 仓库时遇到错误：
1
2
fatal: unable to access 'http://bitcentos.jzfz.local/run/jzfz.platform.specialproject.git/':
Failed to connect to bitcentos.jzfz.local port 80 via 127.0.0.1 after 2053 ms: Could not connect to server
问题分析
表面问题
- Git 尝试通过代理连接内网地址
- 代理服务器无法访问内网（
bitcentos.jzfz.local）
隐藏问题
- 全局代理配置对所有 Git 仓库生效
- 内网地址不应走代理，需要直连
- Git 代理配置的优先级和作用范围
解决过程
第一次尝试：仅对 GitHub 配置代理
1
2
3
4
5
6
7
# 取消全局代理
git config --global --unset http.proxy
git config --global --unset https.proxy
# 只对 GitHub 单独配置代理
git config --global http.https://github.com.proxy "http://127.0.0.1:7897"
git config --global https.https://github.com.proxy "http://127.0.0.1:7897"
结果：仍然失败，因为项目级别可能还有代理配置。
第二次尝试：在项目目录禁用代理
1
2
3
cd /path/to/internal/project
git config http.proxy ""
git config https.proxy ""
在项目目录下执行：
1
2
git config http.proxy ""
git config https.proxy ""
结果：成功解决，项目可以正常 git pull。
技术知识点
Git 代理配置层级
Git 代理配置有三个层级，按优先级从高到低：
- 仓库级配置（项目目录下
.git/config或git config）1
git config http.proxy "" - 全局级配置（
~/.gitconfig）1
git config --global http.proxy "http://proxy:port"
- 系统级配置（
/etc/gitconfig）1
git config --system http.proxy "http://proxy:port"
代理配置的清除
1
2
3
4
5
6
7
# 清除全局代理
git config --global --unset http.proxy
git config --global --unset https.proxy
# 清除当前仓库代理
git config --unset http.proxy
git config --unset https.proxy
只对特定域名配置代理
可以使用 url.<base>.insteadOf 来实现更精细的控制：
1
2
3
# GitHub 走代理，其他直连
git config --global http.https://github.com.proxy "http://127.0.0.1:7897"
git config --global https.https://github.com.proxy "http://127.0.0.1:7897"
或者使用 insteadOf：
1
2
# 所有 github.com 的请求走 HTTPS
git config --global url."https://github.com/".insteadOf "git@github.com:"
经验总结
-
避免全局代理：尽量不要配置全局 Git 代理，这会影响所有仓库
-
分层配置：内网开发时，优先使用项目级或仓库级代理配置
- 常用场景配置：
- 外网 GitHub：配置代理或使用 GitHub CLI
- 内网 GitLab：直连，不走代理
- 混合环境：按域名/项目单独配置
- 检查代理配置的顺序：
1 2
# 查看各层级代理配置 git config --list --show-origin
相关命令速查
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 查看当前所有代理配置
git config --list --show-origin | grep proxy
# 清除全局代理
git config --global --unset http.proxy
git config --global --unset https.proxy
# 清除当前仓库代理
git config --unset http.proxy
git config --unset https.proxy
# 只对 GitHub 配置代理
git config --global http.https://github.com.proxy "http://127.0.0.1:7897"
# 对特定项目禁用代理
cd /path/to/project
git config http.proxy ""
git config https.proxy ""
本文记录于 2026-03-30
