Bruno 开源 API 开发与测试客户端深度解析：基于 Bru 文件的本地存储、Git 协作与全平台安装指南-北京尧图网络

Bruno 开源 API 开发与测试客户端深度解析基于 Bru 文件的本地存储、Git 协作与全平台安装指南【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno本文围绕仓库中的波斯语 READMEdocs/readme/readme_fa.md展开全面讲解 Bruno 这一开源 API 客户端的核心设计理念——集合即文件系统上的文本文件包括其Bru 标记语言的存储格式、离线优先与数据隐私立场、基于Git 的团队协作模式以及 macOS / Windows / Linux 三平台的多种安装方式并结合仓库源码packages/bruno-lang等给出可验证的实现依据。1. Bruno 是什么重新定义 API 客户端Bruno 是一个开源的 API 客户端项目自我定位为 Postman 等同类工具的变革者仓库描述将其归为 Postman / Insomnia 的轻量级替代方案用于 API 的探索、开发与测试。它的与众不同之处并不在于能发请求而在于数据存储方式与协作模式从根本上与主流工具不同。与其把请求集合锁在云端数据库里Bruno 选择了一条完全相反的技术路线见 readme_fa.md 中برونو مجموعههای شما را مستقیماً در یک پوشه روی فایلسیستم شما ذخیره میکند一节你的 API 集合被直接保存在文件系统的一个文件夹中集合中的每个请求对应一个使用纯文本标记语言Bru编写的文件。这一设计带来两个立竿见影的效果集合就是你手边的普通文件可以用任意编辑器查看、diff、批量替换版本控制天然可用因为集合是文本文件git diff、git log、分支与合并都能精确到请求级别这为下文第 3 节的Git 协作奠定了基础。仓库的根目录 readme.md 与波斯语翻译版在这一点上的描述完全一致可见这是整个项目最核心的架构决策。1.1 项目仓库全景当前仓库是一个monorepo以packages/目录组织多个子包从仓库目录结构可以看到与本主题直接相关的核心模块目录职责结合源码结构推断packages/bruno-app基于 React 的桌面端 UI包含src/components、src/pages、src/providers等大量源码packages/bruno-electronElectron 桌面外壳与 IPC / 文件系统服务src/ipc、src/services、src/storepackages/bruno-langBru 语言的解析器与序列化工具负责.bru文件与内部 JSON 模型的互转packages/bruno-cli命令行运行器用于在无 GUI 环境下执行集合packages/bruno-common跨端共享的类型定义与工具其中packages/bruno-lang正是集合即文本这一核心设计的地基我们在下一节结合它的源码与测试样例深入展开。上图来自仓库 assets/images 目录是 Bruno 主界面在仓库 README如 readme_fa.md 中[![bruno](https://raw.gitcode.com/GitHub_Trending/br/bruno/raw/5f6b0a5f7250b1f08b5afa8e81a521e81ef526a5/assets/images/landing-2.png?utm_sourcegitcode_repo_files)](https://link.gitcode.com/i/d3ac147c57548796df28474f59d04a3f)中使用的产品截图用于展示其完整的请求编辑与响应查看工作区。2. Bru 标记语言集合的文本存储格式2.1 Bru 是什么Bru 是 Bruno 自研的一种纯文本标记语言用于把一次 API 请求的全部信息方法、URL、请求头、Query 参数、请求体、脚本、断言等记录为可读、可 diff 的文本。这意味着集合无需专用数据库一个普通文件夹若干.bru文件就是一个完整集合。仓库中提供了一个非常直观的示例文件 packages/bruno-lang/example/request.bru其内容展示了经典 Bruv1书写风格type http-request name Send Bulk SMS method GET url https://api.textlocal.in/bulk_json?apiKeysecretnumbers919988776655messagehellosender600010 body-mode json seq 1 params 1 apiKey secret 1 numbers 998877665 1 message hello /params headers 1 content-type application/json 1 accept-language en-US,en;q0.9,hi;q0.8 0 transaction-id {{transactionId}} /headers body(typejson) { apikey: secret, numbers: 91998877665, data: { sender: TXTLCL, messages: [{ numbers: 91998877665, message: Hello World }] } } /body在这个示例中可以看到几个值得注意的要点元信息区以type http-request标识这是一个 HTTP 请求文档键值对区params / headers通过params ... /params、headers ... /headers这样的成对标签包裹列表行内行的语义在headers与params中每行形如标志位键值其中标志位1表示启用、0表示禁用例如示例中0 transaction-id {{transactionId}}表示该头当前被禁用同时{{transactionId}}展示了 Bruno 的模板插值变量引用语法带类型的 body 区body(typejson)之后紧跟原始 JSON 内容用/body结束支持同一请求文件里并列多种 body 类型示例中同时给出了 json 与 graphql 两种 body脚本区script ... /script中可编写onRequest、onResponse等钩子函数示例中onResponse内通过expect(response.status).to.equal(200)对响应状态码做了断言这直接对应 Bruno 的脚本与测试能力。2.2 Bru 语法解析的源码实现从源码结构看Bruno 在 packages/bruno-lang 中维护了两代 Bru 解析实现v1 解析器位于 packages/bruno-lang/v1/src目录下文件如params-tag.js、headers-tag.js、body-tag.js、script-tag.js、env-vars-tag.js、key-val-lines.js等与上面 2.1 节的标签结构一一对应——params/headers这类键值对区块由key-val-lines.js配合各 tag 文件处理body、script则有独立解析单元验证了 Bru 是按标签分块的文本语法v2 解析器位于 packages/bruno-lang/v2/src提供bruToJson.js、jsonToBru.js、jsonToCollectionBru.js、envToJson.js、dotenvToJson.js等转换模块说明 Bru 文件与内部 JSON 模型之间存在双向转换管线测试样例packages/bruno-lang/v2/tests/fixtures/request.bru 展示了新一代 Bru 的YAML 风格块语法使用meta { ... }、get { url: ... }、params:query { ... }、auth:oauth2 { ... }、body:json { ... }、assert { ... }等花括号块代替 v1 的标签/标签配对并用~前缀表示禁用某一行collection.bru 则展示了集合级的meta { type: collection }、继承给请求的headers、auth、vars:pre-request、script:post-response等默认配置如何落盘为文本。// 来自 packages/bruno-lang/v2/tests/fixtures/request.bru 的 v2 风格摘录 meta { name: Send Bulk SMS type: http seq: 1 } get { url: https://api.textlocal.in/send/:id body: json auth: bearer } params:path { id: 123 } auth:oauth2 { grant_type: authorization_code authorization_url: http://localhost:8080/api/auth/oauth2/authorization_code/authorize access_token_url: http://localhost:8080/api/auth/oauth2/authorization_code/token client_id: client_id_1 client_secret: client_secret_1 pkce: false auto_fetch_token: true }由上述两代语法样本与对应的解析器/测试文件可以看出无论 Bru 语言如何演进把请求以可读文本落盘到普通文件夹的架构始终未变——这正是一切 Git 协作与离线能力的根基。3. 离线优先为什么 Bruno 永不强制云端在 readme_fa.md 的说明中有一句非常关键的产品立场声明Bruno 只以离线offline方式工作未来也不计划加入任何云端同步功能。团队珍视用户的数据隐私认为你的集合数据应当留在你自己的设备上。这条原则与第 2 节集合以文本文件存放在本地文件系统的架构互为因果没有云端数据库就不存在数据上云的隐私与合规顾虑团队如果想跨机器共享集合不依赖厂商的同步服务而是自己掌控载体——通常是Git 仓库详见第 4 节敏感信息如示例中的 token、密码始终位于团队自己的版本库与设备中。也就是说本地优先 Git 协作不是妥协而是 Bruno 针对 API 集合协作问题给出的明确架构答案这也直接决定了它的使用方式与 Postman 等需要登录并同步到云端的工具截然不同。4. 借助 Git 进行团队协作既然集合是文件系统中的一个普通文件夹那么协作方式就顺理成章使用 Git或任何你偏好的版本控制系统。将集合目录纳入 Git 仓库后团队可以享受到文本文件协作的全部红利代码评审式的集合审查对某个请求的修改可以像改代码一样发起 Pull Request / Merge Request逐行审阅 Bru 文件的改动精确的变更历史git log能追踪到谁在何时改动了哪个请求头、哪个 URL无冲突的并行开发不同成员各改各的.bru文件冲突合并比二进制或云端存储简单得多与现有研发流程无缝集成集合跟着代码仓库走分支、标签、回滚、CI 触发都复用同一套基建。仓库目录中 packages/bruno-appIDE 前端与 packages/bruno-electron桌面外壳及其src/ipc、src/store等文件系统相关模块中包含了集合的装载、监控与写入逻辑可以印证集合在本地文件系统上实时读写这条链路是 Bruno 运行时的核心路径。上图来自仓库 assets/images 目录用于说明集合作为文件夹/文本文件被 Git 跟踪、评审与版本管理的协作方式。5. 跨平台支持readme_fa.md 中单独用一节强调 Bruno在多个平台上运行روی پلتفرمهای مختلف کار میکند。从仓库结构看Bruno 的核心逻辑分为共享的packages/bruno-appUI与packages/bruno-electron桌面运行外壳这种架构天然支持各桌面平台共用同一套代码而命令行的执行能力则沉淀在packages/bruno-cli可运行在服务器与 CI 环境进一步拓宽了跨平台的边界。作为开发者你可以按需选用在桌面端进行交互式探索与调试在命令行或 CI 中执行同一套基于 Bru 文件的集合做回归测试——两端的输入输出模型一致因为它们消费的是同一套文本集合。上图同样出自 assets/images 目录的 README 配图示意 Bruno 客户端可运行于多类桌面操作系统。6. 安装指南macOS / Windows / Linux6.1 二进制安装包官方为macOS、Windows 与 Linux提供了现成的二进制安装包可从官网下载页面直接获取对应平台的安装文件在 readme_fa.md 中被列为最直接的安装途径。6.2 通过包管理器安装除二进制包外官方还支持多种主流包管理器。原文给出了四条最常用的命令下面逐一展开并补充说明# macOS —— 通过 Homebrew brew install bruno # Windows —— 通过 Chocolatey choco install bruno # Linux —— 通过 Snap snap install bruno在 Linux 上Snap 安装通常需要系统已启用 snapd 服务若你的发行版未预装 snapd需先安装并启用它再执行上述命令。仓库英文主 READMEreadme.md中还额外列出了 Windows 的Scoop / winget、Linux 的Flatpak、Arch Linux 的AUR等途径如scoop install bruno、winget install Bruno.Bruno、flatpak install com.usebruno.Bruno、yay -S bruno需要更多发行版覆盖时可一并参考。6.3 Linux 下通过 AptDebian / Ubuntu安装针对 Debian / Ubuntu 系发行版官方推荐通过 Apt 安装完整步骤如下自 readme_fa.md 原样继承# 1. 创建 keyring 目录 sudo mkdir -p /etc/apt/keyrings # 2. 更新软件源并安装 gpg 与 curl sudo apt update sudo apt install gpg curl # 3. 导入官方 GPG 公钥并写入 keyring curl -fsSL https://keyserver.ubuntu.com/pks/lookup?opgetsearch0x9FA6017ECABE0266 \ | gpg --dearmor \ | sudo tee /etc/apt/keyrings/bruno.gpg /dev/null # 4. 为 keyring 设置读取权限 sudo chmod 644 /etc/apt/keyrings/bruno.gpg # 5. 写入官方 Apt 软件源amd64 echo deb [archamd64 signed-by/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable \ | sudo tee /etc/apt/sources.list.d/bruno.list # 6. 更新软件源并安装 bruno sudo apt update sudo apt install bruno对以上步骤做几点实操补充步骤 3 中0x9FA6017ECABE0266是软件源签名所用的 GPG 公钥指纹安装前请确认该指纹可信步骤 5 的signed-by指向步骤 3 生成的 keyring 文件若自定义过 keyring 路径需保持一致若 CPU 架构非 amd64需确认官方源是否提供对应架构的arch条目后再修改源配置安装完成后即可从应用菜单启动 Bruno或通过终端命令直接唤起。7. 入门之后的进阶资源readme_fa.md 在正文后整理了一组重要入口此处按其在仓库内的对应关系整理为便于索引的清单官方文档与使用手册覆盖 Bru 语法、脚本 API、环境变量等完整说明建议作为日常查阅的一手资料长期愿景讨论与路线图了解离线优先、无云同步等决策背后的完整论证上述产品立场即源于此发布 / 价格与下载页关注免费与付费功能边界以及各平台最新版本使用案例与经验分享仓库鼓励用户在讨论区分享 Bruno 帮助到实际工作的场景可作为评估与选型的参考。若你希望在新的包管理器中分发 Bruno如把.bru生态接入某发行版仓库或自建源请参考仓库根目录的 publishing.md其中说明了发布到新包管理器的流程与约定英文主 readme.md 的对应章节也提供了同样指引。8. 参与贡献与品牌许可8.1 如何贡献项目欢迎一切形式的贡献。如果你希望从代码层面改进 Bruno请先阅读仓库根目录的 contributing.md 及其多语言版本本项目对应的波斯语版位于 docs/contributing/contributing_fa.md。即使你不写代码也可以通过报告 Bug、提交 Feature Request的方式帮助项目——凡是能解决真实使用场景的反馈都同样有价值。对波斯语使用者上述贡献指南的波斯语译本已随仓库分发降低了本地化贡献的门槛。8.2 品牌与开源许可商标TrademarkBruno是由 Anoop M D 持有的注册商标Logo源自 [OpenMoji] 项目采用 CC BY-SA 4.0 许可代码许可仓库整体以MIT 许可开源详见仓库根目录的 license.md。从许可组合可以看出项目代码对社区高度开放MIT同时通过商标条款保护Bruno这一名称不被滥用属于典型的开放代码受控品牌治理模式。9. 小结从文档到代码的关键结论回到 docs/readme/readme_fa.md 这份波斯语 README全文的技术主线可以浓缩为四句话Bruno 是开源的 API 探索与测试 IDE目标是为 Postman 等工具提供不一样的替代方案集合文件系统文件夹中的.bru纯文本文件这一架构由 packages/bruno-lang 中的两代解析器v1/src 与 v2/src及配套测试夹具如 request.bru、collection.bru实证支撑离线优先、不搞云同步数据隐私与本地所有权是产品的一等公民Git 是推荐的协作方式配合多平台支持与 Homebrew / Chocolatey / Snap / Apt 等安装通道个人与团队都可以低成本上手。对于想深入知其所以然的读者建议顺着packages/bruno-lang的解析器与测试、packages/bruno-app与packages/bruno-electron的 UI 与文件读写链路继续阅读源码你会对文本即集合这套设计有更具体的体感。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Bruno 开源 API 开发与测试客户端深度解析：基于 Bru 文件的本地存储、Git 协作与全平台安装指南

相关推荐

LightGBM实战：基于LOL对局数据的胜负预测与可解释建模

Qwen Code 跑起来：终端里的 AI 代码助手十分钟上手

Storybook 多框架 Props 声明实战：一个 interface 如何驱动整个 Controls 面板

更多资讯

昇腾CANN/GE编译图摘要类简介

Joplin E2EE 同步快照解析：一个加密 Resource 同步项的字段、密文格式与测试用途

PyTorch 动态形状（Dynamic Shapes）核心概念详解：SymInt、Guards 与编译期符号推理

2026年经销商管理系统(DMS)选型指南与AI应用实践

海面石油泄漏检测数据集：VOC+YOLO双格式小目标实战指南

RSS-to-Telegram-Bot安全配置指南：保护你的数据和隐私

今日更新

CopilotKit Vue Demo 与 React Demo 的 Parity 实现指南：路由、运行时端点与交互语义的全框架对齐

Harbor RBAC 实战：db_auth 模式下非管理员用户管理项目成员的完整验证与权限模型解析

STM32平衡车纯平衡程序从拆包到参数整定的完整调试指南

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？