实战教程 (TYPE-C) Git / GitHub 命令行走代理加速配置：HTTP 与 SSH 双通道全景实战

对于广大的软件开发者、科研人员以及开源爱好者而言，GitHub 是日常代码托管与协作的核心基础设施。然而，国内网络环境直接访问 GitHub 经常遭遇：

• Failed to connect to github.com port 443: Timed out
• OpenSSL SSL_read: Connection was reset, errno 10054
• ssh: connect to host github.com port 22: Connection timed out

许多开发者困惑于：“明明电脑上已经打开了 Clash 或其他代理软件，为什么在终端里输入 git clone 依然奇慢无比甚至直接报错？”

本文将深入解释操作系统命令行与代理客户端的通信盲区，并为您提供 HTTP(S) 协议与 SSH 协议双通道 的生产级配置方案。

---

一、 为什么开启了代理软件，命令行 Git 依然断网？

graph TD
    User[开发者在终端执行 git clone] --> Check[Git 客户端读取网络配置]
    
    Check -->|未配置 git config 环境变量| Direct[直接发起公网请求]
    Direct -->|遇到公网阻断与超时| Fail[报错: Timed out / Connection reset]
    
    Check -->|已配置 HTTP 代理 127.0.0.1:7890| ProxyHTTP[走本地 HTTP 代理]
    Check -->|SSH 配置文件 ~/.ssh/config 挂载 ProxyCommand| ProxySSH[走本地 Socks5 代理]
    
    ProxyHTTP --> LocalCore[Clash / Sing-box 客户端]
    ProxySSH --> LocalCore
    LocalCore --> HighSpeed[极速拉取 GitHub 仓库 (50-100 MB/s)]

核心本质：

1. Windows 系统代理只对遵循 WinINet API 的软件（如 Edge/Chrome）生效，命令行终端工具（如 cmd、PowerShell、bash、git）默认不会主动读取系统代理注册表。
2. Git 支持两种不同的传输协议（HTTPS 与 SSH），两者的代理机制完全独立：
   • https://github.com/user/repo.git 走 HTTP/HTTPS 代理配置。
   • [email protected]:user/repo.git 走底层 OpenSSH 客户端配置。

---

二、 HTTP / HTTPS 通道配置实战

假设本地代理客户端监听的本地端口为：127.0.0.1:7890。

1. 最佳实践：仅对 GitHub 域名开启代理（强烈推荐）

避免将访问国内 Gitee、公司内网 GitLab 或局域网私有仓库的流量错误地导入代理：

# 仅针对 github.com 域名设置 HTTP 与 HTTPS 代理
git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890

# 或者使用 Socks5 协议
git config --global http.https://github.com.proxy socks5://127.0.0.1:7890
git config --global https.https://github.com.proxy socks5://127.0.0.1:7890

2. 全局代理配置（对所有 Git 操作生效）

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

3. 取消与清除代理

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

---

三、 SSH 协议通道配置实战 ([email protected]:...)

如果使用 SSH 密钥免密克隆代码，上述 http.proxy 配置将完全不生效。必须配置 OpenSSH 客户端的配置文件。

编辑用户主目录下的 SSH 配置文件：

• Windows 路径：C:\Users\<你的用户名>\.ssh\config
• macOS / Linux 路径：~/.ssh/config

（如果 .ssh 目录下不存在 config 文件，可直接手动新建一个无扩展名的文本文件）。

1. Windows 系统配置内容：

# GitHub SSH 代理配置 (Windows)
Host github.com
    HostName ssh.github.com
    Port 443
    User git
    # 使用 Windows Git 自带的 connect.exe 转发至本地 Socks5/HTTP 端口
    ProxyCommand connect -S 127.0.0.1:7890 %h %p

2. macOS / Linux 系统配置内容：

# GitHub SSH 代理配置 (macOS / Linux)
Host github.com
    HostName github.com
    User git
    # 使用系统自带的 nc (netcat) 工具
    ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p

---

四、 连通性测试与验证

在终端中执行以下验证命令：

# 验证 SSH 代理连通性
ssh -T [email protected]

若返回如下提示，即表示 SSH 代理链路已 100% 打通成功：

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

随后克隆一个大型仓库测试下载速度：

git clone --depth=1 https://github.com/torvalds/linux.git

---

五、 常见问题深度解答 (FAQ 10 问 10 答)

1. 开启了 Clash Verge 的 TUN 模式，还需要手动配置 Git 代理吗？

如果 TUN 模式已经正确开启并接管整机网络层，Git 命令行会自动通过 TUN 虚拟网卡透明走代理，此时无需手动执行 git config 代理命令。但在某些未开启 TUN 的纯系统代理环境下，手动配置依然是最稳妥的兜底方案。

2. 为什么设置了代理后报错“SSL certificate problem: self signed certificate”？

这是由于某些代理工具或局域网中间人抓包（如 Fiddler/Charles）替换了 HTTPS 证书导致 Git 校验失败。临时解决命令（不推荐生产使用）：git config --global http.sslVerify false；更规范的做法是将代理工具的根证书导入系统证书受信任根列表。

3. 在 Windows 上配置 ProxyCommand 提示“'connect' 不是内部或外部命令”怎么办？

说明 Git 安装目录下的 bin 路径未加入环境变量。将 ProxyCommand connect ... 改为完整绝对路径，例如：ProxyCommand "C:\Program Files\Git\mingw64\bin\connect.exe" -S 127.0.0.1:7890 %h %p。

4. 为什么克隆超大仓库依然经常报“RPC failed; curl 56 GnuTLS recv error”？

这是由于 Git 本地缓冲区过小发生内存溢出。执行以下命令增大 Git 传输缓冲区大小至 1GB：git config --global http.postBuffer 1048576000。

---

六、 关联教程与网络排错

• 客户端全流量接管：Clash Verge Rev 开启 TUN 模式指南
• 子系统网络共享：WSL2 镜像网络模式配置教程
• 知识库总览：代理客户端与网络加速教程中心