← 返回博客
RUENZHESARPTDEFRJAKOITTRIDVIFAHI

在Postman中设置代理以测试API：带示例的完整指南

了解如何在Postman中正确设置代理以测试API：全局和单独设置，HTTP/SOCKS5的使用，身份验证和解决常见问题。

📅2026年2月28日
```html

Postman是全球开发人员、QA工程师和后端专家最受欢迎的API测试工具之一。但是，如果您需要测试仅在特定区域可用的API，绕过IP阻止或需要从不同位置验证请求，该怎么办？解决方案是在Postman中设置代理服务器。

在本指南中，您将学习如何在Postman中正确设置代理以应对各种场景：从简单的流量路由到处理地理限制的端点，以及通过企业代理服务器调试请求。我们将讨论全局和个性化的代理设置，处理HTTP和SOCKS5协议，身份验证和解决常见问题。

测试API时为什么需要代理

在API测试的背景下，代理服务器解决了几个关键任务，这些任务无法通过Postman的标准工具完成。理解这些场景将帮助您正确选择代理类型并根据特定需求进行配置。

测试地理限制的API。许多现代API根据客户端的地理位置返回不同的数据。例如，天气服务API、流媒体平台、金融应用程序或市场。要测试您的应用程序在德国、美国或日本的用户的工作情况，您需要一个来自相应国家的IP地址的代理服务器。没有代理，您将无法在物理上重现其他地区用户的API行为。

绕过速率限制和IP阻止。在密集测试API时，您可能会遇到来自单个IP地址的请求数量限制。许多服务在IP级别上使用速率限制——例如，来自单个地址每分钟不超过100个请求。轮换代理可以将请求分散到多个IP地址之间，并继续测试而不延迟。这在负载测试或自动化检查时尤其重要。

通过企业代理工作。如果您在网络政策严格的公司工作，所有出站流量可能都需要通过企业代理服务器。在这种情况下，在Postman中设置代理不是选择，而是必需。没有正确的配置，您的请求将无法到达外部API。

调试和监控流量。代理服务器可以用于拦截和分析HTTP/HTTPS流量。像Charles Proxy、Fiddler或mitmproxy这样的工具可以查看每个请求和响应的详细信息，包括标题、请求体、执行时间。通过这样的代理配置Postman，您将获得一个强大的工具，用于调试复杂的API交互。

重要：对于具有地理限制的API测试，建议使用住宅代理，因为它们使用真实的家庭用户IP地址，不会被服务识别为代理服务器。这对于测试的准确性至关重要。

Postman中的全局代理设置

Postman提供两种主要的代理设置方式：全局（适用于所有请求）和个性化（适用于特定集合或请求）。我们先从全局设置开始，这些设置位于应用程序的设置菜单中。

访问代理设置的逐步指南：

  1. 打开Postman并点击应用程序右上角的齿轮图标（设置），或使用快捷键Ctrl+,（Windows/Linux）或Cmd+,（macOS）。
  2. 在打开的设置窗口中，转到Proxy选项卡。
  3. 在这里，您将看到几个代理服务器配置选项，我们将在下面详细讨论。

在代理设置部分，您将找到三种主要的代理工作模式：

  • 使用系统代理 — 使用您操作系统的系统代理设置
  • 添加自定义代理配置 — 手动设置自己的代理服务器
  • 全局代理配置 — 全局配置，允许为HTTP和HTTPS指定不同的代理

每种模式都有其优点，并适用于不同的使用场景。让我们详细讨论它们。

使用系统代理设置

在Postman中设置代理的最简单方法是使用系统代理设置。如果您在企业环境中工作，代理已经在操作系统级别上配置，或者如果您使用自动配置系统代理的VPN客户端，这种模式特别方便。

如何启用系统代理：

  1. 打开Postman中的设置 → 代理。
  2. 勾选使用系统代理。
  3. Postman将自动从您的操作系统配置中识别代理设置。
  4. 点击更新按钮以保存更改。

启用此选项后，Postman将使用与您的浏览器或其他应用程序相同的代理设置。这意味着，如果您在Windows（设置 → 网络和互联网 → 代理）、macOS（系统偏好设置 → 网络 → 高级 → 代理）或Linux（通过环境变量）中配置了代理，Postman将自动获取这些参数。

限制：系统设置不允许灵活管理不同请求的代理。如果您需要测试来自不同地区的API或在代理服务器之间切换，最好使用自定义配置。

设置自定义代理服务器

自定义代理设置使您可以完全控制流量路由。您可以指定特定的代理服务器、端口、协议类型，甚至为HTTP和HTTPS请求设置不同的代理。这种方法非常适合使用商业代理服务或自己的代理基础设施进行测试。

自定义代理的逐步设置：

  1. 打开Postman中的设置 → 代理。
  2. 确保使用系统代理选项已关闭。
  3. 启用添加自定义代理配置选项。
  4. 在代理类型字段中选择协议：HTTP、HTTPS或SOCKS5。
  5. 在代理服务器字段中输入您的代理服务器地址（例如，proxy.example.com或IP地址192.168.1.100）。
  6. 在代理端口字段中指定端口（通常HTTP为8080，SOCKS5为1080，但取决于您的提供商）。
  7. 如果代理需要身份验证，请启用代理身份验证选项并输入用户名和密码。
  8. 点击更新以应用设置。

保存设置后，所有来自Postman的出站请求将通过指定的代理服务器。您可以通过向IP检查服务发送测试请求来验证设置的正确性，例如： 

GET https://api.ipify.org?format=json

在响应中，您应该看到您的代理服务器的IP地址，而不是您真实的IP。如果IP没有改变，请检查输入的数据是否正确，并确保代理服务器正常工作。

为HTTP和HTTPS设置不同的代理

Postman允许为HTTP和HTTPS流量设置单独的代理服务器。这在您与企业基础设施合作时非常有用，因为对于安全连接使用单独的代理进行SSL检查。

要进行单独设置：

  1. 在代理设置部分启用全局代理配置。
  2. 您将看到两个单独的块：HTTP代理和HTTPS代理。
  3. 为每个块指定自己的服务器、端口和身份验证数据。
  4. 保存更改。

现在HTTP请求将通过一个代理，而HTTPS请求将通过另一个代理。这在混合基础设施测试中尤其相关。

处理需要身份验证的代理

大多数商业代理服务和企业代理要求身份验证才能访问。Postman支持代理服务器的基本HTTP身份验证（Basic Auth），这允许安全地传递凭据。

代理身份验证的设置：

  1. 在代理设置（设置 → 代理）中启用代理身份验证选项。
  2. 在用户名字段中输入您的代理提供商提供的用户名。
  3. 在密码字段中输入密码。
  4. 点击更新以保存。

Postman将自动为每个通过代理的请求添加Proxy-Authorization头。凭据以编码形式（Base64）传递，但为了最大安全性，建议使用HTTPS代理或带加密的SOCKS5。

提示：如果您使用商业提供商的代理，凭据通常以格式username:password@host:port提供。在Postman中，您需要将这些数据分开输入：服务器和端口在相应字段中，用户名和密码在代理身份验证部分。

使用住宅代理的设置示例

假设您使用住宅代理测试API，该API为来自美国和欧洲的用户返回不同的内容。您的代理提供商提供了以下数据：

  • 服务器：us.residential.proxy.com
  • 端口：8080
  • 用户名：user_12345
  • 密码：SecurePass789

在Postman中的设置将如下所示：

  • 代理类型：HTTP
  • 代理服务器：us.residential.proxy.com
  • 代理端口：8080
  • 代理身份验证：启用
  • 用户名：user_12345
  • 密码：SecurePass789

应用设置后，您所有的请求将使用来自美国的IP地址，这将允许您测试API的地理特定行为。

在Postman中设置SOCKS5代理

SOCKS5是一种比HTTP/HTTPS更通用的代理协议。它在网络堆栈的较低层工作，可以代理任何类型的流量，而不仅仅是HTTP。SOCKS5在测试使用非标准协议的API或需要最大匿名性时特别有用。

SOCKS5在API测试中的优势：

  • 支持任何协议（HTTP、HTTPS、WebSocket、FTP等）
  • 不修改请求头（与HTTP代理不同）
  • 支持UDP流量（对于某些实时API相关）
  • 内置协议级别的身份验证支持
  • HTTPS连接的更好性能（没有双重SSL握手）

在Postman中设置SOCKS5：

  1. 打开设置 → 代理。
  2. 启用添加自定义代理配置。
  3. 在代理类型字段中选择SOCKS5。
  4. 输入SOCKS5服务器的地址和端口（通常为1080，但取决于提供商）。
  5. 如果需要身份验证，请启用代理身份验证并输入凭据。
  6. 保存设置。

重要的是，并非所有代理提供商都支持SOCKS5。如果您需要此协议进行测试，请向提供商确认SOCKS5端点的可用性。例如，移动代理通常提供SOCKS5以及HTTP/HTTPS，以获得最大灵活性。

设置代理绕过规则

有时，您需要让部分请求通过代理，而部分请求直接发送。例如，您通过代理测试外部API，但也在与本地开发服务器（localhost）合作，该服务器应直接访问。对于这种场景，Postman提供了设置代理绕过规则（Proxy Bypass）的选项。

如何设置绕过规则：

  1. 在设置 → 代理中找到为这些主机和域绕过代理部分。
  2. 输入应绕过代理的域名或IP地址列表，用逗号分隔。
  3. 支持掩码：例如，*.internal.company.com将排除所有子域。
  4. 保存更改。

绕过规则示例：

  • localhost — 本地主机的绕过
  • 127.0.0.1 — loopback地址的绕过
  • 192.168.*.* — 整个本地网络的绕过
  • *.dev.company.com — 内部开发服务器的绕过
  • api.internal.service — 特定内部API的绕过

绕过规则在混合环境中特别有用，在这些环境中，您同时测试外部API（通过代理进行地理定位或绕过限制）和内部服务（直接进行速度和调试的简单性）。

实际示例：您正在开发一个移动应用程序，该应用程序与外部地理定位API（需要来自不同国家的代理）和内部身份验证API（在auth.mycompany.local上）合作。将*.mycompany.local添加到绕过规则中，内部请求将直接发送，而外部请求将通过代理发送。

代理在Postman中的实际使用场景

理论很好，但让我们看看在测试API时使用代理的实际场景。这些示例将帮助您理解如何应用代理设置以解决特定任务。

场景1：测试音乐流媒体服务的地理限制API

任务：您的公司正在开发一个音乐流媒体的移动应用程序。由于许可证限制，API根据用户所在国家返回不同的曲目目录。您需要测试来自美国、德国和日本的用户是否看到正确的内容。

解决方案：

  1. 获取来自三个国家的住宅代理：美国、德国、日本。
  2. 在Postman中创建三个环境（Environments）：“美国测试”、“德国测试”、“日本测试”。
  3. 在每个环境中创建代理设置的变量（尽管Postman不直接支持在代理设置中使用变量，您可以在环境描述中记录它们）。
  4. 在测试每个区域之前，手动切换代理设置（设置 → 代理）。
  5. 向API发送请求：GET https://api.musicservice.com/v1/catalog
  6. 比较结果：响应中应有不同的曲目供每个国家使用。

为了自动化此过程，可以使用Newman（Postman的CLI版本）与代理参数，这将允许从CI/CD管道中运行测试，并自动切换代理。

场景2：在负载测试中绕过速率限制

任务：您正在测试一个公共API的性能，该API对来自单个IP的请求限制为每分钟100个请求。为了进行全面的负载测试，您需要在一分钟内发送1000个请求。

解决方案：

  1. 使用10个以上的代理服务器池进行轮换。
  2. 在Postman集合运行器中设置您的测试请求。
  3. 在预请求脚本中添加代理轮换的逻辑（注意：Postman不支持在脚本中程序性地切换代理，因此最好通过Newman与外部脚本实现此场景）。
  4. 替代方案：使用具有自动IP轮换的代理提供商（短TTL的粘性会话）。

对于这种场景，数据中心代理与轮换非常合适——它们提供高速度并允许在多个IP地址之间分配负载。

场景3：调试HTTPS API与SSL检查

任务：您正在与外部API集成，该API返回500错误，但未提供错误的详细信息。您需要查看HTTPS请求和响应的完整内容，包括所有头部和主体。

解决方案：

  1. 安装HTTPS流量拦截工具：Charles Proxy、Fiddler或mitmproxy。
  2. 将工具配置为监听端口（通常Charles为8888，Fiddler为8888）。
  3. 在系统中安装工具的SSL证书（通常在应用程序中有说明）。
  4. 在Postman设置 → 代理中将代理设置为localhost:8888。
  5. 在Postman中禁用SSL验证（设置 → 常规 → SSL证书验证 → 关闭）以进行测试。
  6. 从Postman发送问题请求。
  7. 在Charles/Fiddler中，您将看到请求和响应的完整转储，包括解密的HTTPS流量。

此方法对于调试复杂的API问题至关重要，尤其是在文档不完整或错误发生在服务器端时。

场景4：通过企业代理测试带有白名单的API

任务：您在一家大型公司工作，所有出站流量都通过企业代理。代理仅允许访问白名单域名。您需要测试一个新的外部API，但该API尚未添加到白名单中。

解决方案：

  1. 向IT部门提交请求，将API域名添加到白名单中（可能需要几天或几周）。
  2. 为了立即测试：使用个人移动互联网或设置VPN。
  3. 在Postman中将API域名添加到代理绕过规则中（为这些主机绕过代理）。
  4. 连接到替代网络（移动热点，通过VPN的家庭Wi-Fi）。
  5. 进行测试。
  6. 在将域名添加到企业白名单后，删除绕过规则并通过标准代理工作。

此场景展示了在企业环境中灵活配置代理和绕过规则的重要性。

解决使用代理时的常见问题

即使在正确配置代理的情况下，问题也可能会出现。让我们看看最常见的错误及其解决方法。

问题1：“无法获取任何响应”或“错误：连接ETIMEDOUT”

原因：

  • 代理服务器不可用或地址/端口不正确
  • 代理需要身份验证，但未提供凭据
  • 防火墙阻止了与代理的连接
  • 代理服务器过载或暂时不可用

解决方案：

  1. 通过终端检查代理的可用性：curl -x http://proxy:port https://api.ipify.org
  2. 确保地址和端口正确（没有多余的空格，正确的协议）
  3. 检查身份验证是否启用以及用户名/密码是否正确输入
  4. 尝试从您的池中使用其他代理服务器
  5. 暂时在Postman中禁用代理，检查请求是否可以直接工作

问题2：“407代理身份验证所需”

原因：代理需要身份验证，但未提供凭据或凭据不正确。

解决方案：

  1. 在Postman的设置中启用代理身份验证
  2. 检查用户名和密码的正确性（注意大小写、特殊字符）
  3. 确保您的IP地址在代理提供商的白名单中（如果适用）
  4. 检查凭据的有效期（某些提供商生成临时密码）

问题3：使用HTTPS代理时的SSL/TLS错误

典型错误：“SSL证书问题”、“无法验证第一个证书”、“证书链中的自签名证书”。

原因：

  • 代理执行SSL检查并插入自己的证书
  • 代理的证书未在您的系统中安装为受信任的证书
  • API端的证书链问题

解决方案：

  1. 为了测试目的：在Postman中禁用SSL验证（设置 → 常规 → SSL证书验证 → 关闭）。注意：不要在生产环境中使用此功能！
  2. 对于生产环境：在系统和Postman中安装代理的根证书（设置 → 证书 → CA证书）
  3. 使用不进行SSL检查的代理（SOCKS5或HTTP代理与SSL直通）
  4. 联系代理管理员以获取正确的证书

问题4：通过代理请求的速度慢

原因：

  • 代理服务器距离您或目标API地理位置较远
  • 代理过载（特别是对于免费或便宜的代理）
  • 代理提供商的连接速度慢
  • 双重SSL加密（您的客户端 → 代理 → API）

解决方案：

  1. 选择离目标API更近的代理服务器（如果API在美国，请使用美国的代理）
  2. 切换到更快的代理类型（例如，对于不需要地理位置的任务，从住宅代理切换到数据中心代理）
  3. 对于HTTPS请求，使用SOCKS5而不是HTTP（减少开销）
  4. 考虑使用保证带宽的高级代理
  5. 对于不关键的请求，暂时禁用代理

问题5：尽管代理已设置，但IP地址未更改

原因：

  • 代理已设置，但未激活（忘记点击更新）
  • API域名已添加到代理绕过规则中
  • 系统代理覆盖了Postman的设置
  • DNS请求直接发送（DNS泄漏）

解决方案：

  1. 检查代理是否确实处于活动状态：向https://api.ipify.org发送请求并检查响应中的IP
  2. 如果您使用自定义代理，请确保禁用“使用系统代理”
  3. 检查绕过域名列表并删除目标域名（如果存在）
  4. 在更改代理设置后重启Postman

调试提示：创建一个测试请求到IP检查服务（例如，https://api.ipify.org、https://ifconfig.me或https://api.myip.com），并将其保存在单独的“代理测试”集合中。在每次更改代理设置后发送此请求以快速检查。

结论

在Postman中设置代理是扩展API测试功能的强大工具。您学习了如何设置系统和自定义代理服务器，处理HTTP和SOCKS5协议，配置身份验证和绕过规则。这些技能将使您能够有效地测试地理限制API，绕过速率限制，通过企业代理工作，并通过流量拦截工具调试复杂问题。

本文的主要结论是...

```