# git 设置代理：http.proxy 与 socks5h 配置 | ProxyJam

git 设置代理：用 git config http.proxy 配置 HTTP 或 SOCKS5 代理，可按主机或按仓库设置，支持用户名和密码，并说明如何取消代理。

- Canonical: https://proxyjam.com/zh/faq/git-proxy-config/
- Updated: 2026-11-18
- Language: zh

运行 git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT，让 Git 通过 HTTP 代理访问；SOCKS5 则使用 socks5h://HOST:PORT。它只对 http 和 https 远程仓库生效，对 SSH 远程仓库无效。取消设置用 git config --global --unset http.proxy。登录信息会以明文形式保存在 Git 配置文件中。


## 关于 Git 和代理的快速解答

### 代理对 git@ 开头的远程仓库有效吗？

无效。http.proxy 只作用于 http 和 https 远程仓库。git@ 开头的远程仓库走 SSH，SSH 有它自己的代理设置。

### 如何只对某一个主机使用代理？

把主机写进配置项的键名里：git config --global http.https://example.com.proxy http://HOST:PORT，其中的 example.com 换成您自己的主机。

### 如何查看 Git 发出了什么请求？

在命令前加上 GIT_CURL_VERBOSE=1 再运行。输出中会显示发往代理的 CONNECT 请求。



Git 通过 libcurl 访问 http 和 https 远程仓库，因此遵循与
[如何在 curl 中使用代理](/zh/faq/curl-proxy/)相同的代理规则。主机、端口、登录名和密码，请取自
[控制台](https://app.proxyjam.com)中“我的代理”里的同一行。

## 为所有仓库设置代理

```
git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT
```

这条命令会在 `~/.gitconfig` 中写入一行。这一项设置同时适用于 http 和 https 远程仓库。
可用 `git config --get http.proxy` 检查。

如果订单使用 SOCKS5，请先通过“更改协议”切换订单的协议，重新复制连接信息，然后使用：

```
git config --global http.proxy socks5h://LOGIN:PASSWORD@HOST:PORT
```

其中的 `h` 表示由代理来解析主机名。协议本身的介绍见 [SOCKS5 代理](/zh/socks5-proxies/)页面。

## 对特殊字符进行编码

登录信息写在 URL 里，所以 `@` 必须写作 `%40`，`:` 写作 `%3A`，`/` 写作 `%2F`，`#` 写作
`%23`，`%` 写作 `%25`。未编码的密码会被截断，代理会返回 407。

## 只对一个仓库或一个主机生效

在仓库目录内去掉 `--global`，即可只对该仓库生效：

```
git config http.proxy http://LOGIN:PASSWORD@HOST:PORT
```

若要把代理限定在某一个主机，把主机写进键名：

```
git config --global http.https://example.com.proxy http://LOGIN:PASSWORD@HOST:PORT
```

## 环境变量

Git 还会读取 shell 中的 `http_proxy`、`https_proxy` 和 `all_proxy`，以及用来跳过某些主机的
`no_proxy` 列表。配置项一旦设置，优先级高于这些环境变量。

## 该选哪种作用范围

全局设置最简单，但它会让所有 http 和 https 远程仓库都走代理，包括代理无法到达的内部服务器。
遇到这种情况，请把代理限定在某个主机或某个仓库，或者把内部主机写进 `no_proxy`。只有一个远程
仓库需要代理时，按主机设置的键最稳妥。

## 取消设置

```
git config --global --unset http.proxy
```

## 注意事项

- 密码以明文形式保存在 Git 配置文件中。请妥善保管该文件，不要把它提交到仓库。
- SSH 远程仓库（`git@host:...`）会忽略 `http.proxy`。
- `git clone` 返回 407，说明代理拒绝了登录信息：
  [代理错误 407](/zh/faq/proxy-error-407/)列出了排查步骤，
  [代理身份验证失败](/zh/faq/proxy-authentication-failed/)则介绍许可列表模式。
- 请仅对您有权访问的仓库使用代理，这是[可接受使用政策](/zh/acceptable-use-policy/)的要求。
  套餐见 [ISP 代理](/zh/isp-proxies/)页面。

