Bruno 安装指南:Windows、macOS、Linux 三平台各一条命令
2026/9/11 17:32:28 网站建设 项目流程

Bruno 安装指南:Windows、macOS、Linux 三平台各一条命令

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno

Bruno 是一款开源 API 客户端,可理解为轻量版的 Postman / Insomnia。和它们的本质区别在于:你的集合直接以纯文本(.bru 文件)形式存放在电脑的一个文件夹里,全程离线运行,官方明确不会做云同步。没有账号、没有上传,想和团队共享请求,Git 就是答案。

装之前看一眼前置条件

  • 系统:Windows 10 及以上、macOS 10.15 及以上,或 Ubuntu 18.04+ / Debian 10+ 的 Linux
  • 图形界面:无额外依赖,装完即用
  • 若还要用命令行工具bru:本机需已安装 Node.js 和 npm
  • 磁盘占用不大,属于轻量级桌面应用

Windows 安装

推荐:Chocolatey 一行装好

choco install bruno

备选:Scoop 与 Winget

winget install Bruno.Bruno

用 Scoop 的话先加 extras 桶,再执行scoop install bruno即可。

兜底:官网下安装包

三个包管理器都不顺手时,去 Bruno 官网下载 Windows 二进制安装包手动安装。

macOS 安装

推荐:Homebrew 一条命令

brew install bruno

备选:DMG 拖进 Applications

官网下载 macOS 版 DMG,双击打开后把 Bruno 拖入"应用程序"文件夹,和装普通 Mac 软件没区别。

Linux 安装

推荐:Snap 一行装好

snap install bruno

备选:Flatpak

flatpak install com.usebruno.Bruno

备选:Apt 官方源(Ubuntu / Debian)

sudo mkdir -p /etc/apt/keyrings sudo apt update && sudo apt install gpg curl curl -fsSL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x9FA6017ECABE0266" \ | gpg --dearmor \ | sudo tee /etc/apt/keyrings/bruno.gpg > /dev/null sudo chmod 644 /etc/apt/keyrings/bruno.gpg echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable" \ | sudo tee /etc/apt/sources.list.d/bruno.list sudo apt update && sudo apt install bruno

步骤偏多,嫌麻烦直接用上面的 Snap。

装完 30 秒自检

三步确认装好了:

  1. 启动 Bruno,窗口能正常打开并显示集合面板
  2. 终端执行bru --version,能看到版本号说明 CLI 就位(只装了图形界面可跳过)
  3. 新建一个请求,随便填个地址发出去,有响应即通过

进阶能力速览

bru CLI 把集合接进 CI/CD

npm install -g @usebruno/cli bru run bru run request.bru bru run folder --env Local

整个集合、单个请求、指定环境跑某个文件夹,三条命令覆盖日常场景。CLI 源码见 packages/bruno-cli/。

Docker 跑 CLI

CI 机器不想装 Node.js 时,直接拉官方镜像,挂载集合目录即可运行:

docker run -v $(pwd):/bruno usebruno/cli run

Git 协作

集合本身就是文件夹,git init加上.bru请求文件就能推远端,团队成员拉取即得同一套请求,改动走 diff 和 review。

踩坑速查

  • 应用装完打不开→ 先确认系统版本满足上面前置条件,不满足则升级系统;满足则重装一次,仍不行查应用日志定位原因。

  • 终端提示找不到bru命令→ 多半是 Node.js 环境有问题,先node -v确认环境正常,再重装:

    npm uninstall -g @usebruno/cli npm install -g @usebruno/cli
  • Apt 源配置到一半报错→ 多行命令对新手门槛偏高,改用snap install bruno绕开,效果一样。

集合就在本地文件夹、纯文本可 diff、离线不传数据——Bruno 的安装成本只有上面那几条命令,装完直接开工。

官方文档:docs/readme/readme_cn.md | 贡献指南:contributing.md

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询