---
title: "cURL 代理命令：HTTP、SOCKS5 与认证 | Proxonym"
description: "在 cURL 中使用代理：-x 和 -U 参数、HTTP 与 SOCKS5 命令、轮换与粘性 IP、按国家和城市定位，以及如何解读代理错误码。"
url: https://proxonym.com/zh/integrations/curl
updated: 2026-10-02T03:03:46+00:00
---

# 如何在 cURL 中使用代理

cURL 是在终端中测试代理最快捷的方式。这些命令演示如何通过 Proxonym 网关发送请求、固定粘性 IP、定位指定地区，以及解读网关错误。

- 共 6 步
- 12 分钟完成配置
- 复制即用的代码

开始之前

- cURL（macOS、大多数 Linux 发行版以及 Windows 10 及更高版本均已内置）
- Proxonym 住宅代理或移动代理套餐
- 控制台中的代理用户名和密码

连接参数

- **主机**: `gw.proxonym.com`
- **HTTP**: `8000`
- **SOCKS5**: `1080`
- **用户名**: `USERNAME-country-us`

1. **检查 cURL 版本**: 任何较新的版本都支持 HTTP 和 SOCKS5 代理。在 Windows PowerShell 5.1 中，请输入 `curl.exe` 而不是 `curl`，因为在该环境下，单独的 `curl` 是 `Invoke-WebRequest` 的别名。 Shell `curl --version`
2. **通过网关发送请求**: 用 `-x` 传入网关地址，用 `-U` 传入凭据。api.ipify.org 返回的是目标网站看到的出口 IP，它不应该是您自己的地址。 Shell `curl -x http://gw.proxonym.com:8000 -U "USERNAME:PASSWORD" https://api.ipify.org`
3. **定位国家、州、城市或 ASN**: 用短横线将参数追加到用户名后：使用小写的 ISO 国家代码，地名中的空格用下划线代替，州和城市二选一，不要同时指定。ipinfo.io 会显示出口 IP 的所在位置。 Shell `# Any IP in Germany curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-de:PASSWORD" https://ipinfo.io/json # New York City, United States curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-city-new_york:PASSWORD" https://ipinfo.io/json # The state of California curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-state-california:PASSWORD" https://ipinfo.io/json # The Comcast network (ASN 7922) curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-asn-7922:PASSWORD" https://ipinfo.io/json`
4. **轮换 IP 或保持同一 IP**: 不带会话参数时，每个新连接都会获得一个新 IP，而每次运行 cURL 都会建立新连接。添加 `-session-` 并附上由 1 至 32 位字母和数字组成的 ID，即可保持同一 IP；再添加 `-lifetime-`，可将其保持 1 至 120 分钟（默认为 10 分钟）。 Shell `# Rotating: a new IP on every run for i in 1 2 3; do curl -s -x http://gw.proxonym.com:8000 -U "USERNAME-country-us:PASSWORD" https://api.ipify.org; echo done # Sticky: the same IP for up to 30 minutes for i in 1 2 3; do curl -s -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-session-a7k2-lifetime-30:PASSWORD" https://api.ipify.org; echo done`
5. **切换到 SOCKS5**: 使用 1080 端口和 `socks5h://` 协议前缀。末尾的 h 让 cURL 交由代理解析主机名，这样 DNS 查询就不会从您的机器发出。用户名参数的用法与 HTTP 完全相同。 Shell `curl -x socks5h://gw.proxonym.com:1080 -U "USERNAME-country-gb:PASSWORD" https://api.ipify.org`
6. **解读网关错误并重试**: 对于 HTTPS 目标，CONNECT 请求由网关响应，因此请输出 `%{http_connect}`，在目标网站状态码旁边查看网关的状态码。407 表示凭据错误，402 表示余额已用完或套餐已过期，403 表示目标网站已被屏蔽；429、502 和 504 值得重试（`--retry-all-errors` 需要 cURL 7.71 或更高版本）。 Shell `# Show the gateway status and the target status side by side curl -s -o /dev/null -w "gateway=%{http_connect} target=%{http_code}\n" \ -x http://gw.proxonym.com:8000 -U "USERNAME:PASSWORD" https://example.com # Retry transient failures up to 3 times curl --retry 3 --retry-all-errors --max-time 70 \ -x http://gw.proxonym.com:8000 -U "USERNAME:PASSWORD" https://example.com`

## 常见问题

### 为什么 cURL 显示网关返回 407？

网关未接受您的凭据。请从控制台重新复制用户名和密码，检查参数是否以短横线连接（USERNAME-country-us），并用引号包裹 -U 的值，以免 shell 改动其中的特殊字符。加上 -v 再次运行同一命令，即可看到 CONNECT 请求以及网关返回的确切状态码。

### cURL 应该使用 HTTP 代理还是 SOCKS5 代理？

两者使用同一个 IP 池，接受的用户名参数也相同。8000 端口上的 HTTP 通过 CONNECT 隧道传输 HTTPS，几乎所有工具都支持。1080 端口上的 SOCKS5 适合非 HTTP 客户端，配合 socks5h:// 协议前缀使用时，DNS 解析在代理端完成。对于普通的网页请求，HTTP 是更简单的默认选择。

### 如何让每个 cURL 请求都使用新 IP？

不要在用户名中加入会话参数。网关会为每个新连接分配新 IP，而每次运行 cURL 都会建立一个新连接。如果一条命令从同一主机获取多个 URL，cURL 可能会复用连接，从而沿用同一个 IP；因此，当每个请求都需要新地址时，请为每个请求单独运行一条命令。

### 如何确认出口 IP 的所在位置？

通过代理向 https://ipinfo.io/json 等地理位置查询端点发送请求。它会返回该 IP，以及网站可能看到的城市、地区、国家和网络信息。不同的地理位置数据库有时结果不一致，因此请先在国家或州一级核对准确性，并对比几次查询结果，然后再反馈位置不符的问题。

技巧与注意事项

- 用引号包裹 -U 的值，以免 shell 展开密码中的特殊字符（例如美元符号）。
- 添加 -v 可输出与网关之间的 CONNECT 交互过程，这是排查认证和定位问题最快捷的方法。
- cURL 也会读取 https_proxy 环境变量，但显式指定的 -x 始终优先，也更便于核查。
- 将 proxy 和 proxy-user 选项写入配置文件，再用 -K 加载，避免凭据留在 shell 历史记录中。

延伸阅读

- [SOCKS5 与 HTTP 代理：真正重要的协议差异](https://proxonym.com/zh/blog/socks5-vs-http-proxies)
- [轮换代理与粘性代理：如何选择合适的会话类型](https://proxonym.com/zh/blog/rotating-vs-sticky-sessions)

卡在某一步了？

大多数故障都可以从错误代码中找到原因。请先查看错误代码，再单独测试代理。

- [帮助中心](https://proxonym.com/zh/help)
- [网关错误代码](https://proxonym.com/zh/docs#errors-and-troubleshooting)
- [测试您的代理](https://proxonym.com/zh/proxy-checker)

## 更多集成指南

[全部集成](https://proxonym.com/zh/integrations)

- [AdsPower (指纹浏览器)](https://proxonym.com/zh/integrations/adspower)
- [Go](https://proxonym.com/zh/integrations/go)
- [Java](https://proxonym.com/zh/integrations/java)
