Ubuntu下Postman设置指南

Ubuntu 下 Postman 设置指南

一 安装方式

• Snap 安装（推荐）
  • 更新并安装 Snap：sudo apt update && sudo apt install snapd
  • 安装 Postman：sudo snap install postman（部分环境建议使用经典通道：sudo snap install postman --classic）
  • 启动：应用菜单搜索 Postman 或终端执行 postman
• 手动安装（通用）
  • 下载 Linux 包：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
  • 创建桌面启动器：sudo nano /usr/share/applications/postman.desktop，内容示例：
    • [Desktop Entry]
    • 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 && sudo update-desktop-database
  • 启动：应用菜单或终端执行 postman
• APT 仓库安装（可选）
  • 导入 GPG 并添加仓库：
    • wget -qO - https://dl.postman.co/postman.gpg | sudo apt-key add -
    • sudo sh -c ‘echo “deb https://dl.postman.co/debian $(lsb_release -cs) main” > /etc/apt/sources.list.d/postman.list’
  • 安装与启动：sudo apt update && sudo apt install postman；应用菜单或终端 postman
• Flatpak 安装（可选）
  • 安装 Flatpak 并添加 Flathub：sudo apt install flatpak；flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  • 安装与启动：flatpak install flathub com.postman.Postman；flatpak run com.postman.Postman

二 基础配置

• 代理设置
  • 打开 Postman → 右上角齿轮 → General → Proxy
  • 配置 HTTP/HTTPS 代理地址与端口；若需认证，勾选 Proxy authentication 并填写用户名与密码 → Save
• 登录与 API Key
  • 头像 → Settings → General → API Key，生成或粘贴密钥以启用同步与云服务
• 环境变量
  • 方式一（全局）：头像 → Settings → General → Environment Variables → Edit Environment Variables，添加键值对（如 base_url、API_KEY）
  • 方式二（环境）：顶部 Environment → Manage Environments → Add，创建如 Development/Staging/Production 环境；在请求中使用 {{变量名}} 引用，例如：http://{{base_url}}/api/endpoint
  • 支持导入/导出 JSON 环境文件，便于团队协作与迁移

三 常用操作

• 发送请求：新建请求 → 选择 GET/POST 等方法 → 填写 URL/Headers/Body → Send
• 集合与自动化
  • 通过 Import 导入集合/环境/示例；在 Tests 中编写脚本实现响应断言与自动化流程
  • 使用环境变量在不同环境间快速切换（如将域名、Token 抽离为变量）

四 常见问题与排查

• 命令行找不到 postman
  • 确认软链：ls -l /usr/local/bin/postman；若不存在，重建：sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
  • 检查 PATH：echo $PATH；必要时在 ~/.bashrc 或 ~/.zshrc 中添加：export PATH=$PATH:/usr/local/bin 并 source 使其生效
• 应用菜单不显示图标
  • 确认 .desktop 文件存在且可执行：ls -l /usr/share/applications/postman.desktop
  • 重新赋权并刷新：sudo chmod +x /usr/share/applications/postman.desktop && sudo update-desktop-database
• 企业网络无法请求外部 API
  • 在 Proxy 中正确配置公司代理；如使用 Snap 版本，注意其受限于沙箱，必要时改用 APT/Flatpak/手动安装 以获得更灵活的代理与网络权限