# curl 代理：HTTP、SOCKS5 与环境变量设置 | ProxyJam

curl 代理设置：用 -x 和 -U 让 curl 走 HTTP 或 SOCKS5 代理，用环境变量全局生效，并对密码中的特殊字符进行编码。

- Canonical: https://proxyjam.com/zh/faq/curl-proxy/
- Updated: 2026-11-22
- Language: zh

HTTP 代理用 curl -x http://HOST:PORT -U LOGIN:PASSWORD URL，SOCKS5 用 socks5h://HOST:PORT。-U 选项里的密码按原样填写即可。设置 http_proxy、https_proxy 或 all_proxy 可让整个 shell 都走代理；登录信息写在 URL 里时，特殊字符需要做百分号编码。


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

### 为什么用 socks5h 而不是 socks5？

使用 socks5h 时，curl 会把主机名交给代理去解析；使用 socks5 时，curl 先在本地解析。除非需要本地解析，否则请用 socks5h。

### 访问 HTTPS 网站时，代理地址里还要保留 http:// 吗？

要。这个协议头描述的是 curl 与代理之间的通信方式，而不是目标网站的协议。HTTP 代理会通过隧道转发 HTTPS 页面。

### curl 返回 407 是什么意思？

代理拒绝了您的登录信息或您的地址。请从控制台重新复制连接信息，并检查许可列表。



curl 是测试代理最快的方式，在 macOS、Linux 和 Windows 上用法一致。请把四个占位符替换为
[控制台](https://app.proxyjam.com)中“我的代理”里某一行的值。

## HTTP 代理

```
curl -x http://HOST:PORT -U LOGIN:PASSWORD https://example.com/
```

`-x`（长格式 `--proxy`）用于指定代理，`-U`（`--proxy-user`）用于指定登录信息。`-U` 中的密码按
原样填写，无需编码。即使访问的是 HTTPS 页面，代理地址里也要保留 `http://`：这个协议头表示的是
curl 与代理之间的通信方式。加上 `-I` 只打印响应头，加上 `-v` 可以看到隧道建立的过程。

## SOCKS5 代理

请先通过“更改协议”切换协议，然后重新复制连接信息。接着：

```
curl -x socks5h://HOST:PORT -U LOGIN:PASSWORD https://example.com/
```

其中的 `h` 表示由代理来解析主机名。较早的 `--socks5-hostname HOST:PORT` 选项效果相同。
协议本身的介绍见我们的 [SOCKS5 代理](/zh/socks5-proxies/)页面。

## 把登录信息写进 URL

您也可以把登录信息直接写进代理地址：

```
curl -x http://LOGIN:PASSWORD@HOST:PORT https://example.com/
```

此时，在 URL 中有特殊含义的字符必须做百分号编码：`@` 写作 `%40`，`:` 写作 `%3A`，`/` 写作
`%2F`，`#` 写作 `%23`，`%` 写作 `%25`。未编码的密码会在第一个这样的字符处被截断，代理会返回
407。

## 环境变量

要让当前 shell 中的每一条 curl 命令都走代理：

```
export http_proxy="http://LOGIN:PASSWORD@HOST:PORT"
export https_proxy="http://LOGIN:PASSWORD@HOST:PORT"
```

在 PowerShell 中写法如下：

```
$env:http_proxy = "http://LOGIN:PASSWORD@HOST:PORT"
$env:https_proxy = "http://LOGIN:PASSWORD@HOST:PORT"
```

请给值加上引号；密码中如果有 `$`、`&` 或 `!` 等对 shell 有特殊含义的字符，也需要加引号或转义，
在 POSIX shell 中用单引号最稳妥。

`all_proxy` 为所有协议设置同一个代理，`no_proxy` 列出不走代理的主机。`http_proxy` 请使用小写
名称，因为对于普通 HTTP，curl 会忽略大写形式。用 `unset http_proxy https_proxy` 即可取消。
这些信息会出现在 shell 历史记录和进程列表中，因此请勿在共用的电脑上这样做。

## 该用哪种方式

单次请求和脚本用 `-x` 和 `-U`，因为它们不会改动您的 shell。工具只接受一个代理字符串时，用 URL
形式。需要在 shell 里工作一段时间、并希望每次 curl 调用都走同一条线路时，用环境变量。在脚本
中，优先使用脚本内部设置的变量，而不是全局导出的变量。

## 查看结果

返回 `200` 或重定向，说明代理接受了登录。返回 `407` 则说明没有：
[代理错误 407](/zh/faq/proxy-error-407/)列出了排查步骤，
[代理身份验证失败](/zh/faq/proxy-authentication-failed/)则介绍许可列表模式。
要确认出口地址，可以通过代理加载 [What Is My IP](/zh/what-is-my-ip/)，也可以把代理粘贴到我们的[代理检测工具](/zh/proxy-checker/)，它做的是同样的单次请求测试，不需要终端。同一个代理在代码中的用法见
[Python requests](/zh/integrations/python-requests/)页面，订购和价格见
[ISP 代理](/zh/isp-proxies/)页面。

