usebruno/bruno
开发工具本地优先的 API 客户端,把请求集合保存为纯文本文件,便于版本控制和 CI。
Bruno 是一个桌面端 API 客户端,用于探索和测试 HTTP 接口,定位为 Postman 与 Insomnia 的轻量替代品。它最关键的选择在存储方式:集合直接放在文件系统的一个文件夹里,采用名为 Bru 的纯文本标记格式保存请求,因此可以像源码一样通过 Git 或其他版本控制系统评审、分支和合并,而不必依赖厂商云端的同步工作区。
实际工作方式的变化
你不再从托管工作区导出集合,而是把集合文件夹和代码一起提交。评审者看到的是文本形式的请求差异,团队可以像管理源文件一样分支合并。项目声明 Bruno 仅在离线状态下工作,并且明确不会加入云同步,请求数据留在本机;共享依赖你自己的代码仓库或文件交换,而不是托管账号 README。
三种运行路径
桌面客户端是主要入口:可从官网下载 Mac、Windows、Linux 安装包,或通过 Homebrew、Chocolatey、Scoop、winget、Snap、Flatpak、AUR、Apt 安装 README 安装说明。需要注意,Apt 方式会添加第三方签名密钥和软件源,属于系统级改动,使用前应确认。
Bruno CLI 通过 npm 安装 @usebruno/cli,可以运行整个集合、单个请求,或针对指定环境运行某个文件夹,适合放进 CI/CD 做自动化接口检查 README。
官方 Docker 镜像封装的是 CLI,提供 amd64 和 arm64 两种架构下的 alpine 与 debian 变体,让流水线不必在宿主机上安装 Node.js 或 npm 就能运行集合 README。按用途选路径即可:编写和调试用桌面客户端,重复执行用 CLI 或容器。
需要了解的条件
- README 称免费开源版覆盖大部分功能,另提供付费版本;但具体哪些功能在付费档中并未在该文档里说明,如在意请查看定价页 README。
- Docker 镜像只包含 CLI,不包含桌面应用。
- 项目采用 MIT 许可,允许在该许可条款下修改和再分发 README。
- 仓库标签提到 GraphQL、OpenAPI、openapi3,但现有 README 没有说明这些集成的深度,应视为未经验证的范围。
2025 年一位 Hacker News 评论者表示自己偶尔用它做 GET/POST,认为它的功能已超过多数人的需要;2023 年的讨论则围绕开发者是否愿意为此类工具付费展开——这属于对该项目商业模式的讨论,而不是功能评价 HN 评论。
本文由 AI 根据项目 README 生成,更新于 2026年10月29日,以项目官方文档为准。