Postman 可以通过 System Proxy 或 Custom Proxy 让 API 请求经过代理服务器。如果电脑已经配置好系统代理，可让 Postman 继承；如果只希望 Postman 使用指定代理，则在 Proxy 设置中启用 Custom Proxy，填写协议、Host、Port 和认证信息。配置完成后，还要用同一个 IP 查询接口对比直连与代理结果，不能只看请求是否成功返回。
| 使用需求 | 推荐方式 | 主要检查项 |
|---|---|---|
| 跟随电脑现有代理 | System Proxy | 操作系统代理、Custom Proxy 是否关闭 |
| 只让 Postman 使用指定代理 | Custom Proxy | Use proxy for、协议、Host、Port、Proxy auth |
| 让部分目标不走代理 | Proxy bypass | 按当前版本填写逗号分隔的 Host 列表 |
| 判断代理是否生效 | 出口 IP 对比 | 直连结果、代理结果；按需核对地区与重复请求表现 |
本文按当前 Postman 官方代理配置文档整理，界面名称可能随版本调整。文中所说的代理，是 Postman 向 API 发送请求时使用的出站代理，不是用于抓取其他应用流量的 Postman 内置 Capture Proxy。
一、Postman 的 System Proxy 和 Custom Proxy 有什么区别？
System Proxy 读取电脑现有的代理配置，Custom Proxy 则由 Postman 单独保存并用于发送请求。两者解决的不是同一个管理问题：前者适合公司网络、VPN 或本机代理工具已经统一接管流量的环境；后者适合只想让 Postman 连接某个代理端点，而不改变其他软件网络设置的情况。
| 对比项 | System Proxy | Custom Proxy |
|---|---|---|
| 配置来源 | 操作系统网络代理 | Postman Proxy 页面中填写的代理参数 |
| 影响范围 | 系统里的其他应用也可能使用同一代理 | 主要作用于 Postman 发出的请求 |
| 适合场景 | 企业网络、本机代理工具、统一网络出口 | 单独测试代理、指定 API 出口、按目标设置绕过规则 |
| 同时开启时 | 按照 Postman 当前官方说明，Custom Proxy 会被优先使用 | |
如果只是为了让 Postman 请求经过代理，不要误入 Tools → Capture Proxy。Capture Proxy 的任务是监听并采集其他客户端的 HTTP/HTTPS 流量，不是给当前 Postman 请求配置远程出口。
二、Postman 怎么使用 System Proxy？
本文以 Postman 桌面应用为主。打开顶部的 Settings 图标，进入 App settings → Proxy；部分版本的入口可能直接显示为 Settings → Proxy。然后按以下顺序检查：
- 在 Proxy configurations for sending requests 下启用 Use system proxy。
- 根据实际环境检查 Respect
HTTP_PROXY,HTTPS_PROXY, andNO_PROXYenvironment variables 是否启用。该选项用于读取操作系统中的代理环境变量，不要把它和 System Proxy 本身混为一项设置。 - 先关闭 Use custom proxy configuration，避免测试 System Proxy 时实际走了 Custom Proxy。
- 保存设置后重新发送请求；如果配置没有按预期生效，可重启 Postman 再验证。
System Proxy 能否工作，取决于操作系统里是否已经存在可用代理。仅在 Postman 中打开这个开关，并不会自动生成代理服务器。系统代理需要账号密码时，桌面应用还提供 Default proxy configuration 的 Basic Authentication 凭证设置；具体入口与重启要求以当前版本的 默认代理说明为准。
Postman Web 与桌面应用的能力边界并不完全相同。官方当前说明中，Web 应用不能配置用于 Postman 自身联网的 Default Proxy；使用网页端或 Desktop Agent 时，应按实际运行方式核对代理设置，不要直接套用桌面应用截图。
三、Postman 怎么配置 Custom Proxy？
Custom Proxy 是这篇文章的核心设置。它允许 Postman 不依赖系统代理，直接连接你指定的 HTTP 或 SOCKS 代理服务器。
- 进入 App settings → Proxy。
- 在请求代理配置区域启用 Use custom proxy configuration。
- 在 Use proxy for 中选择哪些目标请求使用代理；当前界面通常可选择 HTTP、HTTPS 或两者。
- 在 Proxy server 中选择代理协议，再分别填写 Host 和 Port。Host 字段只填域名或 IP，不要重复加入
http://或socks5://。 - 代理需要 Basic Authentication 时，打开 Proxy auth 并填写 Username 与 Password。
- 不希望经过代理的目标，可在 Proxy bypass 中填写逗号分隔的 Host 列表。
Postman Custom Proxy 填写示例
| Postman 字段 | 示例填写 |
|---|---|
| Use proxy for | HTTP and HTTPS |
| Proxy protocol | HTTP |
| Host | proxy.example.com |
| Port | 7778 |
| Proxy auth | Enabled |
| Username | ****** |
| Password | ****** |
| Proxy bypass | 按实际需求填写 |
如果代理服务商提供的是 http://username:password@host:port 形式的连接信息，不要把整串地址复制进 Host。应分别对应到 Protocol、Host、Port、Username 和 Password。
填写完成后，再重点检查下面几个容易混淆的字段：
| 字段 | 填写内容 | 常见错误 |
|---|---|---|
| Use proxy for | 目标请求的 HTTP、HTTPS 类型 | 误以为这里选择的是代理服务器协议 |
| Proxy server | HTTP、SOCKS5、SOCKS5H 等协议，以及 Host、Port | 把协议前缀一起填进 Host，或选错服务商提供的协议 |
| Proxy auth | 代理服务器的 Basic Authentication 用户名与密码 | 填成目标 API 的 Token 或登录账号 |
| Proxy bypass | 不走 Custom Proxy 的 Host 列表 | 把需要验证代理的测试域名加入绕过列表 |
Postman 当前官方文档还列出了 SOCKS4 和 SOCKS4A。实际填写时以代理服务商给出的协议为准，不要只凭端口猜测。若不清楚 HTTP、HTTPS 与 SOCKS5 的使用边界，可先查看 代理协议区别与选型指南。Postman 通过 SOCKS 代理发送的是 HTTP/HTTPS 请求，它不是任意 TCP 或 UDP 流量的通用转发器。
如果使用 IPWeb，可在控制台提取 Host、Port、Username 和 Password；字段含义可对照 IPWeb 代理使用指南。示例截图中的地址和凭证只能作为字段位置参考，不要照抄。
四、Postman 代理账号密码怎么填写？
Proxy auth 验证的是 Postman 能否使用代理服务器；请求页里的 Authorization 验证的是目标 API 是否允许访问。两者可能同时存在，也可能只有其中一种。
| 认证位置 | 认证对象 | 填写内容 | 失败表现 |
|---|---|---|---|
| Settings → Proxy → Proxy auth | 代理服务器 | 代理 Username、Password | 可能返回 407，或代理连接被拒绝 |
| 请求页 → Authorization | 目标 API | Bearer Token、Basic Auth、API Key 等 | 常见为目标服务返回 401 或 403 |
Postman 当前 Custom Proxy 界面中的 Proxy auth 面向 Basic Authentication。若代理服务商使用 IP 白名单，应从已加入白名单的来源网络发起请求；若同时要求白名单和账号密码，则两项条件都要满足。部分ISP代理服务会通过 Username 携带国家、城市或 Session 等连接参数；如果服务商提供的是这种认证格式，应完整使用其生成的 Username，不要自行删减字段。
看到 407 Proxy Authentication Required 时，优先检查代理账号密码、IP 白名单、用户名参数和认证方式，不要反复修改目标 API 的 Authorization。完整排查路径可查看 407 代理认证错误解决指南。
不要在公开截图、团队聊天或工单中暴露完整代理凭证。需要提交故障证据时，只保留协议、Host、Port、错误状态和脱敏后的用户名结构。
五、怎么验证 Postman 请求真的经过代理？
最可靠的基础验证，是让直连和代理请求访问同一个公网 IP 查询接口，再比较响应。不要用“Send 按钮没有报错”替代出口检查。
1. 记录未使用代理时的公网 IP
临时关闭 System Proxy 与 Custom Proxy，新建一个 GET 请求，访问 https://api.ipify.org?format=json。发送后记录响应中的公网 IP。
2. 启用代理后再次请求
启用要测试的 System Proxy 或 Custom Proxy，确认测试域名没有进入 Proxy bypass，再向同一个 URL 发送请求。正常使用独立代理出口时，返回的公网 IP 通常应与直连结果不同；如果代理配置指定了国家或地区，再进一步核对出口 IP 的地理信息是否符合预期。
3. 根据代理类型做重复测试
| 代理类型 | 重复请求时重点观察 | 不能仅凭什么下结论 |
|---|---|---|
| 固定代理 | 多次请求是否保持同一公网出口 | 只成功一次 |
| Sticky Session | 同一 Session 是否在约定时长内保持出口 | 只比较两次紧邻请求 |
| 轮换代理 | 多次请求是否按产品规则变化 | 每次必须变化或永远不变 |
如果需要核对国家、城市或 ASN，应固定使用同一个查询来源，避免不同 GEO 数据库造成结论不一致。仍分不清本地地址、公网 IP 与代理出口时，可继续阅读 电脑 IP 查询与代理出口判断方法。
六、Postman 配置代理后连接失败怎么排查？
排查时先保留当前错误信息，再一次只改一个变量。优先确认实际启用的是 System Proxy 还是 Custom Proxy，然后检查代理端点、认证和目标请求，避免同时修改多个开关后无法判断原因。
| 错误或现象 | 优先检查 | 处理方向 |
|---|---|---|
407 Proxy Authentication Required |
Proxy auth、账号密码、白名单、完整用户名 | 先做代理认证排查，不要改 API Token |
| 连接超时或无法建立连接 | Host、Port、代理协议、本机到代理的网络可达性 | 确认端点有效，并排除防火墙或网络限制 |
| 证书或自签名 CA 错误 | 目标站证书、代理链路、企业 CA | 导入受信任 CA，区分目标 API 证书与代理产生的证书问题 |
| 请求成功但出口 IP 没变化 | Custom Proxy 是否启用、Use proxy for、Proxy bypass、环境变量 | 用同一 IP 查询接口复测，并确认请求是否实际使用代理 |
| 只有部分目标不走代理 | Proxy bypass、NO_PROXY、HTTP/HTTPS 选择 |
核对目标 Host 是否命中绕过规则 |
| System Proxy 与 Custom Proxy 结果不一致 | 两个开关是否同时启用 | 单独测试一种模式；同时开启时按当前规则使用 Custom Proxy |
| 已关闭代理但请求仍像在走代理 | HTTP_PROXY、HTTPS_PROXY 等系统环境变量 |
检查 Postman 是否仍读取代理环境变量，并在排查时临时移除相关变量后复测 |
怎么用 Postman Console 辅助排查代理？
如果出口 IP 与预期不一致，或 Postman 只显示连接失败，可以打开 Postman Console 后重新发送请求。结合 Console 中的请求记录和错误信息，判断请求是否按预期使用代理，以及失败发生在代理连接、代理认证还是目标 API 请求阶段。
- 打开 Postman Console。
- 重新发送发生问题的请求。
- 对照 Proxy 设置与 Console 信息，确认请求是否按预期使用代理，并记录具体错误。
分享 Console 内容前，应脱敏代理用户名、认证头、Cookie、Token 和业务数据。
遇到内部 CA 或自签证书时，优先在 Settings → Certificates 中添加受信任的 CA，而不是长期关闭 SSL certificate verification。Postman 对 CA 与客户端证书的当前处理方式可参考 Postman Certificate settings。
七、Postman 代理常见问题
1. Postman 的 System Proxy 和 Custom Proxy 有什么区别？
System Proxy 使用操作系统现有代理；Custom Proxy 在 Postman 内单独填写代理协议、Host、Port 和认证信息。若两者同时启用，当前官方说明以 Custom Proxy 为准。
2. Postman 可以单独设置代理而不修改系统代理吗？
可以。关闭 System Proxy，启用 Use custom proxy configuration，然后填写代理参数。这样无需为了测试 Postman 请求而改动整台电脑的系统代理。
3. Postman 代理账号密码和 API Authorization 是一回事吗？
不是。Proxy auth 用于向代理服务器认证；请求页中的 Authorization 用于向目标 API 认证。代理返回 407 时，应先检查 Proxy auth；目标 API 返回 401 或 403 时，再检查 API Token、权限和目标服务规则。
4. 为什么配置代理后出口 IP 没变化？
先检查 Custom Proxy 是否真正启用、Use proxy for 是否覆盖当前请求类型、测试域名是否进入 Proxy bypass，以及系统环境变量是否改变了请求路径。然后用同一 IP 查询接口分别测试直连和代理结果。
5. Postman 出现 407 怎么处理？
407 Proxy Authentication Required 表示请求到达了要求代理认证的代理服务器，但当前请求没有提供可接受的代理认证凭证。核对代理 Username、Password、来源 IP 白名单和服务商要求的用户名参数；不要把目标 API 的 Authorization 当成代理凭证。若最小配置仍返回 407，应按代理认证专项流程继续定位。
最终验收至少确认三项：Postman 实际使用的代理模式和端点、代理后的公网出口，以及重复请求时的出口表现。界面显示已启用或请求返回成功，都不能单独证明代理已经按预期生效。
