# 如何在 Postman 配置动态或静态代理？

在 Postman 桌面端设置自定义 HTTP 代理与代理认证，发送请求验证实际出口。

Postman 可通过外部代理发送 API 请求。本教程配置桌面端发送请求的自定义代理，不使用抓包代理入口。

## 步骤一：获取只只HTTP代理信息

- **动态住宅**：进入“动态住宅网络 → 账密认证”，取得 `us.zzhttp.com`、端口 `7878`、生成的完整代理用户名和对应子账号密码；协议按工具选择 HTTP 或 SOCKS5 TCP。先确认实名、权益、共享流量和子账号状态。
- **静态住宅**：进入“静态住宅网络 → IP 管理”，复制已交付、可用且未到期实例的实际 IP、端口与独立代理账密。静态购买无需实名认证，不使用动态网关、子账号或客户白名单。

详细获取步骤见[账密认证](/help/network/account-auth)和[静态住宅首次连接](/help/getting-started/static-residential-quickstart)。代理密码不是控制台登录密码。

## 步骤二：打开代理设置

进入“Settings → Settings / App settings → Proxy”，在发送请求的配置区域开启“Use custom proxy configuration”。不同版本名称略有差异，以当前 Proxy 页面为准。

## 步骤三：配置 HTTP 账密

“Use proxy for”勾选 HTTP 与 HTTPS 请求，“Proxy server”协议选择 HTTP，并填写主机、端口。开启“Proxy auth”，填写用户名和密码。代理认证与请求的 Authorization 是两处配置，不能将代理密码填进目标接口的认证字段。

| 工具字段 | 动态住宅填写 | 静态住宅填写 |
| --- | --- | --- |
| 主机 / IP / Server | `us.zzhttp.com` | 实例实际 IP |
| 端口 / Port | `7878` | 实例实际端口 |
| 用户名 / Username | 控制台生成的完整用户名 | 实例独立用户名 |
| 密码 / Password | 对应子账号密码 | 实例独立密码 |

主机字段不带协议前缀，四个字段分开填写。HTTP 代理可通过 CONNECT 访问 HTTPS 网站。

![Postman 自定义代理的连接字段来源示意图](/images/help/proxy-fields.webp)

这是通用字段示意图，不是 Postman 截图。确认检测域名不在“Proxy bypass”内。自定义配置开启时优先于系统代理，不需要更改电脑系统代理。当前官方文档也列出 SOCKS 协议支持；本篇使用 HTTP 示例，SOCKS5 账密按实际版本核对，不能套用 Chromium 扩展的限制。

## 步骤四：保存并发送请求

按页面提示应用设置，新建 GET 请求 `https://ipinfo.io/json`，点击“Send”，检查响应中的出口和地区；再发送允许测试的 HTTPS 请求。这里只配置 HTTP / HTTPS 请求，其他协议不据此推断支持。需要脚本式调试时见[现有 Postman 开发者示例](/developers/examples/postman)。

## 验证代理是否生效

在真正执行任务的环境中打开或请求 `https://ipinfo.io/json`，核对 `ip`、`country`、`region`，并与该环境未启用代理时的出口比较。动态网关主机与出口 IP 不相同，不要求检测结果等于网关解析地址。静态按实例标称出口核对；地区数据库可能存在偏差。再访问允许测试的 HTTPS 页面确认链路。

## 常见问题

- **连接失败或超时**：核对端点、端口、协议和执行环境网络，见[连接失败排查](/help/troubleshooting/connection-failed)。
- **认证失败**：动态核对完整用户名、子账号、权益与实际连接来源；静态核对实例当前凭据与有效期，不能靠补动态白名单解决。见[407 排查](/help/troubleshooting/proxy-auth-407)。
- **仍显示原出口**：确认代理已绑定到实际设备或任务，排除绕过列表、其他代理覆盖和旧配置。
- **检测成功但目标失败**：目标站点的 `403`、`429`、页面变化和代理连接错误分别排查，先降低并发并查看实际错误。

需要长期保持同一出口时使用静态实例；动态[粘性会话](/help/network/sticky-session)只在配置的会话周期内保持，不等于永久固定 IP。多个设备使用同一实例仍可能共用出口。截图、日志和任务导出中不要暴露完整凭据。

字段参考[Postman 官方代理配置](https://learning.postman.com/docs/getting-started/installation/proxy/)。