bruno

环境要求

• Mac、Windows 或 Linux 桌面系统（官网提供对应二进制安装包）
• 使用 CLI 时需要已安装 Node.js 与 npm
• 使用 Docker 方式运行 CLI 时需要已安装 Docker
• 能访问官网下载页或 npm / Docker Hub 的网络环境

安装与启动步骤

1. 1下载安装桌面端

   到官网下载页选择 Mac、Windows 或 Linux 安装包安装；也可通过 Homebrew、Chocolatey、Scoop、Snap、Flatpak、Apt 等包管理器安装，具体命令见官方文档。

2. 2安装 Bruno CLI

   需要命令行运行集合或做 CI/CD 自动化测试时，用 npm 全局安装官方 CLI 包。

   npm install -g @usebruno/cli

   复制

3. 3进入集合目录

   切换到存放 API 集合的目录，集合以 Bru 纯文本文件保存在该文件夹中。

   cd /your/path/to/collection

   复制

4. 4运行整个集合

   在集合目录下直接执行，会依次跑完集合中的每个请求。

   bru run

   复制

5. 5运行单个请求

   只想跑某一个请求时，把对应的 .bru 文件名传给 bru run。

   bru run request.bru

   复制

6. 6按环境运行文件夹

   对某个子文件夹指定运行环境，通过 --env 传入环境名。

   bru run folder --env Local

   复制

7. 7用 Docker 运行

   无需在宿主机安装 Node.js，挂载当前集合目录到容器 /bruno 后执行 run。

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

   复制

关键配置

如何确认成功

桌面端能正常打开 Bruno 界面并新建或打开集合；CLI 执行 bru run 后终端能输出请求执行结果。

常见问题

注意事项

• README 未给出 Homebrew、Chocolatey、Scoop、Snap、Flatpak、Apt 的具体安装命令，请以官网下载页和官方文档为准。
• Bru 集合为纯文本文件，建议将集合目录纳入 Git 管理，方便团队协作与版本追溯。
• Bruno 离线优先、不做云同步，请自行做好本地集合目录的备份。
• Docker 镜像同时发布在 Docker Hub（usebruno/cli）和 GitHub Container Registry（ghcr.io/usebruno/cli），提供 alpine 与 debian 变体，支持 linux/amd64 与 linux/arm64。