HOWTO · Git

配置代理以使用 Git

在本文中,我们将讨论配置 Git 以使用不同代理的过程。

本页内容

公司防火墙阻止 Git 流量时,可将 Git 配置为通过组织的代理发送请求。你可以只为一条命令设置代理,也可以将设置保存在当前仓库,或为你的用户全局保存。示例中的主机名和凭据仅供文档演示;请替换为网络管理员提供的值。

选择代理协议和作用范围

HTTP、HTTPS、SOCKS4 和 SOCKS5 表示代理 URL 方案或代理协议选项。目标 URL 和代理 URL 描述的是不同的连接:例如,Git 可以通过 http:// 代理访问 https:// 目标,两者不必相同。

使用 git -c http.proxy=PROXY_URL COMMAND 可仅为一条 Git 命令设置代理。仓库级设置只在当前仓库生效;--global 则将设置保存在用户级 Git 配置中,并影响你的各个仓库。管理员也可能提供系统级设置。如果多个适用设置的范围不同,较具体的设置可能覆盖较宽泛的设置;行为与预期不符时,请检查实际生效的值。

代理 URL 中的用户名或密码若含保留字符,可能需要进行 URL 编码。不要把真实凭据放进共享命令、脚本或 shell 历史记录。组织提供获批的凭据助手或机密管理方式时,请使用这些方式。

配置 HTTP 代理

只需代理单次操作时,可通过 Git 的 -c 选项添加代理。例如,内联命令 git -c http.proxy=http://proxy.example:8080 clone https://git.example/team/project.git 只会为这次克隆操作设置代理。请将代理主机和端口替换为管理员提供的值。

你也可以使用 URL 专用键 http.https://git.example.proxy,只为匹配的目标 URL 设置代理。如果其他 Git 主机应直接连接,或应使用不同的代理,这种设置会很有用。匹配依据是 Git 的 URL 配置规则,因此请使用你实际访问的目标方案和主机。

请使用临时 Git 配置文件运行此示例。它会写入一个示例 HTTP 代理值并将其读回,不会更改你的仓库或用户配置。

本节中的代码以及显示的标签或输出仍为英文。

set -eu
config_file="$(mktemp)"
trap 'rm -f "$config_file"' EXIT
git config --file "$config_file" http.proxy http://proxy.example:8080
git config --file "$config_file" --get http.proxy

为 Git 流量配置 HTTPS 代理

对于 HTTPS 目标,可针对该目标配置代理,例如使用 http.https://git.example.proxy。代理本身仍可使用 http:// URL;它描述的是 Git 到代理的连接,而 HTTPS 描述的是目标连接。如果代理端点支持 TLS,请使用管理员指定的 HTTPS 代理方案。

unable to access 'https://...': Unknown SSL protocol error in connection to ...:443 这类错误提示代理与目标连接之间的协商可能不符合预期。请先检查代理方案、主机、端口和防火墙策略。如果代理会拦截 TLS,请按照所用环境的文档配置 Git,使其信任组织提供的证书颁发机构。不要把关闭证书验证当作常规修复办法,因为这会失去对不受信任或被拦截连接的保护。如果管理员要求临时覆盖验证设置以便诊断,请将覆盖限制为一条命令,并立即恢复正常验证。

在 Git 配置中保存代理设置

要为当前仓库保存代理,请在该仓库中运行 git config http.proxy http://proxy.example:8080。要让你的各个仓库都为用户保存同一设置,请运行 git config --global http.proxy http://proxy.example:8080。这些已保存的设置会一直生效,直到你修改或删除它们。也可以通过 git config --global http.https://git.example.proxy http://proxy.example:8080 保存针对特定目标的值。

http.proxy 键是 Git 配置项;--global 是用于选择用户级作用范围的命令行选项。只有一个工作副本需要代理时,使用仓库级配置;同一网络路由通常适用于你的 Git 工作时,可使用全局配置。配置文件可能会被复制或备份,因此在任一作用范围保存凭据前,请先咨询管理员。

检查并删除代理设置

使用 git config --show-origin --get-regexp '^http\.' 列出与 HTTP 相关的设置及其来源。命令 git config --get http.proxy 只检查通用的 http.proxy 值。要检查适用于某个 HTTPS 目标的实际代理设置,请运行 git config --get-urlmatch http.proxy https://git.example,并将 URL 换成你要访问的目标。没有结果表示此查询未找到匹配值;其他配置作用范围仍可能提供设置。

使用 git config --unset-all http.proxy 删除仓库级代理;使用 git config --global --unset-all http.proxy 删除全局代理。对于针对特定目标的条目,请将键替换为实际配置的完整键,例如 http.https://git.example.proxy。如果添加过 SSL 验证覆盖设置,也请在相同作用范围删除该键,例如运行 git config --unset-all http.sslVerify 或 git config --global --unset-all http.sslVerify。

删除一个键不会清除所有代理设置。请分别检查仓库级和全局配置,并单独删除 URL 专用条目。--unset-all 会删除所选作用范围内该键的所有值,但不会更改范围更宽、更窄或系统级的配置。

在 Git 中配置 SOCKS 代理

如果代理服务支持相应协议,Git 代理 URL 可以使用 socks4:// 或 socks5://。只为一次操作设置代理时,可使用类似 git -c http.proxy=socks5://proxy.example:1080 fetch 的命令。要为用户保存通用的 SOCKS5 代理,请运行 git config --global http.proxy socks5://proxy.example:1080;若要针对某个 HTTPS 目标设置代理,请使用 git config --global http.https://git.example.proxy socks5://proxy.example:1080。

请根据组织配置的服务和身份验证支持,选择 SOCKS4 或 SOCKS5。方案拼写必须准确,端口应使用分配的值。如果请求仍绕过代理或无法连接,请检查最终生效的 Git 配置。