Jacob's 百宝箱

Appearance

Git 代理配置 ​

问题场景 ​

在使用 Git 推送代码到 GitHub 时，可能会遇到以下错误：

bash
# 连接超时
Failed to connect to github.com port 443 after 21093 ms: Timed out

# 连接被重置
OpenSSL SSL_read: Connection was reset, errno 10054

这通常是因为网络环境无法直接访问 GitHub，需要通过代理（VPN）来连接。

问题原因 ​

即使开启了全局 VPN，Git 默认也不会使用系统代理，需要手动配置 Git 使用代理服务器。

解决方案 ​

1. 确认代理端口 ​

首先需要知道你的 VPN 客户端使用的本地代理端口：

  • Clash: 通常是 7890
  • V2rayN: 通常是 10808
  • 其他 VPN: 查看客户端的设置界面

2. 配置 Git 代理 ​

方式一：仅为 GitHub 配置（推荐） ​

这种方式只对 GitHub 使用代理，不影响其他 Git 仓库：

bash
# HTTP 代理（适用于大部分 VPN）
git config --global http.https://github.com.proxy http://127.0.0.1:端口号
git config --global https.https://github.com.proxy http://127.0.0.1:端口号

# SOCKS5 代理（V2rayN 推荐使用）
git config --global http.https://github.com.proxy socks5://127.0.0.1:10808
git config --global https.https://github.com.proxy socks5://127.0.0.1:10808

方式二：全局配置 ​

对所有 Git 仓库使用代理：

bash
# HTTP 代理
git config --global http.proxy http://127.0.0.1:端口号
git config --global https.proxy http://127.0.0.1:端口号

# SOCKS5 代理
git config --global http.proxy socks5://127.0.0.1:端口号
git config --global https.proxy socks5://127.0.0.1:端口号

3. 验证配置 ​

查看当前代理配置：

bash
# 查看 GitHub 专用代理
git config --global --get http.https://github.com.proxy

# 查看全局代理
git config --global --get http.proxy

4. 取消代理配置 ​

当不需要代理时（比如关闭 VPN 后）：

bash
# 取消 GitHub 专用代理
git config --global --unset http.https://github.com.proxy
git config --global --unset https.https://github.com.proxy

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

5. 临时使用代理（推荐）⭐ ​

如果不想设置全局配置，可以在需要时临时使用代理，这样更灵活：

方式一：使用环境变量（一行命令） ​

bash
# 临时使用 SOCKS5 代理推送
ALL_PROXY=socks5://127.0.0.1:10808 git push

# 临时使用 HTTP 代理推送
https_proxy=http://127.0.0.1:7890 git push

# 临时使用代理克隆
ALL_PROXY=socks5://127.0.0.1:10808 git clone https://github.com/xxx/xxx.git
powershell
# 临时使用 SOCKS5 代理推送
$env:ALL_PROXY="socks5://127.0.0.1:10808"; git push

# 临时使用 HTTP 代理推送
$env:https_proxy="http://127.0.0.1:7890"; git push

# 临时使用代理克隆
$env:ALL_PROXY="socks5://127.0.0.1:10808"; git clone https://github.com/xxx/xxx.git

方式二：设置当前会话的环境变量 ​

bash
# 设置环境变量（对当前终端会话有效）
export ALL_PROXY=socks5://127.0.0.1:10808

# 后续所有 Git 命令都会使用代理
git push
git clone https://github.com/xxx/xxx.git

# 使用完后取消
unset ALL_PROXY
powershell
# 设置环境变量（对当前 PowerShell 会话有效）
$env:ALL_PROXY="socks5://127.0.0.1:10808"

# 后续所有 Git 命令都会使用代理
git push
git clone https://github.com/xxx/xxx.git

# 使用完后取消
Remove-Item Env:ALL_PROXY

方式三：使用 Git 命令行参数（跨平台通用） ​

bash
# 临时为单次命令设置代理（Bash 和 PowerShell 都适用）
git -c http.proxy=socks5://127.0.0.1:10808 push
git -c http.proxy=socks5://127.0.0.1:10808 clone https://github.com/xxx/xxx.git

优势 ​

  • ✅ 不需要修改全局配置
  • ✅ 关闭代理后不影响 Git 操作
  • ✅ 可以灵活切换是否使用代理
  • ✅ 适合偶尔需要访问 GitHub 的场景

常见问题 ​

错误：Proxy CONNECT aborted ​

bash
fatal: unable to access 'https://github.com/xxx.git/': Proxy CONNECT aborted

原因：使用了错误的代理协议。

解决：将 http:// 改为 socks5://，特别是 V2rayN 用户。

关闭 VPN 后无法推送 ​

原因：Git 仍然尝试连接已配置的代理地址，但代理服务已关闭。

解决方案：

  1. 取消代理配置（见上文"取消代理配置"）
  2. 或使用临时代理方式，不设置全局配置（推荐）

如何选择代理配置方式？ ​

使用场景推荐方式说明
偶尔访问 GitHub临时使用代理最灵活，不影响其他操作
经常访问 GitHubGitHub 专用代理只对 GitHub 生效
所有仓库都需要代理全局代理影响所有 Git 操作
代理经常开关临时使用代理避免频繁配置

快捷脚本 ⭐ ​

为了方便切换，可以创建两个批处理文件：

git-proxy-on.bat ​

bat
@echo off
git config --global http.https://github.com.proxy socks5://127.0.0.1:10808
git config --global https.https://github.com.proxy socks5://127.0.0.1:10808
echo Git 代理已开启
pause

git-proxy-off.bat ​

bat
@echo off
git config --global --unset http.https://github.com.proxy
git config --global --unset https.https://github.com.proxy
echo Git 代理已关闭
pause

使用时只需双击对应的批处理文件即可快速切换。

协议选择建议 ​

VPN 类型推荐协议配置示例
V2rayNSOCKS5socks5://127.0.0.1:10808
ClashHTTPhttp://127.0.0.1:7890
其他先试 HTTP，不行再试 SOCKS5-

总结 ​

  1. Git 不会自动使用系统代理，需要手动配置
  2. 推荐使用临时代理方式，更灵活且不影响其他操作
  3. 如果经常访问 GitHub，可以只为 GitHub 配置代理
  4. V2rayN 用户建议使用 SOCKS5 协议
  5. 如果设置了全局代理，关闭 VPN 后记得取消配置
  6. 可以使用批处理脚本快速切换代理状态

推荐配置方案 ​

最佳实践：不设置全局配置，需要时临时使用

bash
# 需要访问 GitHub 时
ALL_PROXY=socks5://127.0.0.1:10808 git push
ALL_PROXY=socks5://127.0.0.1:10808 git clone https://github.com/xxx/xxx.git

# 不需要代理时
git push  # 直接使用，无需任何配置
powershell
# 需要访问 GitHub 时
$env:ALL_PROXY="socks5://127.0.0.1:10808"; git push
$env:ALL_PROXY="socks5://127.0.0.1:10808"; git clone https://github.com/xxx/xxx.git

# 不需要代理时
git push  # 直接使用，无需任何配置

这样可以避免因代理关闭导致的推送失败问题。