ubuntu中postman怎么配置

Ubuntu 中 Postman 配置全流程

一 安装方式

• Snap（推荐）

  • 安装与启动：

    sudo apt update
    sudo apt install snapd
    sudo snap install postman
    postman
    

  • 说明：Snap 会自动处理依赖与更新，适合大多数桌面环境。

• 官方压缩包（Tarball）

  • 下载与安装：

    wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
    sudo tar -xzf postman.tar.gz -C /opt/
    sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
    

  • 创建桌面快捷方式（/usr/share/applications/postman.desktop）：

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

    赋予可执行权限并刷新菜单：

    sudo chmod +x /usr/share/applications/postman.desktop
    update-desktop-database
    

  • 说明：解压到**/opt**便于集中管理与更新。

• Flatpak（可选）

  • 安装与运行：

    sudo apt update
    sudo apt install flatpak
    flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
    flatpak install flathub com.getpostman.Postman
    flatpak run com.getpostman.Postman
    

  • 说明：与系统其他部分隔离，适合偏好沙箱化的用户。

二 首次配置与环境变量

• 创建与管理环境
  • 在 Postman 右上角点击齿轮图标，选择Manage Environments → Add。
  • 新建环境（如：Development），添加变量（如：base_url、API_KEY），保存后在右上角环境下拉框中切换使用。
• 在请求中使用变量
  • URL：http://{{base_url}}/api/endpoint
  • Header：X-Api-Key: {{API_KEY}}
  • 脚本（Tests/Pre-request Script）：

    pm.test("Status is 200", () => pm.response.to.have.status(200));
    const apiKey = pm.environment.get("API_KEY");
    

• 代理配置（如公司网络需要）
  • 进入Settings → General → Proxy，填写HTTP/HTTPS 代理地址与端口；若需认证，启用Proxy authentication并填写用户名与密码。

三 自动化测试与 CI 集成

• Newman 运行集合
  • 安装 Newman：

    npm install -g newman
    

  • 运行示例：

    newman run collection.json --environment environment.json
    

• 生成报告并集成 GitHub Actions
  • 示例工作流片段：

    - name: Install Newman
      run: npm install -g newman
    - name: Run Postman tests
      run: newman run "your_postman_collection.json" --reporters cli,junit --reporter-junit-export report.xml
    - name: Publish test results
      uses: actions/upload-artifact@v2
      with:
        name: postman-test-results
        path: report.xml
    

  • 说明：将集合与环境导出为 JSON，在 CI 中执行并产出JUnit报告用于质量门禁。

四 常见问题与排障

• 启动器不显示或命令不可用
  • 确认符号链接：ls -l /usr/local/bin/postman 应指向 /opt/Postman/Postman。
  • 重新刷新桌面数据库：sudo update-desktop-database；或注销/重启会话。
• 代理无法连接
  • 在Settings → General → Proxy核对地址与端口；如使用NTLM或自签证书，优先在系统层面配置代理或导入证书后再试。
• 环境变量不生效
  • 确认右上角已选中正确的环境；在 URL/Header/脚本中使用双花括号引用变量（如：{{base_url}}）。
• 权限问题
  • 确保 /opt/Postman 与 /usr/local/bin/postman 具备合适权限；必要时使用 sudo 调整。