Bruno Cookie 持久化:重启不丢会话的 3 步配置法
Bruno Cookie 持久化:重启不丢会话的 3 步配置法【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno你大概遇到过这种情况:登录接口跑通了,顺手把 session cookie 记下来,结果一重启 Bruno,再发同一个请求就变成 401——会话又没了,得重新走一遍登录流程。Bruno 的 Cookie 持久化机制就是为了解决这个痛点:它把每条 cookie 加密后写进本地存储文件,应用重启时自动回填,请求发出去时仍带着有效的会话标识。读完整篇文章,你能掌握:Cookie 存储文件的结构与加密原理、三条命令级别的手动配置流程、多环境与 CLI 自动化下的用法,以及存储文件损坏时的排查路径。存储原理:Cookie 是怎么活过应用重启的Bruno 采用本地文件优先的设计哲学——集合、环境变量存在你的目录里,Cookie 同理,只是它多了一层加密。核心逻辑在 Cookie 存储实现 中:首次启动生成密钥:应用在你的用户数据目录下创建cookies.json,并生成一个 256 位随机 passkey,加密后以encryptedPasskey字段存回该文件。按域名分组落盘:每次请求产生或你手动添加 cookie 后,cookie 会按 domain 分组,value 字段用 passkey 加密后写入cookies字段。写入做了 5 秒防抖,避免高频请求时的磁盘 IO 抖动。启动时自动回填:再次启动时,存储模块解密密钥、逐条解密 cookie,重新装载进内存中的 cookie jar,后续请求自动带上,你不需要做任何操作。之所以选本地文件而不是云端同步,是因为会话数据天然属于机器状态——它跟着你的测试环境走,而不是跟着集合仓库走,这样密钥、token 之类的敏感值就不会被误提交进 Git。实操:三步完成手动 Cookie 持久化配置打开 Bruno 后,状态栏有一个 Cookie 入口(交互逻辑可参考 Cookie 持久化测试),以下是手动录入一条会话 cookie 的完整流程:第 1 步:打开 Cookie 管理面板点击状态栏的 Cookie 图标。如果没有存过任何 cookie,面板中央会显示一个 Add Cookie 按钮,直接点击即可。第 2 步:填写字段并保存字段作用填写要点keycookie 名称与服务端 Set-Cookie 头中的名称一致,如sessionvaluecookie 值从浏览器开发者工具或登录响应中复制domain归属域名与目标 API 域名一致,如example.compath生效路径一般填/,特殊路由再收窄secure仅 HTTPS 传输生产/预发环境勾选,本地 http 调试可不勾httpOnly禁止脚本读取与来源保持一致,通常勾选填完点 Save,cookie 会出现在列表中并加密落盘。第 3 步:重启验证完全退出应用再启动,重新打开 Cookie 面板,确认刚才的 domain 仍在列表里。这一步对应 持久化验收测试 的做法:同一用户数据目录下二次启动,cookie 必须可读回。日常维护也在这个面板里完成:单条删除、按域名一键清空(带二次确认)、关键词搜索,实现见 Cookie 管理组件。延伸场景:多环境与 CLI 自动化结合环境变量做多环境切换把 cookie 的 value 指向环境变量引用,不同环境(测试/预发/生产)各配一份变量,切换环境时会话 cookie 自动跟着变。环境变量持久化的写法可以参考 setEnvVar 持久化测试。纳入版本控制的团队工作流Cookie 值本身不入库,但该配哪些 cookie、domain/path 是什么这类结构信息可以写进集合文档,配合集合的版本管理让团队按同一套约定初始化会话:CLI 场景保持会话一致Bruno 的命令行工具可以在 CI 中跑集合,配合本地已持久化的 cookie 或环境文件,让自动化任务不必每次重新登录。CLI 的命令与 runner 源码在 bruno-cli/src 下:避坑:存储文件损坏怎么排查最常见的故障是cookies.json里的密钥损坏或文件被误改。Bruno 的设计是降级而非崩溃:passkey 解不开时,面板仍会列出所有 cookie 的 domain/path,只是 value 显示为空——你可以从浏览器重新复制值,用编辑功能回填,存储会重建加密。损坏密钥测试 正是模拟了把encryptedPasskey改成非法值后应用仍能正常展示列表的场景。遇到 cookie 丢失或读不回时,按这个顺序排查:确认文件存在且合法:检查用户数据目录下cookies.json是否为合法 JSON,cookies字段是否存在;确认写入权限:应用目录是否只读、磁盘是否写满,防抖期间退出应用也可能丢失最近 5 秒内的变更;检查密钥字段:encryptedPasskey若为空或乱码,删除该文件让应用重新生成密钥(会清空全部已存 cookie,先导出再操作);确认 domain 拼写:cookie 按域名匹配请求,域名差一个点都不会被携带。小结Cookie 按 domain 分组、value 加密后存入cookies.json,重启自动回填手动配置三要素:打开状态栏 Cookie 面板 → 填字段保存 → 重启验证多环境用环境变量绑定 cookie 值,团队约定写进集合文档密钥损坏不崩溃,面板降级展示,重填值即可恢复排查顺序:文件合法性 → 写权限 → 密钥字段 → domain 拼写想深入理解本地数据存储的整体设计,可以看看 中文文档;更多边界行为(防抖、加密失败回退)直接读 存储源码 会更清楚。你在实际项目里踩过哪些会话丢失的坑,欢迎在 Issue 区交流。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

LocalAI桌面客户端:用图形界面完成本地AI服务的一键部署与日常运维

LocalAI桌面客户端:用图形界面完成本地AI服务的一键部署与日常运维

LocalAI桌面客户端:用图形界面完成本地AI服务的一键部署与日常运维 【免费下载链接】LocalAI LocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required. 项目地址: https://gitcode.com/Gi…

2026/10/26 13:20:05 阅读更多 →
如何用FreeLLMAPI免费调用Claude Code和Codex CLI?零成本AI编程终极方案

如何用FreeLLMAPI免费调用Claude Code和Codex CLI?零成本AI编程终极方案

如何用FreeLLMAPI免费调用Claude Code和Codex CLI?零成本AI编程终极方案 【免费下载链接】freellmapi 7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint…

2026/10/31 14:23:36 阅读更多 →
LangGraph完整入门指南:三步构建长期运行的有状态智能体

LangGraph完整入门指南:三步构建长期运行的有状态智能体

LangGraph完整入门指南:三步构建长期运行的有状态智能体 【免费下载链接】langgraph Build resilient agents. 项目地址: https://gitcode.com/GitHub_Trending/la/langgraph LangGraph是一个面向有状态智能体的低层编排框架。它把复杂的多智能体工作流抽象为…

2026/11/3 0:50:55 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻