Vaultwarden 1.36.0 与 Bitwarden 浏览器插件 2026.7.0 存在兼容性问题

最近，自建的 Vaultwarden 发现了一个诡异的问题：把 Bitwarden 浏览器插件升级到 2026.7.0 之后，打开扩展时密码库一直转圈加载，最后直接一片空白，无法查看、搜索或自动填充任何密码。经过排查，这不是你网络抽风，也不是数据库损坏，而是 Vaultwarden 1.36.0 与新版浏览器扩展之间的兼容性问题。

这篇小记就带你理清原因，并给出两种可靠、可操作的解决方案。

发生了什么？

简单来说，Bitwarden 官方在 2026.7.0 版本的浏览器扩展中，对客户端与服务端之间的通信协议进行了较大调整（例如修改了部分 API 端点、启用了新的认证交互流程）。由于 Vaultwarden 是一个社区维护的非官方实现，其 1.36.0 版本发布时并未包含这些新协议的支持代码。于是，当新版扩展向 Vaultwarden 1.36.0 请求数据时，服务端无法正确响应，导致密码库渲染失败——直观表现就是“白屏”或“无限加载”。

好消息是，这个问题已经在 Vaultwarden 1.37.0 中彻底修复；同时，我们也可以暂时把插件回滚到兼容旧版协议的最后一个稳定版本，来让 1.36.0 继续正常工作。下面详细说说两种方案。

方案一（推荐）：将 Vaultwarden 升级到 1.37.0

这是治本的方法。Vaultwarden 1.37.0 已经完整适配了新版扩展的协议，升级后你就可以放心使用 Bitwarden 最新插件，享受新功能和安全性补丁。

操作步骤（以 Docker 部署为例）

1. 修改镜像标签并拉取新版本：
   如果你用的是 docker-compose，将 image: vaultwarden/server:1.36.0 改为 image: vaultwarden/server:1.37.0（或直接使用 latest），然后执行：

   bash

   docker-compose pull
   docker-compose up -d

   如果直接使用 docker run，则先移除旧容器，再用新镜像重新创建：

   bash

   docker rm -f vaultwarden
   docker run -d --name vaultwarden ... vaultwarden/server:1.37.0

2. 验证：打开 Bitwarden 浏览器插件，确认密码库正常加载。至此完成。

其他部署方式（如直接二进制、Kubernetes）同理，更新至 1.37.0 即可。

方案二：将 Bitwarden 浏览器插件回退至 2.26.6.1

如果你暂时不方便升级 Vaultwarden，比如担心升级引入其它变动，或者环境复杂一时无法操作，可以先让浏览器扩展“降级”到一个与服务端兼容的旧版本。2.26.6.1 是经典旧版本中最后一个使用传统通信方式且功能完备的版本，在 Vaultwarden 1.36.0 上可以完美运行。

如何安装旧版本并阻止自动更新

由于各大浏览器扩展商店只提供最新版，我们需要手动安装旧版 .crx 或加载解压后的扩展文件。

1. 下载旧版扩展包
Bitwarden 官方 GitHub Releases 页面保留了历史版本：
前往 Releases · bitwarden/clients，在 Assets 中找到对应浏览器的文件：

• Chrome / Edge：下载 dist-chrome-2.26.6.1.zip

• Firefox：下载 dist-firefox-2.26.6.1.zip

2. 安装（以 Chrome/Edge 为例）

• 解压下载的 zip 文件，得到一个文件夹。

• 打开浏览器扩展管理页面（chrome://extensions 或 edge://extensions）。

• 开启右上角的 “开发者模式”。

• 点击 “加载已解压的扩展程序”，选择刚刚解压出来的文件夹。

• 旧版 Bitwarden 图标应该会出现在工具栏。

3. 关闭自动更新（关键！）

• 对于 Chrome/Edge：以开发者模式加载的扩展通常不会被商店自动更新，但为了保险，可以记下扩展 ID，必要时通过策略禁止更新。如果是通过 .crx 安装，可以先解压再加载，避免自动升级。

• 对于 Firefox：Firefox 对扩展签名要求严格，安装未签名的旧版比较复杂。更简单的方法是在 Firefox 中暂时换用“加载临时扩展”，或直接在另一款浏览器（如 Chrome/Edge）中使用 2.26.6.1，直到服务端完成升级。

4. 验证
打开浏览器插件的登录页面，输入你的 Vaultwarden 地址和账号信息，密码库应能正常显示。

⚠️ 注意：使用旧版扩展意味着你无法获得后续的 Bug 修复和新特性，也存在一定的安全风险。建议只作为临时过渡方案，并在完成服务端升级后尽快恢复到官方最新版。

小结

• 问题根源：Vaultwarden 1.36.0 未适配 Bitwarden 浏览器插件 2026.7.0 引入的新 API，导致密码库无法渲染。

• 根治方案：将 Vaultwarden 升级到 1.37.0。

• 临时方案：将浏览器插件回退到 2.26.6.1，并阻止其自动更新。

个人强烈推荐直接升级服务端，操作简单且一劳永逸。