# Postman 代理接入示例

在 Postman 桌面应用中配置自定义代理、账密认证并验证 HTTPS 出口。

Postman 适合人工验证接口和代理连通性。这里配置的是“发送请求时使用的外部代理”，不是用于抓取其他设备流量的本地调试代理。

## 前置条件

- 使用 Postman 桌面应用；代理设置入口和字段名称可能随版本调整。
- 从控制台取得当前有效的代理主机、端口、用户名和密码。
- 先关闭与本次测试无关的系统代理，避免请求走错链路。

## 配置自定义代理

1. 打开 Postman 设置中的 **Proxy** 页面。
2. 在发送请求的代理配置中启用自定义代理。
3. 请求类型选择 HTTP 和 HTTPS，代理协议按本次链路选择 HTTP 或 SOCKS5。
4. 主机填写 `<gateway-host>`，端口填写 `<gateway-port>`，主机字段不要附加协议前缀。
5. 启用代理认证，用户名填写 `<proxy-username>`，密码填写 `<proxy-password>`。
6. 确认自定义代理优先级，避免系统代理与自定义代理同时影响测试结果。

只只HTTP代理的 SOCKS5 客户端链路仅用于 TCP 请求；HTTP 代理可用于 HTTP 请求，也可通过 CONNECT 访问 HTTPS 目标。

## 发送验证请求

1. 新建 GET 请求，地址填写 `https://<public-test-host>/ip`。
2. 将请求超时设置为可控值，例如 30 秒。
3. 发送请求并检查状态、响应正文、出口 IP 与地区。
4. 再发送一个允许访问的业务测试请求，确认结果与出口检测一致。

## 预期结果

- HTTPS 请求通过自定义代理完成，响应显示代理出口。
- 地区与账密配置相符；随机区域以当前出口为准。
- 关闭自定义代理后，同一检测请求应恢复为本机出口，可用于对照链路。

## 常见失败

- 407：重新核对完整用户名、密码和当前套餐权益。
- 连接超时：检查主机、端口、本机网络和代理协议选择。
- 地区不符：确认用户名地区参数及是否仍在使用旧系统代理。
- TLS 错误：先检查设备时间、证书链和中间网络，不要关闭证书校验。

## 安全提示

不要把包含代理密码的工作区、环境或导出文件共享给他人。截图、控制台日志和问题反馈中应隐藏用户名、密码、代理地址及请求认证信息。