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 秒自检
三步确认装好了:
- 启动 Bruno,窗口能正常打开并显示集合面板
- 终端执行
bru --version,能看到版本号说明 CLI 就位(只装了图形界面可跳过) - 新建一个请求,随便填个地址发出去,有响应即通过
进阶能力速览
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 runGit 协作
集合本身就是文件夹,git init加上.bru请求文件就能推远端,团队成员拉取即得同一套请求,改动走 diff 和 review。
踩坑速查
应用装完打不开→ 先确认系统版本满足上面前置条件,不满足则升级系统;满足则重装一次,仍不行查应用日志定位原因。
终端提示找不到
bru命令→ 多半是 Node.js 环境有问题,先node -v确认环境正常,再重装:npm uninstall -g @usebruno/cli npm install -g @usebruno/cliApt 源配置到一半报错→ 多行命令对新手门槛偏高,改用
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),仅供参考