curl 代理怎么配置？HTTP、SOCKS5 与出口验证

填写认证信息且不暴露凭证

curl --proxy http://HOST:PORT \
  --proxy-user "USERNAME:PASSWORD" \
  --max-time 20 https://TARGET.EXAMPLE

文档中只使用占位符。自动化运行时应从仓库外的受保护密钥或环境中读取凭证，分享详细日志前还要先脱敏。

终端关闭后，命令历史仍可能保留参数。真实凭证应通过受保护的运行时输入或密钥注入方式提供，分享终端记录前还要删除误留的敏感历史。

socks5 与 socks5h 的选择

curl --proxy socks5://HOST:PORT https://TARGET.EXAMPLE
curl --proxy socks5h://HOST:PORT https://TARGET.EXAMPLE

需要在本机解析目标域名时使用 socks5；需要由代理端点解析目标域名时使用 socks5h。如果实际分配的端点不支持 SOCKS5，应改用账号文档中给出的协议。

DNS 模式决定当前测试的对象。本机解析用于确认工作站能否解析目标，代理端解析用于确认已分配连接路径能否解析；只有解析模式相同的两次测试才适合对比。

最终选择前，先确认这次任务到底需要连续复核，还是需要多个独立样本。

静态住宅地址的重点是连续性，动态住宅地址的重点是独立样本。两者都不应被写成结果保证。

需要进一步了解时，可以查看 静态住宅代理说明、动态住宅代理说明 和 IPIPD 价格页。

命令和参数以 curl 命令行官方文档 为技术核对依据。

检查完成后：验证连接与出口 IP

curl --proxy http://HOST:PORT \
  --proxy-user "USERNAME:PASSWORD" \
  --silent --show-error --write-out "status=%{http_code} time=%{time_total}\n" \
  https://IP-ECHO.EXAMPLE

只有返回 IP 还不够，记录中还应包含请求时间、协议、端点标签、HTTP 状态和预期结果。-v 只在排障时使用，日志对外分享前必须脱敏。

出口 IP 验证还应搭配一次普通的授权目标请求。这样可以区分“代理连接已建立”和“具体应用返回了什么”，避免把一次 IP 回显成功扩大成所有目标都会成功。

常见错误排查清单

407 通常指向代理认证缺失或被拒绝；连接被拒绝要检查主机、端口、网络可达性和协议；域名解析失败要核对 socks5 与 socks5h 是否符合预期 DNS 路径；超时则逐项检查并一次只改变一个字段，无法解释结果时恢复原设置。

示例仅用于已授权的公开页面核验和连接测试，并应使用账号实际分配的协议与认证字段。本文对 IPIPD 产品的表述只限静态住宅地址和动态住宅地址，不承诺访问或平台结果。

需要使用详细日志时，只保存最短的一次失败请求。工单附件中应删除凭证、Cookie、认证头和不必要的目标参数。

curl 终端测试记录如何交接

curl 交接记录应保存脱敏命令、curl 版本、代理端点协议、DNS 模式、目标主机、状态码、耗时和恢复命令。不要只写“测试成功”，也不要附上含有用户名、密码、Cookie 或认证头的完整详细日志。

复核人员要确认代理 URL 与目标 URL 没有混淆，并检查 socks5 或 socks5h 是否符合本次解析目的。出现 407、连接拒绝、解析失败或超时时，只改变一个字段，再用同一目标复测。

连续核验可以保留同一静态住宅地址条件，彼此独立的公开页面样本可以使用动态住宅地址并分别编号。两种记录都应遵守目标规则；字段不足时恢复原命令，不扩大请求范围。

基线测试应尽量小：一个端点、一种 DNS 模式、一个允许访问的目标和一个预期响应。重定向、证书错误与代理认证要分开记录，后续人员才能判断应检查本地解析器、已分配端点还是目标响应，而不用重复无关命令。每次修改前都先保留这条基线。