Git代理设置与取消指南

作为开发者，我们常遇到企业内网或特殊网络环境下无法直接访问Git仓库的情况。本教程将详细介绍如何为Git设置代理（Proxy）以及如何取消代理配置，并提供常见问题排查方法。

一、为什么需要设置Git代理？

以下场景需要使用Git代理：

1. 企业内网限制直接访问外网
2. 国内访问GitHub等国外仓库速度缓慢
3. 需要通过特定代理服务器进行代码审计
4. 使用VPN时需配置代理规则

---

二、代理设置方法

2.1 全局代理配置（推荐）

bash
# 设置HTTP协议代理
git config --global http.proxy http://proxy.example.com:8080

# 设置HTTPS协议代理
git config --global https.proxy https://proxy.example.com:8080

# 带认证信息的代理（用户名/密码）
git config --global http.proxy http://user:[email protected]:8080

验证配置生效：

bash
git config --global --get http.proxy
git config --global --get https.proxy

2.2 项目级代理配置

进入项目目录后执行：

bash
git config http.proxy http://proxy.example.com:8080

2.3 代理协议说明

协议类型	适用场景	示例格式
HTTP	普通HTTP仓库	http://proxy.com:8080
HTTPS	HTTPS仓库/增强安全性	https://proxy.com:8080
SOCKS5	需要加密传输	socks5://proxy.com:1080

---

三、取消代理配置方法

3.1 通过命令取消

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

# 项目级取消（需进入项目目录）
git config --unset http.proxy

3.2 手动编辑配置文件

打开全局配置文件：

bash
# Windows
notepad %USERPROFILE%\.gitconfig

# Linux/macOS
nano ~/.gitconfig

删除包含以下内容的行：

ini
[http]
    proxy = http://proxy.example.com:8080
[https]
    proxy = https://proxy.example.com:8080

---

四、高级配置技巧

4.1 域名白名单配置

对特定域名禁用代理：

ini
[http "https://github.com/"]
    proxy = ""

4.2 临时禁用代理

单次命令禁用代理：

bash
git -c http.proxy= clone https://github.com/example/repo.git

4.3 SSH协议代理配置

编辑SSH配置文件 ~/.ssh/config：

Host github.com
    Hostname github.com
    User git
    ProxyCommand nc -x 127.0.0.1:1080 %h %p

---

五、常见问题排查

5.1 测试代理连通性

bash
curl -v -x http://proxy.example.com:8080 https://github.com

5.2 典型错误解决方案

错误提示：

fatal: unable to access 'https://github.com/.../': Failed to connect to proxy...

解决步骤：

1. 检查代理地址和端口是否正确
2. 验证代理服务器是否正常运行
3. 尝试关闭防火墙或杀毒软件
4. 使用git config --list检查配置冲突

---

六、代理配置原理

Git的代理设置存储在以下位置：

1. 全局配置：~/.gitconfig（Linux/macOS）或 %USERPROFILE%\.gitconfig（Windows）
2. 项目配置：.git/config

配置优先级（从高到低）：

1. 命令行临时参数
2. 项目级配置
3. 全局配置
4. 系统环境变量

---

七、安全注意事项

1. 避免在配置文件中明文存储密码
2. 定期检查代理服务器证书有效性
3. 企业环境建议使用专用代理账户
4. 重要项目建议使用SSH协议+代理组合

---