Postman 不登录越来越难用？开源 API 客户端 Bruno 新手实战教程：从安装到接口自动化
目录
哎，说到接口调试工具，你是不是也遇到过这种糟心事：Postman 不登录越来越难用了，接口集合传到别人云端，公司内网地址、测试 token 全跟着上去了，想离线用一下还得先连网。后来换 Insomnia，好家伙，8.0 版本也开始强制登录。
难道就没有一个开源、免费、数据留在本地的替代品？
还真有。今天给你介绍 Bruno——GitHub 上 4 万+ star 的开源 API 客户端，MIT 协议完全免费，最新版本 v4.3.0（2026 年 10 月发布）。这是一篇新手实战教程，跟着做，15 分钟从安装到跑通接口自动化测试。
一、Bruno 到底是什么？
一句话：存成本地文件的 Postman。
它和 Postman 的核心区别就一张表：
| 对比项 | Postman / Insomnia | Bruno |
|---|---|---|
| 集合存放位置 | 厂商云端，绑定账号 | 本地纯文本文件 |
| 离线使用 | 功能受限 | ✅ 完全离线 |
| 团队协作 | 付费席位同步 | Git 直接管 |
| 收费 | 核心功能要订阅 | ✅ 开源免费 |
说白了：你在 Bruno 里建的每个接口，就是一个 .bru 后缀的文本文件，躺在你自己的文件夹里。丢进 Git 仓库，全组人改了什么一目了然，代码评审时接口用例也能一起 review。
二、下载安装
方式一：网盘直接下（推荐新手）
夸克网盘下载：https://pan.quark.cn/s/8fd5379673bd
（目录里是 bruno_4.3.0_x64_win.exe，官方 GitHub Release 原版，未做任何修改）
方式二：GitHub 官方直连
https://github.com/usebruno/bruno/releases/download/v4.3.0/bruno_4.3.0_x64_win.exeWindows 用户双击安装即可。Mac 用户选 dmg，Linux 用户有 .deb / .rpm，全平台都覆盖。
装完打开，不需要注册账号，直接进主界面——这一点就比 Postman 强。
三、第一个接口请求（照着点就行）
第 1 步：新建集合（Collection）
点左侧栏的 + → Collection，名字随便起，比如 demo-api。关键一步：它会让你选一个本地文件夹来存放这个集合，建议单独建个目录，比如 D:\api-collections\demo-api。
第 2 步：新建请求
选中集合 → 点 + → Request，填两个东西：
- 请求名：
获取单篇文章 - URL：
https://jsonplaceholder.typicode.com/posts/1（这个是公开的测试接口，随便打）
第 3 步：点 Send！
右边秒回 JSON 数据：
{
"userId": 1,
"id": 1,
"title": "sunt aut facere repellat...",
"body": "quia et suscipit..."
}到这里，你已经会用 Bruno 发请求了。是不是和 Postman 长得差不多？迁移成本约等于零。
四、环境变量：一套用例跑遍 dev / prod
写死 URL 是新手最容易踩的坑。正确姿势：
第 1 步：点右上角 Environments 图标 → Create Environment，建两个：dev 和 prod。
第 2 步：在 dev 里加变量：
baseUrl = http://localhost:5000/api
token = test-token-123第 3 步：把请求 URL 改成：
{{baseUrl}}/posts/1Header 里加认证也一样：Authorization: Bearer {{token}}。
以后切换环境，点右上角下拉框换个 dev / prod 就行，用例一个字都不用改。
五、从 Postman 搬家（5 分钟）
老用户别慌，搬家很简单：
- Postman 里：左上角 Export → 选 Collection → 导出 zip
- Bruno 里：左上角 + → Import Collection → 选刚才的 zip
- 环境变量同理：Postman 导出 Environment 的 JSON，Bruno 右上角 Environments → Import
Bruno 还会自动翻译脚本：你在 Postman 里写的 pm.test()、pm.environment.get() 这些，导入时会自动转成 Bruno 的等价写法，大部分情况不用手动改。
Insomnia、OpenAPI（Swagger）也一样能导，接口都在，一条不落。
六、进阶：写断言 + 命令行跑自动化
Bruno 真正的杀手锏在这里——接口测试能进 CI。
1. 给请求加断言
打开请求 → 点 Assert 标签页，加两条：
res.status === 200
res.body.id === 12. 装命令行工具
# 进入你的集合文件夹
cd D:\api-collections\demo-api
# 全局安装 Bruno CLI
npm install -g @usebruno/cli3. 一条命令跑完所有用例
# 跑全部用例，指定环境
bru run --env dev
# 输出 JSON 报告（CI 用）
bru run --env dev --output report.json4. 接入 GitHub Actions（YAML 片段）
- name: API Tests
run: |
npm install -g @usebruno/cli
cd api-collections/demo-api
bru run --env prod --output report.json以后每次提交代码，CI 自动把接口全跑一遍，挂了直接红叉。这就是”接口自动化测试”最省事的落地方式，不用搭测试平台，一个 Git 仓库就够。
七、新手常见问题 FAQ
Q1：Bruno 需要登录吗？
完全不需要。没有账号体系，没有云同步，装完即用。
Q2：数据会上传到服务器吗？
不会。所有集合都是你磁盘上的本地文件，你可以随时用 cat 打开看，就是纯文本。
Q3：能用 GraphQL 吗？
能。新建请求时类型选 GraphQL，query、variables、header 都支持。
Q4：公司内网接口安全吗？
这正是 Bruno 的强项。接口地址和 token 不经过任何第三方云端，只有你自己的硬盘和 Git 仓库知道。
Q5：免费版有限制吗？
核心功能全免费（MIT 协议）。官方另有可选的企业版，但个人和小团队用开源版完全够。
写在最后
说实话，Postman 早年确实是神器，但一步步把用户往云上赶、往付费上推，老用户心里都憋着一股气。Bruno 这种”接口就是本地文件 + Git 协作”的思路，才是开发者真正想要的形态：工具是你的，数据也是你的。
从 Postman 迁移过去基本无痛，接口自动化这块反而更顺手。建议还没试过的同学，今天就装一个玩玩。
📥 软件下载：夸克网盘 https://pan.quark.cn/s/8fd5379673bd
（文件：Bruno/bruno_4.3.0_x64_win.exe，Windows x64 官方安装版）
关注公众号：「实用软技」，在公众号窗口里回复关键字「软件」即可免费获取
