bruno

把 API 测试当代码管理，用 Git 搞定协作与版本追踪

bruno 是一个开源的 API 探索与测试 IDE，定位为 Postman 和 Insomnia 的轻量级替代品。它专注于解决传统 API 工具在协作、版本管理和离线使用上的痛点。核心能力包括：支持 REST 和 GraphQL 接口的调试与测试，提供直观的请求编辑器和响应查看器；所有 API 集合以纯文本文件（Bru 格式）保存在本地，天然支持 Git 版本控制，便于团队通过代码评审进行协作；内置脚本环境支持自动化测试流程，可编写断言和动态变量；同时支持 OpenAPI 规范导入，方便从现有文档快速生成测试用例。项目采用 JavaScript 构建，界面响应迅速，离线优先，数据完全由用户掌控，无需登录云账号。

开源 freemium 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 47213

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类开发框架

开发团队usebruno

所属国家

官网地址https://www.usebruno.com

GitHubhttps://github.com/usebruno/bruno

定价模式freemium

价格说明开源免费，提供云协作付费版

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型api-client,api-testing,automation,developer-tools,git,graphql-client,http-client,javascript,openapi,openapi3,opensource,rest-api,testing,testing-tools

GitHub 星标★ 47213

30天Star增速

HF 下载量

上线时间2022-09-27 00:00:00

最近更新2026-09-26 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-12

浏览次数13

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

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

安装与启动步骤

1下载安装桌面端

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

需要命令行运行集合或做 CI/CD 自动化测试时，用 npm 全局安装官方 CLI 包。
```
npm install -g @usebruno/cli
```
3进入集合目录

切换到存放 API 集合的目录，集合以 Bru 纯文本文件保存在该文件夹中。
```
cd /your/path/to/collection
```
4运行整个集合

在集合目录下直接执行，会依次跑完集合中的每个请求。
```
bru run
```
5运行单个请求

只想跑某一个请求时，把对应的 .bru 文件名传给 bru run。
```
bru run request.bru
```
6按环境运行文件夹

对某个子文件夹指定运行环境，通过 --env 传入环境名。
```
bru run folder --env Local
```
7用 Docker 运行

无需在宿主机安装 Node.js，挂载当前集合目录到容器 /bruno 后执行 run。
```
docker pull usebruno/cli:latest
docker run -v $(pwd):/bruno usebruno/cli run
```

关键配置

配置项	必填	说明	示例
`--env`	否	CLI 运行时指定使用的环境名	`Local`
`/bruno`	否	Docker 容器内集合目录的挂载路径	`/bruno`

如何确认成功

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

常见问题

Q：Bruno 支持云端同步吗？

A：不支持。Bruno 是离线优先工具，官方明确表示没有加入云同步的计划，数据完全保存在你自己的设备上。

Q：如何与团队协作管理 API 集合？

A：集合以 Bru 纯文本文件存放在本地文件夹，可用 Git 或任意版本控制工具提交，通过代码评审协作。

Q：不想安装 Node.js，怎么跑 CLI？

A：使用官方 Docker 镜像 usebruno/cli，把集合目录挂载到容器 /bruno 后运行 run，宿主机无需 Node.js 与 npm。

Q：CLI 怎么指定环境？

A：运行命令时加 --env 参数，例如 bru run folder --env Local 即用 Local 环境运行该文件夹。

Q：支持哪些平台？

A：官网提供 Mac、Windows、Linux 的二进制下载，同时支持通过包管理器安装。

注意事项

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。

核心亮点

纯本地文件存储，API 集合可直接纳入 Git 做版本控制，告别云端同步和账号绑定
无需登录即可使用全部功能，数据隐私性强，离线环境下也能完整工作
请求和断言脚本支持 JavaScript 自动化，可灵活构建复杂测试流程

不足之处

生态和插件数量远少于 Postman，部分高级功能（如团队协作、云同步）需要自行搭建方案
文档和社区规模仍在成长中，遇到边缘问题可参考的教程和案例较少

适用场景

个人开发者或小团队希望用 Git 管理 API 测试集合，实现代码评审式协作
对数据隐私敏感，要求 API 工具完全离线运行、不经过第三方服务器的场景
需要从 OpenAPI 规范快速生成测试用例，并集成到 CI 流程中做自动化回归测试

替代项目

Postman、Insomnia、Hoppscotch

项目介绍

bruno 是开发框架领域的开源项目，由 usebruno 开发，2022 年首次发布。

在全站 13,148 个收录项目中，它的 GitHub 星标数（47,213）位列前 1%，在开发框架分类的 808 个项目里位列前 1%。

近 45 天，它的 GitHub 星标从 46,316 增加到 47,213，净增 897。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-26。开源免费，提供云协作付费版。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人开发者或小团队希望用Git管理API测试集合，实现代码评审式协作。同类可对比的替代方案包括 Postman、Insomnia、Hoppscotch。

上一篇：texar

下一篇：cc-safety-net