安装和更新

Postman 可在 web 上的go.postman.co/home上获得，并作为 Mac（Intel 和 M1）、Windows（32 位/64 位）和 Linux（64 位）操作系统的本机桌面应用程序。

要获取 Postman 桌面应用程序的最新版本，请访问下载页面并为您的平台选择下载。

内容

• 在桌面上安装 Postman
  • 苹果
  • 视窗
  • Linux
• 在网络上使用 Postman
  • 浏览器要求
  • 安装 Postman 桌面代理
  • 网络限制
• 更新邮递员
• Chrome 应用程序（已弃用）
  • 迁移到本机应用程序
• 在防火墙后面使用 Postman
• 对 Postman 安装进行故障排除
• 下一步

在 Mac 上安装 Postman

Postman 适用于 macOS 10.11 (El Capitan) 及更高版本。

1. 下载最新的 Postman 应用程序。

   如果您的 Mac 配备 M1 处理器，请务必下载Mac Apple 芯片版本。

2. 如果您的浏览器将文件下载为 ZIP 文件，请在“下载”文件夹中找到该文件并将其解压缩。

3. 在“下载”文件夹中，双击该Postman文件进行安装。

4. 出现提示时，将文件移动到您的应用程序文件夹。这将确保可以正确安装未来的更新。

如果您使用第三方归档应用程序解压缩并安装 Postman，您可能会遇到“库未加载”错误。使用 Mac 的默认存档实用程序解压缩文件。

在 Windows 上安装 Postman

Postman 适用于 Windows 7 及更高版本。

1. 下载最新的 Postman 应用程序。
2. 选择并运行该.exe文件以安装 Postman。

Postman v9.4 是 Postman 应用程序的最后一个版本，同时支持 32 位和 64 位 Windows。v9.4 之后的所有 Postman 应用程序版本都只能在 64 位 Windows 上运行。您可以在 32 位 Windows 上继续使用 Postman v9.4 及更早版本。

在 Linux 上安装 Postman

您可以通过手动下载 Postman、使用Snap商店链接或使用命令在 Linux 上安装 Postman snap install postman。

要手动安装，请下载并解压缩应用程序，例如到Downloads目录中。

要从启动器图标启动应用程序，请创建一个桌面文件，对其命名并将其Postman.desktop保存在以下位置：

~/.local/share/applications/Postman.desktop

在文件中输入以下内容，替换为/path/to/Downloads文件所在位置，并保存：

[Desktop Entry]
Encoding=UTF-8
Name=Postman
Exec=/path/to/Downloads/Postman/app/Postman %U
Icon=/path/to/Downloads/Postman/app/resources/app/assets/icon.png
Terminal=false
Type=Application
Categories=Development;

Postman 支持以下发行版：

• Ubuntu 14.04 及更新版本
• 软呢帽 24
• Debian 8 及更新版本

某些 Linux 发行版的支持取决于 Electron 是否支持它们。请参阅Electron 的文档。

建议您安装Snap，因为它包含应用程序所需的所有库，并且它们与应用程序本身捆绑在一起。

避免使用该sudo命令启动 Postman，因为它会在 Postman 创建的文件上产生权限问题。

~/.config确保您对Postman 存储信息的文件夹具有读/写权限。

如果您是 Ubuntu 18 用户，您还需要libgconf-2-4使用以下命令安装软件包apt-get install libgconf-2-4

在网络上使用 Postman

您可以在 Web 浏览器中使用 Postman 与 Postman 代理一起执行 API 开发和测试任务。要访问 Postman for Web，请访问go.postman.co/home。

浏览器要求

Postman for Web 针对以下浏览器进行了优化：

• 铬（78 及更高版本）
• 火狐（76 及更高版本）
• 边缘（79 及更高）
• Safari（13.1.1 及更高版本）

安装 Postman 桌面代理

如果您使用的是 Web 版 Postman，您还需要下载 Postman 桌面代理，这是一个在您的桌面本地运行的微应用程序。桌面代理克服了浏览器的跨对象资源共享 (CORS) 限制，并充当您从 Postman for Web 进行 API 调用的代理。

系统将提示您下载并安装桌面代理，以便您可以从 Postman for Web 发出请求。您也可以直接从Postman 代理页面下载代理。安装桌面代理后，您将能够将其用于 Web 请求。

要了解有关桌面代理的更多信息，请阅读介绍 Postman 代理博客文章。

为请求选择代理

从 Postman for Web 中，您可以选择要用于请求的代理：

• 自动选择：邮递员会自动为您的请求选择最佳代理。
• 云：手动选择此选项以使用 Postman 的云服务器发送 HTTP 请求。
• 桌面：手动选择此选项以使用 Postman 桌面代理发送请求。
• 浏览器：手动选择此选项以使用您的浏览器发送请求，但有一些限制。

如果您尝试发送请求但由于未选择代理而未成功，您将在响应区域中看到一个链接，您可以选择切换到代理并再次尝试您的请求。

网络限制

Postman for Web 正在积极开发中。您目前只能在桌面应用程序中访问一些功能，而不能在浏览器中访问：

• 查找和替换：Postman 桌面应用程序支持在工作区中查找和替换值，但此功能在 Postman for Web 上尚不可用。
• 证书和代理：Postman 桌面应用程序使您能够自定义证书和代理配置。在 Postman for Web 上，它们采用浏览器定义的值，并且不能被 Postman 覆盖。
• Postman 拦截器：拦截器将 cookie 从您的浏览器同步到 Postman 桌面应用程序，并直接从浏览器捕获网络请求。无法将 Interceptor 与 Postman for Web 一起使用。

更新邮递员

当有重大更新可用时，本机 Postman 应用程序会通知您。对于其他更新，您将在设置图标上看到一个点。如果指示灯为红色而不是橙色，则表示更新失败。

选择更新选项以下载或安装最新更新。下载完成后，您将看到一条通知，提示您重新启动 Postman 应用程序以应用更新。如果您还不想更新，请选择稍后在您下次启动应用程序时自动更新。

您可以在设置>更新中配置您的首选项以启用主要更新的自动下载。Postman 会自动下载次要更新和错误修复。

Postman Chrome 应用程序（已弃用）

Postman Chrome 应用程序已弃用。如果您使用 Chrome 应用程序，则可以在切换到使用 Postman时保留您的数据，方法是与您的 Postman 帐户同步或从 Chrome 导出并导入 Postman。

Postman 应用程序基于Electron构建，并克服了 Chrome 平台的许多限制。

• 本机应用程序可让您直接使用cookie。
• 与 Chrome 应用程序不同，拦截器不需要单独的扩展。
• 本机应用程序带有一个内置代理，您可以使用它来捕获网络流量。
• 本机应用程序不受菜单栏 Chrome 标准的限制。您可以检查更新、创建 Postman 窗口和选项卡以及编辑首选项。
• 本机应用程序允许您发送标头，例如Origin和User-Agent。这些在 Chrome 应用程序中受到限制。
• “不遵循重定向”选项存在于本机应用程序中，以防止返回 300 系列响应的请求被自动重定向——在 Chrome 应用程序中执行此操作需要拦截器扩展。
• 原生应用程序有一个内置的控制台，可以让您查看 API 调用的网络请求详细信息。

迁移到本机应用程序

要从 Chrome 应用切换到原生应用，请下载Postman 并登录您的帐户。启动本机应用程序，您的历史记录和收藏将自动同步。

或者，如果您不想登录您的 Postman 帐户，您可以从 Chrome 应用批量导出 Postman 数据，然后在设置>数据中批量导入新的原生应用。

请注意，导入将覆盖您现有的数据。有关批量导入的更多信息，请参阅导入 Postman 数据。

在防火墙后面使用 Postman

Postman 的基础设施在亚马逊的 AWS 平台上运行。如果您在网络防火墙后面操作，则需要允许以下域为 Postman 建立 WebSocket 连接：

• \*.getpostman.com
• \*.postman.co
• \*.pstmn.io
• \*postman.com

默认情况下，WebSocket 连接使用与 HTTP (80) 和 HTTPS (443) 相同的端口。

Postman 没有可以提供的固定 IP 范围。如有必要，请参考当前的 AWS IP 范围并允许提供的广泛范围。

对 Postman 安装进行故障排除

如果您在安装和运行 Postman 时遇到任何问题，请查看以下提示。如果这些没有帮助，请参阅社区论坛上的安装帖子，如果您的问题尚未涵盖，请创建一个新帖子。

更新失败错误

如果您在 Postman 中看到更新失败通知，您可以使用 DevTools 进行调查。

使用View > Developer > Show DevTools (Current View)打开 DevTools 。

一些已知错误如下：

• 错误信息： Cannot update while running on a read-only volume

  • 此错误表示该应用用户在安装 Postman 的目录中没有写入权限。要解决此问题，请将 Postman 移至用户具有写入权限的/Application目录，例如 Mac 的目录，以及homeLinux 的目录。

• 错误信息： Code signature at URL file:///... did not pass validation: code object is not signed at all

  • 此错误意味着有多个更新同时运行。在上一次更新完成之前打开应用程序时，可能会发生这种情况。要解决此问题，请退出并重新打开应用程序。

• 错误信息： EACCES: permission denied, open '/opt/Postman/Postman-1620288011421.tar.gz

  • 此错误表示该应用用户在安装 Postman 的目录中没有写入权限。要解决此问题，请将 Postman 移至用户具有写入权限的home目录，例如 Linux 的目录。

更新按钮不可用

如果您使用的是 Linux 版 Postman，并使用 Ubuntu 软件中心或 Snap Store 安装了该应用程序，您可能看不到检查更新按钮。这是因为更新由商店处理，它应该定期自动更新 Postman。

下一步

如果您在安装或更新时遇到问题，请联系Postman 支持。如果您的安装按预期工作，请发送您的第一个请求！