Git 代理配置完全指南

在使用 Git 进行版本控制时，我们经常需要与远程仓库（如 GitHub, GitLab, Gitee 等）进行交互，例如克隆（clone）、拉取（pull）、推送（push）等操作。然而，在某些网络环境下，由于防火墙、网络策略或地理限制等原因，直接连接到远程仓库可能会遇到困难。这时，配置代理就成为了解决问题的有效方法。

本文将为您提供一份 Git 代理配置的完全指南，详细介绍如何在不同场景下、针对不同协议配置 Git 使用代理，以及常见的配置方法、注意事项和故障排除技巧。

第一章：理解 Git 的网络通信与代理的需求

1.1 Git 如何与远程仓库通信

Git 支持多种协议与远程仓库进行通信：

HTTP/HTTPS: 这是目前最常用的协议。通过 HTTP 或 HTTPS 克隆、拉取、推送仓库。GitHub、GitLab、Gitee 等平台默认都支持并推荐使用 HTTPS。这种方式通常端口为 80 (HTTP) 或 443 (HTTPS)，与我们平时浏览网页使用的协议相同。
SSH: 另一种常用的协议，特别是在需要频繁推送代码或对安全性要求较高的场景。通过 SSH 连接需要配置 SSH 密钥。默认端口为 22。
Git 协议: 较少使用，通常用于公共仓库的只读访问，端口为 9418。

理解 Git 使用的协议非常重要，因为不同协议的代理配置方式是不同的。HTTP/HTTPS 协议的代理设置与大多数 HTTP 客户端类似，而 SSH 协议的代理设置则依赖于 SSH 客户端的配置。

1.2 为何需要为 Git 配置代理？

配置 Git 代理的主要原因包括：

穿越防火墙: 在企业或学校网络中，防火墙可能会限制或阻止直接访问外部的 Git 仓库服务（如 GitHub）。通过配置代理，可以将 Git 的网络请求转发到允许通过的代理服务器，再由代理服务器访问目标 Git 仓库。
访问内网资源: 如果您的 Git 仓库位于公司内网且无法直接从外部访问，您可能需要通过 VPN 或内部代理服务器来访问它。
安全监控与审计: 组织可能要求所有外部网络流量都必须通过代理服务器，以便进行监控、日志记录和安全扫描。
缓存: 某些代理服务器具备缓存功能，虽然对于 Git 的特定操作（如克隆大仓库）效果有限，但在拉取频繁更新的小仓库时可能略有帮助。
绕过地理限制: 在某些情况下，通过代理可以访问在特定地区受限的 Git 服务。
网络加速: 在跨国访问时，选择一个距离目标仓库更近或网络质量更好的代理服务器，有时可以提高连接速度。

1.3 代理的类型

常见的代理类型包括：

HTTP/HTTPS 代理: 工作在应用层（OSI 第7层），通常用于代理 HTTP 和 HTTPS 请求。大多数 Git 的 HTTP/HTTPS 操作可以直接使用这类代理。
SOCKS 代理: 工作在会话层（OSI 第5层），是一种更通用的代理协议，可以代理 TCP 和 UDP 连接，不限于特定的应用协议。SOCKS 代理常用于那些不直接支持 HTTP 代理的应用，或者需要代理非 HTTP/HTTPS 流量的场景。Git 的 HTTP/HTTPS 操作也可以通过 SOCKS 代理进行，通常需要客户端（Git）的支持，或者通过 wrapper 工具。
SSH 代理 (跳板机): 通过一个或多个 SSH 服务器进行中转来访问最终目标。这严格来说不是一个标准的“代理协议”，而是 SSH 客户端（如 OpenSSH）提供的一种连接中转机制，主要用于代理 SSH 协议的连接。

本文将重点讲解 Git 最常用的 HTTP/HTTPS 协议的代理配置，以及如何为 SSH 协议配置代理。SOCKS 代理也将提及其在 Git HTTP/HTTPS 中的应用。

第二章：Git HTTP/HTTPS 代理配置

Git 的 HTTP/HTTPS 代理配置是最常见的，也是相对简单的。主要有两种配置方式：通过 Git 自身的配置 (git config) 或通过环境变量。

2.1 使用 git config 命令配置代理

git config 是 Git 用来管理配置的命令，代理设置可以通过修改 Git 的配置文件来实现。配置文件有三个级别：

System (系统级): $(prefix)/etc/gitconfig。影响系统上所有用户的所有仓库。不常用。
Global (全局级): ~/.gitconfig 或 ~/.config/git/config。影响当前用户的所有仓库。最常用。
Local (本地级): .git/config 在仓库根目录下。仅影响当前仓库。优先级最高。

我们通常在全局级别配置代理，使其对当前用户的所有 Git 操作生效。

2.1.1 配置 HTTP 代理

如果您只需要为 HTTP 请求配置代理（较少见，因为大部分服务已迁移到 HTTPS），可以使用 http.proxy 设置：

“`bash

配置全局 HTTP 代理

格式：协议://[用户:密码@]主机:端口

git config –global http.proxy http://proxy.example.com:8080

如果代理需要用户名和密码

git config –global http.proxy http://user:[email protected]:8080

注意：将密码直接放在 URL 中不安全，会被记录在 ~/.gitconfig 文件中，

建议使用环境变量或更安全的凭证管理方式（虽然 Git 凭证助手主要用于仓库认证，而非代理认证）。

更好的做法是不在 URL 中包含密码，让 Git 在需要时提示输入，或者使用无需认证的代理。

取消全局 HTTP 代理设置

git config –global –unset http.proxy
“`

2.1.2 配置 HTTPS 代理

为 HTTPS 请求配置代理与 HTTP 类似，使用 https.proxy 设置。这是更常用的方式：

“`bash

配置全局 HTTPS 代理

格式：协议://[用户:密码@]主机:端口

git config –global https.proxy http://proxy.example.com:8080

注意：这里虽然是 HTTPS 代理，但代理服务器本身可能是通过 HTTP 协议进行连接的，

所以代理地址通常还是以 http:// 开头。但如果代理服务器本身是 HTTPS 代理，

则可以使用 https://。最常见的是使用 http:// 代理 HTTPS 流量。

如果代理需要用户名和密码

git config –global https.proxy http://user:[email protected]:8080 # 同上，安全警告

取消全局 HTTPS 代理设置

git config –global –unset https.proxy
“`

2.1.3 同时配置 HTTP 和 HTTPS 代理

为了全面覆盖，通常建议同时配置 HTTP 和 HTTPS 代理：

bash git config --global http.proxy http://proxy.example.com:8080 git config --global https.proxy http://proxy.example.com:8080

2.1.4 配置 SOCKS 代理 (通过 git config)

Git 也支持通过 git config 配置 SOCKS 代理，这需要 Git 版本支持，并且通常通过在代理地址中使用 socks4:// 或 socks5:// 方案来指定。

“`bash

配置全局 SOCKS5 代理

git config –global http.proxy socks5://127.0.0.1:1080

或者对于 HTTPS 流量

git config –global https.proxy socks5://127.0.0.1:1080

注意：这种方式的兼容性取决于你的 Git 版本和操作系统。

有些 Git 版本或库可能无法正确解析 socks:// scheme。

在这种情况下，使用环境变量（见 2.2.3 节）或 Wrapper 工具可能更可靠。

取消全局 SOCKS 代理设置

git config –global –unset http.proxy # 如果是配在 http.proxy
git config –global –unset https.proxy # 如果是配在 https.proxy
“`

2.1.5 配置特定仓库的代理 (本地级)

如果您只需要为 某个特定仓库 配置代理，可以在该仓库目录下使用 --local 参数（--local 是默认参数，可以省略）：

“`bash
cd /path/to/your/repo
git config http.proxy http://repo-proxy.example.com:8080
git config https.proxy http://repo-proxy.example.com:8080

取消本地仓库代理设置

cd /path/to/your/repo
git config –unset http.proxy
git config –unset https.proxy
“`

本地配置会覆盖全局配置。

2.1.6 查看当前的 Git 配置

要查看当前生效的所有 Git 配置，可以使用 git config --list 命令。它会按优先级顺序显示配置项（System < Global < Local），同一配置项后面的值会覆盖前面的值。

要查看特定代理设置的值，可以使用 git config --get http.proxy 或 git config --get-all http.proxy (如果有多处定义)。

2.1.7 临时使用代理

如果你只想对单次 Git 操作使用代理，可以通过在命令前设置环境变量的方式（见 2.2 节）。

2.2 使用环境变量配置代理

除了 git config，Git 也遵循标准的 HTTP 代理相关的环境变量。这种方式的优先级通常高于 git config 配置。使用环境变量的优点是方便临时设置或在脚本中使用，缺点是只对当前终端会话或指定运行环境生效。

常用的环境变量有：

HTTP_PROXY: 用于 HTTP 请求。
HTTPS_PROXY: 用于 HTTPS 请求。
ALL_PROXY: 用于所有协议的请求（如果 HTTP_PROXY 和 HTTPS_PROXY 未设置）。
NO_PROXY: 指定不需要使用代理的主机或域名列表。

环境变量名通常是大写，但在某些系统和库中，小写版本 (http_proxy, https_proxy, all_proxy, no_proxy) 也可能被识别，甚至优先级更高。为了兼容性，可以同时设置大写和小写版本。

2.2.1 配置 HTTP/HTTPS 环境变量代理

在 Linux/macOS Bash 环境中：

“`bash

配置 HTTP 代理

export HTTP_PROXY=”http://proxy.example.com:8080″
export http_proxy=”http://proxy.example.com:8080″

配置 HTTPS 代理

export HTTPS_PROXY=”http://proxy.example.com:8080″
export https_proxy=”http://proxy.example.com:8080″

如果代理需要用户名和密码

export HTTPS_PROXY=”http://user:[email protected]:8080″
export https_proxy=”http://user:[email protected]:8080″

注意：环境变量中设置密码也存在泄露风险，但不会写入文件。

同时设置，或使用 ALL_PROXY

export ALL_PROXY=”http://proxy.example.com:8080″
export all_proxy=”http://proxy.example.com:8080″

取消环境变量设置（当前会话）

unset HTTP_PROXY http_proxy HTTPS_PROXY https_proxy ALL_PROXY all_proxy
“`

在 Windows Command Prompt 环境中：

“`cmd
rem 配置 HTTP 代理
set HTTP_PROXY=http://proxy.example.com:8080
set http_proxy=http://proxy.example.com:8080

rem 配置 HTTPS 代理
set HTTPS_PROXY=http://proxy.example.com:8080
set https_proxy=http://proxy.example.com:8080

rem 如果代理需要用户名和密码
set HTTPS_PROXY=http://user:[email protected]:8080
set https_proxy=http://user:[email protected]:8080

rem 同时设置，或使用 ALL_PROXY
set ALL_PROXY=http://proxy.example.com:8080
set all_proxy=http://proxy.example.com:8080

rem 取消环境变量设置（当前会话）
set HTTP_PROXY=
set http_proxy=
set HTTPS_PROXY=
set https_proxy=
set ALL_PROXY=
set all_proxy=
“`

在 Windows PowerShell 环境中：

“`powershell

配置 HTTP 代理

$env:HTTP_PROXY=”http://proxy.example.com:8080″
$env:http_proxy=”http://proxy.example.com:8080″

配置 HTTPS 代理

$env:HTTPS_PROXY=”http://proxy.example.com:8080″
$env:https_proxy=”http://proxy.example.com:8080″

如果代理需要用户名和密码

$env:HTTPS_PROXY=”http://user:[email protected]:8080″
$env:https_proxy=”http://user:[email protected]:8080″

同时设置，或使用 ALL_PROXY

$env:ALL_PROXY=”http://proxy.example.com:8080″
$env:all_proxy=”http://proxy.example.com:8080″

取消环境变量设置（当前会话）

Remove-Item Env:HTTP_PROXY, Env:http_proxy, Env:HTTPS_PROXY, Env:https_proxy, Env:ALL_PROXY, Env:all_proxy
“`

2.2.2 使用 NO_PROXY 排除特定主机

NO_PROXY (或 no_proxy) 环境变量用于指定不应该使用代理的主机名、域名或 IP 地址列表。多个项之间使用逗号分隔。

“`bash

在 Linux/macOS Bash 中

export NO_PROXY=”localhost,127.0.0.1,.internal.com,github.com”
export no_proxy=”localhost,127.0.0.1,.internal.com,github.com”

上例表示：对 localhost, 127.0.0.1, 所有以 .internal.com 结尾的域名，以及 github.com 不使用代理。

注意：域名前面的点号（.）表示匹配该域名及其所有子域名。

“`

2.2.3 配置 SOCKS 环境变量代理

环境变量也常用于配置 SOCKS 代理，特别是通过 ALL_PROXY。

“`bash

在 Linux/macOS Bash 中

export ALL_PROXY=”socks5://127.0.0.1:1080″
export all_proxy=”socks5://127.0.0.1:1080″

或者 SOCKS4

export ALL_PROXY=”socks4://127.0.0.1:1080″

注意：Git 的 HTTP/HTTPS 后端库需要支持 socks:// scheme 的环境变量。

现代 Git 版本通常基于 libcurl，libcurl 支持这种格式。

“`

2.3 git config 与环境变量的优先级

当 git config 和环境变量都配置了代理时，通常环境变量具有更高的优先级。具体的优先级顺序可能略有不同取决于 Git 的构建方式和操作系统，但一个常见的优先级顺序是：

环境变量 (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY)
本地仓库 .git/config 中的 http.proxy 或 https.proxy
全局用户配置 ~/.gitconfig 中的 http.proxy 或 https.proxy
系统级配置 $(prefix)/etc/gitconfig 中的 http.proxy 或 https.proxy

因此，如果您设置了环境变量，它会覆盖 .gitconfig 或仓库配置中的代理设置。这是临时绕过或强制使用某个代理的便捷方法。

第三章：Git SSH 代理配置

Git 通过 SSH 协议进行通信时（例如 [email protected]:user/repo.git），它的网络连接是由底层的 SSH 客户端（通常是 OpenSSH）处理的。因此，为 Git 的 SSH 操作配置代理，实际上是配置 SSH 客户端使用代理，而不是通过 Git 的 http.proxy 或环境变量。

SSH 客户端的代理配置主要通过修改用户的 SSH 配置文件来实现，即 ~/.ssh/config。

3.1 使用 ~/.ssh/config 配置代理

通过修改 ~/.ssh/config 文件，可以为特定的主机或所有 SSH 连接配置代理方式。主要使用 ProxyCommand 或 ProxyJump 关键字。

3.1.1 使用 ProxyCommand 配置代理

ProxyCommand 允许你指定一个命令，SSH 客户端在连接目标主机之前会执行这个命令，并将标准输入输出与该命令的标准输入输出连接起来。这个命令的作用就是建立与目标主机之间的连接，但通过代理进行。

常见的 ProxyCommand 实现依赖于一些辅助工具：

nc (netcat) 或 socat: 用于通过 SOCKS 代理连接。
corkscrew: 用于通过 HTTP 代理连接。
ssh -W %h:%p host [port]: 使用另一个 SSH 连接作为隧道。

示例 1: 通过 SOCKS 代理连接 SSH

假设您的 SOCKS5 代理运行在 127.0.0.1 的 1080 端口。修改 ~/.ssh/config 文件，添加如下内容：

“`config

SSH config for proxy

如果只对特定主机使用代理，将以下内容放在 Host 部分内

Host github.com

HostName github.com

User git

ProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p

如果想对所有 SSH 连接都使用 SOCKS5 代理 (不推荐，除非确定所有连接都需要)

Host *
# Check if nc supports -X (SOCKS proxy).
# Some versions might require socks5:// prefix or different flags.
# Common command using nc with SOCKS:
ProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p
# Or using socat:
# ProxyCommand socat STDIO SOCKS4:proxy.example.com:%h:%p,SOCKSVERSION=4
# ProxyCommand socat STDIO SOCKS5:proxy.example.com:%h:%p,SOCKSVERSION=5

说明:

Host *: 应用于所有 SSH 连接。你可以替换成 Host github.com 等特定主机。

ProxyCommand: 指定代理命令。

nc: 使用 netcat 工具。

-X 5: 指定 SOCKS 协议版本 5。-X 4 是 SOCKS4。

-x 127.0.0.1:1080: 指定代理服务器的地址和端口。

%h: SSH 配置文件中的 HostName (或 Host 的值，如果 HostName 未指定)。

%p: 远程主机的端口 (通常是 22)。

“`

请确保您的系统安装了 nc 或 socat 工具。如果 nc 不支持 -X 参数（常见于 BSD 版本的 nc），您可能需要安装 GNU nc 或使用 socat。

示例 2: 通过 HTTP 代理连接 SSH (使用 corkscrew)

corkscrew 是一个专门用于通过 HTTP CONNECT 方法连接 SSH 的小工具。首先需要安装 corkscrew。

修改 ~/.ssh/config 文件：

“`config

SSH config for HTTP proxy using corkscrew

Host github.com # 或者其他需要代理的主机
HostName github.com
User git
# ProxyCommand corkscrew proxy.example.com 8080 %h %p [用户名 [密码]]
ProxyCommand corkscrew proxy.example.com 8080 %h %p

如果代理需要认证

ProxyCommand corkscrew proxy.example.com 8080 %h %p ~/.ssh/proxy_auth

proxy_auth 文件格式：用户名:密码 (注意文件权限，仅当前用户可读写)

“`

corkscrew 的参数：proxy_host proxy_port target_host target_port [auth_file]。

示例 3: 通过 SSH 跳板机连接 SSH (使用 ssh -W)

这通常用于通过一个中间 SSH 服务器（跳板机）访问无法直接访问的最终目标 SSH 服务器。

修改 ~/.ssh/config 文件：

“`config

SSH config for jump host (跳板机)

Host jumpbox # 定义跳板机别名
HostName jump.example.com # 跳板机的实际地址
User your_jump_user # 连接跳板机的用户名
Port 22 # 跳板机的端口

Host target-server # 定义目标服务器别名
HostName actual.target.host.com # 目标服务器的实际地址
User your_target_user # 连接目标服务器的用户名
Port 22 # 目标服务器的端口
# 使用 ssh 命令通过跳板机连接到目标服务器
ProxyCommand ssh -W %h:%p jumpbox

对于 Git 的 SSH URL ([email protected]:user/repo.git)，目标主机是 github.com。

如果需要通过跳板机访问 github.com (非常规，但理论上可行)，你需要一个允许你

通过它访问外部网络的跳板机。

Host github.com

HostName github.com

User git

ProxyCommand ssh -W %h:%p jumpbox

“`

这里的 ProxyCommand ssh -W %h:%p jumpbox 的意思是：在连接 Host (github.com) 时，先执行 ssh -W github.com:22 jumpbox 命令。ssh -W %h:%p 会请求跳板机 (jumpbox) 建立一个到 %h:%p (github.com:22) 的 TCP 转发隧道，并将标准输入输出重定向到这个隧道。SSH 客户端就会通过这个隧道与 github.com 进行通信。

3.1.2 使用 ProxyJump 配置代理 (OpenSSH 7.3+)

ProxyJump 是 OpenSSH 7.3 版本引入的一个更简洁的关键字，用于指定一个或多个跳板机。它内部也是基于 ProxyCommand ssh -W 实现的。

“`config

SSH config using ProxyJump (OpenSSH 7.3+)

Host jumpbox # 定义跳板机别名
HostName jump.example.com
User your_jump_user
Port 22

Host target-server # 定义目标服务器别名
HostName actual.target.host.com
User your_target_user
Port 22
ProxyJump jumpbox # 通过 jumpbox 跳板机连接 target-server

对于 Git 的 SSH URL ([email protected]:user/repo.git)

Host github.com
HostName github.com
User git
ProxyJump jumpbox # 如果你的 jumpbox 允许并配置了访问外部网络
“`

3.1.3 注意 ~/.ssh/config 的权限

为了安全，SSH 客户端要求 ~/.ssh/config 文件的权限设置正确，通常是 600 (rw-------) 或 644 (rw-r--r--)。如果权限过高，SSH 可能会拒绝读取该文件。

在 Linux/macOS 中设置权限：
bash chmod 600 ~/.ssh/config

3.2 临时为 SSH 命令指定代理

虽然 SSH 主要依赖配置文件，但也可以通过环境变量或命令行参数临时指定代理。这通常不如配置文件方便，但对于单次测试有用。例如，可以使用 ProxyCommand 参数直接在 ssh 命令中：

“`bash

通过 SOCKS5 代理连接 github.com (一次性命令)

ssh -o “ProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p” [email protected]

通过跳板机连接 github.com (一次性命令, 需要跳板机配置在 ~/.ssh/config)

ssh -o “ProxyJump jumpbox” [email protected]
“`

这些选项可以用于 Git 命令中，例如：
“`bash

临时通过 SOCKS5 代理克隆仓库

git clone ssh://[email protected]/user/repo.git –config “core.sshCommand=’ssh -o \”ProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p\”‘”

注意：这种方式非常繁琐且容易出错，强烈推荐使用 ~/.ssh/config 文件。

“`

第四章：跳过代理（`NO_PROXY` 等）

在配置了全局代理后，有些内部地址、本地地址或特定外部地址我们不希望通过代理访问，这时就需要配置例外。

4.1 使用 NO_PROXY 环境变量

正如 2.2.2 节所述，NO_PROXY 环境变量是标准的方式。

bash export NO_PROXY="localhost,127.0.0.1,.internal.com,gitlab.company.com" export no_proxy="localhost,127.0.0.1,.internal.com,gitlab.company.com"

Git 的 HTTP/HTTPS 后端（libcurl）会遵守这个环境变量。

4.2 使用 git config http.noProxy

Git 也提供了 http.noProxy 配置项，功能与 NO_PROXY 环境变量类似，但只作用于 Git 的 HTTP/HTTPS 操作。

“`bash

配置全局不使用代理的主机列表

git config –global http.noProxy “localhost,127.0.0.1,.internal.com,gitlab.company.com”

取消设置

git config –global –unset http.noProxy
“`

4.3 优先级

通常，NO_PROXY / no_proxy 环境变量的优先级高于 git config http.noProxy。建议优先使用环境变量，因为它对整个系统或当前会话生效，更通用。

4.4 SSH 例外

SSH 代理的例外配置也在 ~/.ssh/config 中进行。你可以通过更具体的 Host 配置来覆盖通配符 Host * 的代理设置。例如：

“`config
Host *
ProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p # 所有连接默认走 SOCKS 代理

Host internal.company.com # 针对内部网络的例外
HostName internal.company.com
User git
# 不设置 ProxyCommand，表示直连
# 或明确取消 ProxyCommand (如果需要覆盖继承的设置)
# ProxyCommand none
`` 在这里，针对internal.company.com的连接将不会执行Host *下的ProxyCommand`，从而实现例外。

第五章：故障排除与注意事项

配置代理后，如果 Git 操作仍然失败，或者出现新的错误，可能是配置有误或存在其他问题。

5.1 常见错误信息

Failed to connect to proxy.example.com port 8080: Connection refused：无法连接到代理服务器，检查代理地址和端口是否正确，代理服务器是否正在运行且网络可达。
Proxy Authentication Required: 代理服务器需要认证，检查代理配置中是否包含了正确的用户名和密码，或者环境变量是否设置正确。
OpenSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443: SSL/TLS 连接失败，可能与代理服务器或中间人攻击（如公司防火墙进行 SSL 检查）有关。
ssh: connect to host github.com port 22: Connection refused: SSH 连接失败，检查 SSH 配置文件，代理命令是否正确执行，代理是否允许 SSH 连接。
Could not resolve proxy host: 代理服务器地址无法解析，检查代理服务器主机名是否正确，DNS 设置是否正常。

5.2 排查步骤

检查 Git 配置:
- 使用 git config --list 查看当前生效的配置，确认 http.proxy, https.proxy, http.noProxy 是否设置正确。
- 检查配置是全局 (--global)、本地 (--local) 还是系统级 (--system)，确认其作用范围是否符合预期。
检查环境变量:
- 在终端中分别使用 echo $HTTP_PROXY, echo $HTTPS_PROXY, echo $ALL_PROXY, echo $NO_PROXY (或 Windows 下的 echo %HTTP_PROXY% 或 PowerShell 的 $env:HTTP_PROXY)，确认环境变量是否设置正确，特别是大写和小写版本。
检查代理服务器可达性:
- 使用 ping proxy.example.com (如果代理允许 ping)。
- 使用 telnet proxy.example.com 8080 或 nc -vz proxy.example.com 8080 (对于 TCP 代理) 测试端口是否开放并可连接。
检查代理认证:
- 如果代理需要认证，确认用户名和密码是否正确。尝试使用其他支持代理认证的工具（如浏览器、curl）连接同一个代理，看是否能成功认证。
检查 SSL 证书问题 (HTTPS):
- 在企业环境中，很多防火墙会进行 SSL 检查（中间人攻击），这会导致 Git（或 curl）报告 SSL 证书错误。
- 临时解决方案 (不安全): 关闭 SSL 验证。git config --global http.sslVerify false。强烈不推荐长期使用此设置，因为它会使您容易受到真正的中间人攻击。
- 安全解决方案: 获取公司内部 CA 根证书，并配置 Git 信任它。
  - git config --global http.sslCAInfo /path/to/your/company.pem (指定证书文件)
  - 或 git config --global http.sslCAPath /path/to/your/ca/certs/dir (指定证书目录)
检查 SSH 配置 (~/.ssh/config):
- 确认 ~/.ssh/config 文件是否存在，权限是否正确 (chmod 600 ~/.ssh/config)。
- 检查 Host 配置是否匹配 Git URL 中的主机名 (如 github.com)。
- 检查 ProxyCommand 或 ProxyJump 命令是否正确，依赖的工具（nc, corkscrew, ssh）是否存在且路径正确。
- 使用 SSH 客户端的详细输出进行调试：ssh -v [email protected]。查看输出中是否有关于代理连接的信息或错误。多次 -v (-vv, -vvv) 可以提供更详细的信息。
区分协议问题: 确认您的 Git 操作使用的是 HTTP/HTTPS 还是 SSH 协议，并检查对应协议的代理设置。例如，git clone https://... 使用 HTTP/S 代理设置，而 git clone git@... 使用 SSH 代理设置。
检查 NO_PROXY 设置: 确认要访问的主机是否被 NO_PROXY 或 http.noProxy 规则排除，如果是，是否符合预期。
其他工具测试: 使用 curl 命令独立测试 HTTP/HTTPS 代理。curl -x http://proxy.example.com:8080 https://github.com。这可以帮助确定是 Git 特有的问题还是底层网络或代理配置问题。

第六章：总结与最佳实践

为 Git 配置代理是应对复杂网络环境的必要技能。理解 Git 使用的不同协议（HTTP/S 和 SSH）及其各自独立的代理配置方式是关键。

最佳实践：

优先使用 Git config: 对于长期固定的代理设置，推荐使用 git config --global 命令，它将配置持久化到用户的配置文件中，方便管理和查看。
环境变量用于临时或脚本: 环境变量适用于需要在特定脚本中、临时更改代理设置，或者希望代理设置影响当前会话中所有支持环境变量的应用程序。
区分 HTTP/S 和 SSH: 牢记 Git 的 HTTP/HTTPS 代理和 SSH 代理是完全独立的配置体系。前者使用 Git config 或环境变量，后者使用 ~/.ssh/config。
安全处理认证: 尽量避免在 git config 文件或 URL 中直接存储明文密码。如果可能，使用无需认证的代理，或者通过环境变量传递认证信息（虽然仍有风险，但不会写入文件）。SSH 认证使用密钥对，代理认证可以考虑 corkscrew 配合权限受限的文件。
谨慎处理 SSL 验证: 在企业环境中遇到 SSL 错误时，优先尝试导入公司根证书，而不是简单地关闭 SSL 验证。关闭验证会降低安全性。
利用 NO_PROXY: 合理使用 NO_PROXY 环境变量或 git config http.noProxy 来避免内部或无需代理的流量经过代理，这有助于提高效率和避免潜在问题。
详细调试: 遇到问题时，利用 git config --list、环境变量查看、网络工具（ping, telnet, nc, curl）和 SSH 的 -v 参数进行详细调试。

掌握了这些 Git 代理配置技巧，您将能够在各种网络环境下畅通无阻地进行版本控制操作。希望这份指南对您有所帮助！

Git 代理配置完全指南

第一章：理解 Git 的网络通信与代理的需求

第二章：Git HTTP/HTTPS 代理配置

配置全局 HTTP 代理

格式：协议://[用户:密码@]主机:端口

如果代理需要用户名和密码

注意：将密码直接放在 URL 中不安全，会被记录在 ~/.gitconfig 文件中，

建议使用环境变量或更安全的凭证管理方式（虽然 Git 凭证助手主要用于仓库认证，而非代理认证）。

更好的做法是不在 URL 中包含密码，让 Git 在需要时提示输入，或者使用无需认证的代理。

取消全局 HTTP 代理设置

配置全局 HTTPS 代理

格式：协议://[用户:密码@]主机:端口

注意：这里虽然是 HTTPS 代理，但代理服务器本身可能是通过 HTTP 协议进行连接的，

所以代理地址通常还是以 http:// 开头。但如果代理服务器本身是 HTTPS 代理，

则可以使用 https://。最常见的是使用 http:// 代理 HTTPS 流量。

如果代理需要用户名和密码

取消全局 HTTPS 代理设置

配置全局 SOCKS5 代理

或者对于 HTTPS 流量

注意：这种方式的兼容性取决于你的 Git 版本和操作系统。

有些 Git 版本或库可能无法正确解析 socks:// scheme。

在这种情况下，使用环境变量（见 2.2.3 节）或 Wrapper 工具可能更可靠。

取消全局 SOCKS 代理设置

取消本地仓库代理设置

配置 HTTP 代理

配置 HTTPS 代理

如果代理需要用户名和密码

注意：环境变量中设置密码也存在泄露风险，但不会写入文件。

同时设置，或使用 ALL_PROXY

取消环境变量设置（当前会话）

配置 HTTP 代理

配置 HTTPS 代理

如果代理需要用户名和密码

同时设置，或使用 ALL_PROXY

取消环境变量设置（当前会话）

在 Linux/macOS Bash 中

上例表示：对 localhost, 127.0.0.1, 所有以 .internal.com 结尾的域名，以及 github.com 不使用代理。

注意：域名前面的点号（.）表示匹配该域名及其所有子域名。

在 Linux/macOS Bash 中

或者 SOCKS4

export ALL_PROXY=”socks4://127.0.0.1:1080″

注意：Git 的 HTTP/HTTPS 后端库需要支持 socks:// scheme 的环境变量。

现代 Git 版本通常基于 libcurl，libcurl 支持这种格式。

第三章：Git SSH 代理配置

SSH config for proxy

如果只对特定主机使用代理，将以下内容放在 Host 部分内

Host github.com

HostName github.com

User git

ProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p

如果想对所有 SSH 连接都使用 SOCKS5 代理 (不推荐，除非确定所有连接都需要)

说明:

Host *: 应用于所有 SSH 连接。你可以替换成 Host github.com 等特定主机。

ProxyCommand: 指定代理命令。

nc: 使用 netcat 工具。

-X 5: 指定 SOCKS 协议版本 5。-X 4 是 SOCKS4。

-x 127.0.0.1:1080: 指定代理服务器的地址和端口。

%h: SSH 配置文件中的 HostName (或 Host 的值，如果 HostName 未指定)。

%p: 远程主机的端口 (通常是 22)。

SSH config for HTTP proxy using corkscrew

如果代理需要认证

ProxyCommand corkscrew proxy.example.com 8080 %h %p ~/.ssh/proxy_auth

proxy_auth 文件格式：用户名:密码 (注意文件权限，仅当前用户可读写)

SSH config for jump host (跳板机)

对于 Git 的 SSH URL ([email protected]:user/repo.git)，目标主机是 github.com。

如果需要通过跳板机访问 github.com (非常规，但理论上可行)，你需要一个允许你

通过它访问外部网络的跳板机。

Host github.com

HostName github.com

User git

ProxyCommand ssh -W %h:%p jumpbox

SSH config using ProxyJump (OpenSSH 7.3+)

对于 Git 的 SSH URL ([email protected]:user/repo.git)

通过 SOCKS5 代理连接 github.com (一次性命令)

通过跳板机连接 github.com (一次性命令, 需要跳板机配置在 ~/.ssh/config)

临时通过 SOCKS5 代理克隆仓库

注意：这种方式非常繁琐且容易出错，强烈推荐使用 ~/.ssh/config 文件。

第四章：跳过代理（NO_PROXY 等）

配置全局不使用代理的主机列表

取消设置

第四章：跳过代理（`NO_PROXY` 等）

发表评论取消回复