curl 代理接入示例

curl 示例适合最小验证和服务器健康检查。真实值只通过受控环境变量或密钥注入。

HTTP/HTTPS

curl --connect-timeout 10 --max-time 30 \
  --proxy "http://<proxy-username>:<proxy-password>@<gateway-host>:<gateway-port>" \
  "https://<public-test-host>/ip"

SOCKS5 TCP

curl --connect-timeout 10 --max-time 30 \
  --proxy "socks5h://<proxy-username>:<proxy-password>@<gateway-host>:<gateway-port>" \
  "https://<public-test-host>/ip"

准备

• 从控制台取得当前有效账密配置。
• 避免在 shell 历史和 CI 输出中回显密码。

执行

• HTTP 代理可以访问 HTTP 或 HTTPS 目标。
• SOCKS5 域名请求使用 socks5h。

验证步骤

1. 将真实配置放入受控环境变量或临时凭据存储，不把完整代理 URL 写进脚本仓库。
2. 分别运行 HTTP/HTTPS 与 socks5h 示例，保留连接超时和整体超时。
3. 检查 HTTP 状态码、返回的公网出口与地区，并与未使用代理时的出口对比。

预期结果

• 命令在 30 秒整体超时内返回成功状态，响应中的出口 IP 与本地公网 IP 不同。
• socks5h 由代理侧解析目标域名，避免把该域名先交给本地 DNS。

失败边界

• curl 在解析命令或代理 URL 时退出，说明请求尚未到达网关；407 才表示已到认证阶段。
• 检测地址成功不保证任意目标均可访问，目标 403、429 和业务内容需独立判断。

安全

• 调试输出需要删除 Proxy-Authorization。
• 不要把带密码的完整命令粘贴到工单。