指南 · curl

在 curl 中使用代理

curl 是检查代理是否正常工作的最快方式,完全独立于任何浏览器或扩展程序。Linux、macOS 以及 Windows 10、11 均内置了 curl 命令。本指南涵盖命令示例、如何查看输出以排查错误,以及如何为所有命令设置默认代理。

作者:Bùi Toàn · 更新于:19/11/2026

基础命令

  • 对于 ip:port:user:pass 格式,运行:curl -x http://IP:PORT -U user:pass https://api.ipify.org
  • 或者合并为单个字符串:curl -x http://user:pass@IP:PORT https://api.ipify.org
  • 输出内容必须是代理 IP。如果显示您的 ISP IP,则表示请求未经过代理。
  • 若还要检查国家/地区:将目标 URL 替换为 https://ipinfo.io/json。
  • 如果代理在 SOCKS5 或 HTTP + SOCKS5 模式下运行:curl -x socks5h://user:pass@IP:PORT https://api.ipify.org(socks5h 让代理端解析域名),或 curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org。

在 Windows 上

在 PowerShell 5.1 中,"curl" 是 Invoke-WebRequest 的别名,并非真正的 curl。请使用 curl.exe 代替 curl:curl.exe -x http://IP:PORT -U user:pass https://api.ipify.org。在命令提示符 (cmd) 以及 PowerShell 7 或更高版本中,curl 就是真正的 curl。

在 curl 中如何使用代理密码含有特殊字符的代理?

使用 user:pass@IP 格式时,密码中的 @ : / # % 等特殊字符必须进行 URL 编码——例如,@ 变为 %40,# 变为 %23。使用 -U "user:pass"(用双引号括起来)无需编码,且能减少错误。在 Linux 和 macOS 上,如果密码包含 $ 或 !,请使用单引号。

如何通过 curl 输出排查代理错误?

添加 -v 可查看各个步骤详情:"200 Connection established" 行表示代理已接受连接,下方的错误信息则显示问题究竟出自凭据、端口、网络还是目标网站。

添加 -v 查看详细信息

对于 HTTPS 网站,curl 会向代理发送 CONNECT 请求。出现 "< HTTP/1.1 200 Connection established" 行表示代理已接受连接。出现 "407 Proxy Authentication Required" 行则表明用户名或密码不正确。

连接失败 … 连接被拒绝

与 IP:port 的连接被立即拒绝:端口错误、代理已过期或未激活。请参阅有关连接被拒绝错误的指南。

连接超时

未收到响应:IP 错误、网络问题或防火墙阻止了该端口。添加 --connect-timeout 10 可避免等待时间过长。

CONNECT 隧道失败,响应 502 或 503

代理正在运行,但未能与目标网站建立连接。请尝试访问其他网站,以确定问题出在目标网站还是代理。

设置默认代理

设置环境变量,以便所有 curl 命令(以及许多其他工具)自动使用代理:在 Linux 和 macOS 上执行 export https_proxy="http://user:pass@IP:PORT" 与 export http_proxy="$https_proxy"。若要对单个命令绕过代理,可使用 --noproxy "*"。或者,在 ~/.curlrc 文件中添加 proxy = "http://user:pass@IP:PORT" 行。

还没有代理?购买自动开通的独享代理

9 个国家的独享 IPv4 代理,购买 2.000 个 IP 起低至 20.000₫/IP/月(1 个 IP 为 39.000₫),另提供越南与美国静态 ISP 代理。支持带用户名和密码的 HTTP(S) 与 SOCKS5,无限流量,付款后自动开通。越南代理目前仅使用 HTTP(S) 协议;SOCKS5 暂不可用。

立即购买代理

常见问题

为什么 https_proxy 的值仍然以 http:// 开头?+

该前缀指定的是 curl 如何连接到代理,而不是如何连接到目标网站。通过 HTTP 与 ONET 代理通信时,HTTPS 网站仍可通过 CONNECT 方法访问。使用 SOCKS5 时,该值以 socks5h:// 开头。

我可以在 ONET 代理中使用 --socks5 吗?+

可以,当代理在 SOCKS5 或 HTTP + SOCKS5 模式下运行时:curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org,或 -x socks5h://user:pass@IP:PORT。使用 socks5h 或 --socks5-hostname 可让域名在代理端进行解析。请注意,越南代理目前仅使用 HTTP(S) 协议;SOCKS5 暂不可用。