开发者快速开始

开始前需要完成实名认证并拥有可用动态住宅权益。首次接入优先使用账密认证建立最小闭环。

最小请求

curl --proxy 'http://us.zzhttp.com:7878' \
  --proxy-user "$PROXY_USERNAME:$PROXY_PASSWORD" \
  --connect-timeout 10 --max-time 30 \
  'https://ipinfo.io/json'

运行前，从控制台复制完整代理用户名和子账号密码，分别注入 PROXY_USERNAME 与 PROXY_PASSWORD。检测响应中的 ip 是出口地址，country 和 region 可用于初步核对地区。

选择链路

• 支持用户名密码的服务端程序使用账密认证。
• 需要批量管理网关地址时使用 API 提取。
• 来源 IPv4 白名单只用于 API 提取与共享端口认证。

准备安全配置

• 账密网关固定为 us.zzhttp.com:7878，从控制台取得完整用户名。
• 把密码放入服务端密钥系统。
• 不要把代理配置写入浏览器前端或 Git 仓库。

发起请求

• 先使用 HTTP 代理访问公开检测目标。
• 对比直连与代理的出口 IP；指定国家或州省时，再核对检测响应中的地区后接入业务请求。第三方定位可能存在偏差。
• 为连接和读取设置独立超时。

处理失败

• 依次检查 DNS、TCP、407、CONNECT、TLS 和目标响应。
• 保存请求时间、请求 ID 和脱敏阶段信息。