跳到主要内容

安装和更新 Postman

Postman 可在 Web 上访问，网址是 go.postman.co/home ，同时也提供了适用于 Mac（Intel 或 Apple Silicon）、Windows（Intel 32 位或 64 位）和 Linux（64 位）操作系统的本地桌面应用程序。

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

如果你需要获取早期版本的 Postman 桌面应用程序，请参考 安装早期版本的 Postman 。

在 Windows 上安装 Postman​

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

  1. 下载 最新的 Postman 版本。
  2. 选择并运行.exe文件以安装 Postman。

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

在 Mac 上安装 Postman​

Postman 适用于 macOS 10.11（El Capitan）及更高版本。

  1. 下载 最新的 Postman 版本。

如果你使用的是搭载 Apple silicon 处理器的 Mac，请确保下载Mac Apple Chip版本。

  1. 如果你的浏览器将文件下载为 zip 文件，请在Downloads文件夹中找到该文件并解压缩。
  2. 在Downloads文件夹中，双击Postman文件进行安装。
  3. 在提示时，将文件移动到你的Applications文件夹。这将确保以后的更新能够正确安装。

如果你使用第三方压缩应用程序解压缩并安装 Postman，可能会遇到“Library not loaded”错误。请使用 Mac 的默认 Archive Utility 解压缩文件。

你还可以使用 Homebrew 包管理器安装 Postman：

brew install --cask postman

在 Linux 上安装 Postman​

你可以通过手动下载、使用 Snap 商店链接或使用命令snap install postman在 Linux 上安装 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 support 以下 Linux 发行版：

  • Ubuntu 14.04 及更高版本
  • Fedora 24
  • Debian 8 及更高版本

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

建议你安装 Snap ，因为它包含了应用程序所需的所有库，并且这些库与应用程序一起捆绑安装。

避免使用sudo命令启动 Postman，因为这会导致 Postman 创建的文件权限问题。

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

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

使用 Postman Web 应用程序​

你可以在 Web 浏览器中使用 Postman 进行 API 开发和测试任务，并结合 Postman 代理使用。要访问 Postman Web 应用程序，请访问 go.postman.co/home 。

如果你使用 Postman Web 应用程序，Postman 建议使用 Postman Desktop Agent 以获得最佳体验。有关更多信息，请参阅 关于 Postman 代理 。

浏览器要求​

Postman Web 应用程序针对以下浏览器进行了优化：

  • Chrome（78 及更高版本）
  • Firefox（76 及更高版本）
  • Edge（79 及更高版本）
  • Safari（13.1.1 及更高版本）

安装 Postman 桌面代理​

如果你使用 Postman Web 应用程序，Postman 建议下载并安装 Postman 桌面代理 ，它是在你的桌面上本地运行的微型应用程序。桌面代理解

决了浏览器的跨域资源共享（CORS）限制，并充当你在 Postman Web 应用程序中进行 API 请求的代理。

Web 限制​

Postman Web 应用程序正在积极开发中。有一些功能只能在 Postman 桌面应用程序中访问，而无法在浏览器中访问：

  • 查找和替换 - Postman 桌面应用程序支持在工作空间中 查找和替换值 ，但在 Postman Web 应用程序中尚不可用。
  • 证书和代理 - Postman 桌面应用程序允许你自定义 证书 和 代理配置 。在 Postman Web 应用程序中，它们采用浏览器定义的值，并且无法被 Postman 覆盖。
  • Postman 拦截器 - 拦截器 将浏览器中的 Cookie 同步到 Postman 桌面应用程序，并直接从浏览器捕获网络请求。在 Postman Web 应用程序中无法使用拦截器。
  • 轻量级 Postman API 客户端 - 你可以在未登录 Postman 的情况下使用 轻量级 API 客户端 从 Postman 桌面应用程序发送请求。

更新 Postman​

当有主要更新可用时，Postman 桌面应用程序会向你发出通知。对于其他更新，设置图标上会有一个点 Settings icon。如果指示器是红色而不是橙色，表示更新失败。

Update Ready

选择更新选项以下载或安装最新的更新。如果你使用的是 Postman v9.13 或更高版本，Postman 会自动下载更新。当下载完成时，Postman 会通知你并提示你重新启动 Postman 以应用更新。

Check for updates

Postman Chrome 应用程序（已弃用）​

Postman Chrome 应用程序已经弃用。如果你使用 Chrome 应用程序，在 切换到使用 Postman 时，可以选择通过与你的 Postman 帐户同步或通过从 Chrome 导出并导入到 Postman 来保留你的数据。

Postman 桌面应用程序是基于 Electron 构建的，克服了 Chrome 平台的一些限制。

  • 本机应用程序允许你直接处理 cookies 。
  • 与 Chrome 应用程序不同， 拦截器 不需要

单独的扩展。

  • 本机应用程序配备了内置代理，你可以使用该代理来 捕获网络流量 。
  • 本机应用程序不受 Chrome 菜单栏的限制。你可以检查更新，创建 Postman 窗口和选项卡，以及编辑首选项。
  • 本机应用程序允许你发送像Origin和User-Agent这样的 header。在 Chrome 应用程序中受到限制。
  • 本机应用程序具有内置的"不跟随重定向"选项，以防止自动重定向返回 300 系列响应的请求。在 Chrome 应用程序中，这需要使用拦截器扩展程序。
  • 本机应用程序具有内置的 控制台 ，可以查看 API 调用的网络请求详细信息。

迁移到本机应用程序​

要从 Chrome 应用程序切换到本机应用程序， 下载 Postman 并 登录到你的帐户 。启动本机应用程序，你的历史记录和集合将自动同步。

或者，如果你不想登录到 Postman 帐户，你可以从 Chrome 应用程序中批量导出 Postman 数据，然后在新的本机应用程序中批量导入到设置 > 数据中。

Import Export Data

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

在防火墙后使用 Postman​

Postman 的基础设施运行在 Amazon 的 AWS 平台上。如果你在网络防火墙后操作，你需要允许以下域名以进行 Postman 的 WebSocket 连接：

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

默认情况下，WebSocket 连接使用与 HTTP（80）和 HTTPS（443）相同的端口。对于 Postman v10，请允许以下域名：

Postman Web 应用程序 - WebSocket 连接：

  • https://bifrost-web-v10.gw.postman.com
  • https://bifrost-web-public-v10.gw.postman.com
  • https://bifrost-web-v10.gw.postman.co

Postman 桌面应用程序 - WebSocket 连接：

  • https://bifrost-v10-global.gw.postman.com
  • https://bifrost-premium-v10-global.gw.postman.com

Postman 桌面应用程序 - HTTP 连接：

  • https://bifrost-https-v10.gw.postman.com
  • https://bifrost-premium-https-v10.gw.postman.com

Postman 没有固定的 IP 范围可提供。如果

需要，可以参考 当前的 AWS IP 范围 并允许提供的广泛范围。

解决 Postman 安装问题​

如果你在安装和运行 Postman 时遇到任何问题，请查看以下提示。如果这些方法不起作用，请参阅 社区论坛 上的安装帖子，如果你的问题尚未涉及，请创建一个新帖子。你也可以联系 Postman support 。

更新失败错误​

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

update-error-dialog

使用查看 > 开发人员 > 显示 DevTools（当前视图）打开 DevTools。

以下是一些已知错误：

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

    • 此错误表示应用程序用户在安装 Postman 的目录中没有写权限。要解决此问题，请将 Postman 移动到用户具有写权限的目录中，例如 Mac 上的/Application目录，Linux 上的home目录。

  • 错误消息 - 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 移动到用户具有写权限的目录中，例如 Linux 上的home目录。

更新不可用​

如果你使用的是 Linux 上的 Postman，并使用 Ubuntu Software Center 或 Snap Store 安装了应用程序，则可能没有检查更新选项。这是因为更新由商店处理，并定期自动更新 Postman。