Git设置代理

发表于 更新于

一、问题诊断与协议识别

当克隆（git clone）或拉取/推送（git pull/git push）远程仓库时，如果遇到速度极慢、频繁超时甚至失败的情况，很可能是网络连接问题。此时，为 Git 配置代理是有效的解决方案。

首先，识别你使用的 Git 远程协议：

  • HTTP/HTTPS 协议：远程地址以 http:// 或 https:// 开头。
    1
    https://github.com/user/repo.git
  • SSH 协议：远程地址以 git@ 或 ssh:// 开头。
    1
    git@github.com:user/repo.git

代理类型：你需要知道本地代理软件提供的协议和端口，通常是 HTTP/HTTPS 代理 或 SOCKS5 代理。

二、为 HTTP/HTTPS 协议配置代理

此方法通过 Git 自身的配置项设置代理，适用于使用 http:// 或 https:// 地址的仓库。

2.1 为所有仓库设置全局代理

1
2
3
4
5
# 设置 HTTP/HTTPS 代理（端口 7890 为例）
git config --global http.proxy http://127.0.0.1:7890

# 设置 SOCKS5 代理（端口 7891 为例）
git config --global http.proxy socks5://127.0.0.1:7891

参数说明：

  • --global：修改全局配置文件（~/.gitconfig），对所有仓库生效。
  • http://127.0.0.1:7890：代理地址和端口，请替换为你本地代理软件的实际设置。
  • 重要提示：Git 中 http.proxy 配置项同时作用于 http:// 和 https:// 协议，没有独立的 https.proxy 配置项。

2.2 为特定域名设置代理

如果只想为某个网站（如 GitHub）使用代理，可以针对性地配置。

1
2
3
4
5
# 为 GitHub 设置 HTTP/HTTPS 代理
git config --global http.https://github.com.proxy http://127.0.0.1:7890

# 为 GitHub 设置 SOCKS5 代理
git config --global http.https://github.com.proxy socks5://127.0.0.1:7891

优势：此配置仅影响对 github.com 的访问，其他仓库仍走直连，更灵活。

2.3 查看与取消代理配置

1
2
3
4
5
6
7
8
9
# 查看所有 Git 配置
git config --global --list
# 或查看具体的代理配置
git config --global --get http.proxy

# 取消全局代理设置
git config --global --unset http.proxy
# 取消针对 GitHub 的代理设置
git config --global --unset http.https://github.com.proxy

三、为 SSH 协议配置代理

当使用 git@ 格式的地址时，Git 依赖 SSH 进行通信。此时需要配置 SSH 客户端本身，通过修改 ~/.ssh/config 文件实现。

3.1 Linux 和 macOS 用户配置

编辑 ~/.ssh/config 文件（如果不存在则创建）：

1
nano ~/.ssh/config

针对 HTTP/HTTPS 代理：

1
2
3
Host github.com
    User git
    ProxyCommand nc -X connect -x 127.0.0.1:7890 %h %p

针对 SOCKS5 代理：

1
2
3
4
5
6
7
8
9
# 方式一：明确指定协议
Host github.com
    User git
    ProxyCommand nc -X 5 -x 127.0.0.1:7891 %h %p

# 方式二：默认协议（效果相同）
Host github.com
    User git
    ProxyCommand nc -x 127.0.0.1:7891 %h %p

参数详解：

  • Host github.com：指定此配置仅对访问 github.com 生效。可替换为 gitlab.com 等。
  • User git：SSH 连接用户，对于 Git 服务通常为 git。
  • ProxyCommand：指定通过代理建立连接的命令。
  • nc：netcat 命令，用于网络连接。
  • -X connect：指定使用 HTTP CONNECT 方法（用于 HTTPS 代理）。
  • -X 5：指定使用 SOCKS5 协议。
  • -x 127.0.0.1:port：指定代理服务器地址和端口。
  • %h %p：SSH 运行时自动替换为目标主机名和端口。

3.2 Windows 用户配置

Windows 系统通常使用 connect 工具（Git for Windows 自带）。编辑 ~/.ssh/config 文件（路径通常为 C:\Users\你的用户名\.ssh\config）。

针对 HTTP/HTTPS 代理：

1
2
3
Host github.com
    User git
    ProxyCommand connect -H 127.0.0.1:7890 %h %p

针对 SOCKS5 代理：

1
2
3
Host github.com
    User git
    ProxyCommand connect -S 127.0.0.1:7891 %h %p

参数说明：

  • connect：Git for Windows 自带的代理连接工具。
  • -H：指定 HTTP 代理。
  • -S：指定 SOCKS5 代理。

3.3 测试 SSH 连接

配置完成后，测试 SSH 是否能通过代理正常连接：

1
ssh -T git@github.com

如果看到类似 Hi username! You've successfully authenticated... 的成功提示，则配置正确。

四、综合配置示例与最佳实践

4.1 混合环境配置示例

假设你的环境是：

  • 对 GitHub 使用 SSH 协议 + SOCKS5 代理（端口 7891）。
  • 对 公司内网 GitLab 使用 HTTPS 协议直连。
  • 其他所有 HTTPS 仓库使用 HTTP 代理（端口 7890）。

对应配置：

  1. **SSH 配置 (~/.ssh/config)**：

    1
    2
    3
    4
    5
    6
    Host github.com
        User git
        ProxyCommand nc -x 127.0.0.1:7891 %h %p
    Host internal.gitlab.com
        User git
        # 无 ProxyCommand，表示直连

  2. Git 全局配置：

    1
    2
    3
    4
    # 为所有 HTTPS 仓库设置代理
    git config --global http.proxy http://127.0.0.1:7890
    # 排除公司内网 GitLab，让其直连
    git config --global http.http://internal.gitlab.com.proxy ""

4.2 快速切换脚本（高级用法）

可以创建 Shell 脚本或别名来快速启用/禁用代理。

1
2
3
# 在 ~/.bashrc 或 ~/.zshrc 中添加别名
alias git-proxy-on="git config --global http.proxy socks5://127.0.0.1:7891"
alias git-proxy-off="git config --global --unset http.proxy"

然后执行 source ~/.bashrc 后，即可通过 git-proxy-on 和 git-proxy-off 快速切换。

五、常见问题与故障排除

  1. 错误：Failed to connect to 127.0.0.1 port 7890: Connection refused
    原因：代理服务器未运行，或端口号错误。
    解决：确认本地代理软件（如 Clash、V2Ray）已启动，并检查其监听的端口号。

  2. 配置后速度反而变慢或失败
    原因：代理服务器不稳定或网络延迟高。
    解决：尝试更换代理节点，或对特定仓库使用直连（git config --unset）。

  3. 如何为 git:// 协议设置代理？
    git:// 协议使用 9418 端口，不常用且通常不支持代理。建议改用 HTTPS 或 SSH 协议。

  4. 公司内网环境注意事项
    如果公司网络已提供透明代理或强制使用自己的代理，可能需要联系 IT 部门获取正确的代理地址，并可能需要配置 no_proxy 环境变量来排除内部地址。

六、总结

场景 协议 配置位置 关键命令/配置
通用 HTTPS 仓库 HTTP/HTTPS Git 全局配置 git config --global http.proxy http://127.0.0.1:7890
特定 HTTPS 仓库 HTTP/HTTPS Git 全局配置 git config --global http.https://github.com.proxy ...
SSH 仓库 SSH ~/.ssh/config 文件 ProxyCommand nc -x 127.0.0.1:7891 %h %p

核心步骤：

  1. 确定协议：查看远程仓库地址是 https:// 还是 git@。
  2. 确定代理：弄清本地代理的协议（HTTP/HTTPS 或 SOCKS5）和端口。
  3. 对症下药：
    • HTTPS 协议：使用 git config 命令。
    • SSH 协议：编辑 ~/.ssh/config 文件。
  4. 测试验证：通过 git clone 一个小仓库或 ssh -T 测试连接。