在 Postman 自定义代理中分开填写主机与认证,开启 HTTPS 代理,再用一次授权请求完成测通。
Postman Desktop 可以通过自定义住宅代理发送请求。不同版本的菜单名称可能变化,但安全映射不变:开启自定义代理,主机字段不带协议与凭据,端口单独填写,开启 HTTPS 代理,并把代理认证放在独立字段。本文所有值都是假值。不支持中国大陆使用。
准备这些值
| 字段 | 假示例 | 规则 |
|---|---|---|
| Proxy host | `proxy.example.invalid` | 不带协议、路径或凭据 |
| Proxy port | `10000` | 使用控制台值 |
| Proxy username / password | `USER_EXAMPLE` / `PASS_EXAMPLE_NOT_REAL` | 填入独立 Proxy Auth 字段 |
配置 Postman
- 打开桌面应用的 Settings,找到 Proxy;不同版本的具体名称可能变化。
- 开启 Custom proxy configuration 或等价开关。
- 主机填 `proxy.example.invalid`,端口填 `10000`;主机不要加协议或凭据。
- 开启让代理应用到 HTTPS 请求的选项。
- 开启代理认证,把 `USER_EXAMPLE` 和 `PASS_EXAMPLE_NOT_REAL` 分别填入对应字段。
- 保存或关闭设置,再向一个授权 URL 发送请求。
| 开关 | 第一次测通建议 | 原因 |
|---|---|---|
| Use system proxy | 测自定义网关时关闭 | 排障时避免两层代理 |
| Custom proxy | 开启 | 让请求经过指定网关 |
| Proxy HTTPS requests | 开启 | 让 HTTPS 目标经过网关 |
| Proxy Auth | 用户名密码订单开启 | 向网关提供认证 |
ZTProxy 不声称 IP 白名单认证是 Postman 的官方能力。除非你的实际环境与 Postman 版本明确支持其他方式,否则使用控制台返回的用户名密码认证。
核对结果
| 结果 | 含义 | 处理 |
|---|---|---|
| 返回预期响应 | 代理路径已工作 | 在经批准的端点核对来源 IP |
| HTTP 407 | 认证缺失或被拒绝 | 重新复制认证,并确认放在 Proxy Auth 而非请求 Authorization |
| 超时 | 网关、协议、防火墙、DNS 或目标异常 | 与 curl 测通对照 |
| 仍是本地直连 IP | 代理开关未生效或被绕过 | 重新检查自定义代理与系统代理设置 |
需要轮换出口时用动态住宅,订单周期内需固定出口时用静态住宅。详情见代理格式、HTTP / SOCKS5 设置、文档快速开始和407 / 超时排查。
FAQ
HTTP 407 表示什么?
客户端已经连接到网关,但代理认证缺失或被拒绝。重新从控制台复制用户名和密码,并放在认证字段中。
请求为什么超时?
依次检查协议、主机、端口、本地防火墙、DNS 和授权目标,再把测试缩小为带有限超时的一次请求。
主机字段要带协议吗?
不要。主机字段只放主机名;只有库要求代理 URL 时,才在对应 URL 字段添加协议。
HTTPS 代理需要开启吗?
通过 HTTP 代理网关发送 HTTPS 请求时需要。Postman 不同桌面版本的标签可能变化,请以当前 Settings 页面为准。
怎么确认实际出口?
访问一个你有权使用、能显示来源 IP 的页面,把结果与目标地区或静态订单核对;不要把网关主机名当成出口。
粘性会话能替代静态 IP 吗?
不能。粘性是在动态池上有限时间尽量保持同一出口;静态住宅订单是在订单周期内使用分配的固定出口。
可以直接使用本文占位凭据吗?
不可以。示例域名不可解析,所有凭据都是假的。请复制控制台当前值。
中国大陆可以使用吗?
不可以。ZTProxy 代理服务不支持在中国大陆使用。仅可访问合法、已授权的目标。
下一步
向一个授权目标发送请求并核对实际出口,之后只在可信设备保存配置。不要把真实代理凭据放入共享 collection、截图或导出的 environment。