新品不限流量住宅代理:固定价格,流量不计量。 低至 $33.25/天

命令行 · 集成指南

如何在 cURL 中使用代理

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

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

开始之前

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

已是客户?您的用户名和密码就在控制台中。

  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,以及网站可能看到的城市、地区、国家和网络信息。不同的地理位置数据库有时结果不一致,因此请先在国家或州一级核对准确性,并对比几次查询结果,然后再反馈位置不符的问题。

准备好接入了吗?立即获取凭据

选择套餐,从控制台复制用户名和密码,然后运行上面的代码。

  • 按量付费
  • 即时开通
  • 支持加密货币
  • 不自动续费