Bruno 把 API 集合放进 Git,而不是云端
客户禁止数据外发时,无账号、无云同步的 API 客户端能省掉安全团队的大量追问。
要点速览
- Bruno 把集合以纯文本文件(Bru)存放在文件夹中,可以像代码一样建分支、看 diff、评审和合并。
- Bruno 没有云同步,也没有账号,项目方明确表示永远不会加入云同步。
- 密钥保存在本地,推送到 Git 或导出之前,必须先从集合中移除。
在很多客户公司,安全团队对任何新工具提出的第一个问题都是:数据会去哪里?对 Bruno 来说,答案比通常短得多。Bruno 官网直接写明:没有云同步,没有账号,无需登录。
对前线部署工程师(FDE)而言,这一点比任何功能都重要。不需要开通账号,也没有厂商服务器保存集合,需要向安全团队解释的事项自然也少了。
和客户工程师一起做集成时,你逐步积累的 API 请求,会成为两个系统如何通信的记录。这份记录应该放在双方团队都能看到的地方。
集合是文件,而不是云端工作区
官方文档把 Bruno 描述为对 Git 友好、离线优先的 API 客户端。根据 GitHub 上的 README,Bruno 直接把集合存放在磁盘上的文件夹中,每个请求都用 Bru 这种纯文本标记语言编写。
既然是纯文本,这个文件夹就可以放在代码仓库里。Bruno 文档提到,可读的格式让开发者一眼就能看出集合改了什么。README 还说明,可以使用 Git 或其他任何版本控制系统。
这正是它与把集合存放在厂商服务器上的工具的核心区别。Bruno 自己的对比页面(也就是厂商视角)把 Postman 需要登录的云端存储模式,与 Bruno 的本地桌面应用模式放在一起对照:在后者中,根本不存在账号这个概念。
一位开发者在 DEV Community 上写道,他们在用 Git 管理一个庞大的 Postman 集合文件屡屡受挫后,转向了 Bruno。
示例:为集成项目新增一个接口
假设你正在把自己的系统接入客户的订单 API。项目仓库里有一个集成代码文件夹,旁边是一个 Bruno 集合文件夹,里面放着几个请求:获取 token、查询订单列表、创建测试订单。每个请求都是一个独立的 Bru 文件。
客户刚刚给订单列表接口加了一个状态过滤参数。你新建分支,在 Bruno 中修改请求并保存。Git 记录下的是一个文本文件里的一处小改动,正如 Bruno 官网所说:对 API 集合建分支、看 diff、评审、合并。
你发起 pull request。客户工程师阅读 diff,看到只新增了一行参数,对照自己的文档核实后批准。他们拉取 main 之后,新请求已经出现在自己电脑上的 Bruno 里。没有人需要用邮件发送导出文件,也不用邀请谁加入工作区。
真正的价值在于,API 变更和代码变更走同一个 pull request。评审者两者都能看到,三周后有人问起“这个请求是谁改的、为什么改”,Git 历史就能回答。
密钥最容易出问题
集合放进 Git,集合里的一切也都可能进入 Git。Bruno 文档说得很明确:无论通过版本控制分享还是通过导出分享,都必须先从集合中移除密钥。密钥保存在本机。
最干净的做法是把值和请求彻底分开:仓库里的请求文件只保存 token 或 API key 的变量名,真实的值留在每个人自己的电脑上。
如果确实需要把这些值存进文件,按 Git 的惯例,把文件放在仓库之外,或者写进 .gitignore。在第一次提交前就和客户团队约定好,每个人在自己的电脑上配置凭据。
还有一个具体习惯:每次推送前,对集合文件夹运行 git diff --staged,查找 Bearer、token 或 api_key 之类的字符串。如果看到的是真实值而不是变量名,提交前先删掉。这只需要几秒钟;而要从 Git 历史中清除一个 token,花的时间要多得多。
什么情况下不该选 Bruno?
项目的 README 明确表示,Bruno 只支持离线使用,永远不会有云同步。如果客户团队习惯了即时更新、无需懂 Git 的共享工作区,他们就得改变习惯。很少接触代码仓库的运维团队需要时间适应,这一点要提前排进计划。
README 还提到,大部分功能免费且开源,付费的商业版提供更多功能。在向客户承诺之前,先确认你需要的功能属于哪个版本。
先学什么,简历上怎么写
首先要学的不是 Bruno 的界面,而是围绕它的 Git 规范:集合文件夹放在仓库的哪个位置,API 变更的评审约定,以及如何让密钥远离提交的文件。如果你已经习惯通过 pull request 协作,这套流程大部分都会很熟悉。
写简历或回答 FDE 面试题时,不要只写“用过 Bruno”。要说明你把 API 集合放进了与客户团队共享的仓库,通过 pull request 评审变更,并让密钥远离 Git 历史。招聘方能从中同时看到集成能力和安全意识。
一个不向外发送任何数据的工具,需要回答客户安全团队的问题就更少。Bruno 押注的正是这一点,其余的则取决于你能把仓库维护得多干净。
这篇文章对你有帮助吗?
感谢你的反馈!