2026.09.12
Vaultwarden：面向自托管的 Bitwarden 兼容服务端
Vaultwarden 是兼容官方 Bitwarden 客户端的非官方服务端实现。采用前应了解其功能范围、HTTPS 要求、容器部署方式、版本匹配，以及不提供 Bitwarden 官方支持这一边界。
项目用途
Vaultwarden 是一个以 Rust 编写的非官方 Bitwarden Client API 服务端实现，可与官方 Bitwarden 客户端配合使用。对于希望自行掌握服务部署、数据存储和升级安排的自托管用户，它提供了另一种服务端选择。仓库元数据标注的许可证为 AGPL-3.0。
采用前首先要厘清支持边界。项目明确表示，它不与 Bitwarden 或 Bitwarden, Inc. 关联；无论使用移动端、桌面端还是浏览器客户端，缺陷和建议都应提交给 Vaultwarden 的社区和项目渠道，而非 Bitwarden 官方支持渠道。需要厂商官方支持、既定服务流程或特定合规材料的团队，应将这一差异纳入评估。
已知功能
README 将 Vaultwarden 描述为对 Bitwarden Client API 的“几乎完整”实现。其列出的个人功能包括个人保险库、Send、附件、网站图标和个人 API 密钥。
组织功能清单包含集合、密码共享、成员角色、群组、事件日志、管理员密码重置、Directory Connector 和策略。认证部分列出身份验证器、电子邮件、FIDO2 WebAuthn、YubiKey 与 Duo 等多因素或双因素认证方式；此外还有紧急访问、Vaultwarden 管理后台，以及随容器提供的修改版 Web Vault 客户端。
这些是项目文档列出的能力范围，并不等同于所有客户端版本、认证方式和部署组合都已经过相同验证。将其用于实际环境前，应针对自身需要的登录、组织协作、附件和恢复流程逐项确认。
部署与限制
README 推荐使用项目发布到 ghcr.io、docker.io 和 quay.io 的容器镜像。项目也提到社区维护的软件包和自行构建的方式，但同时提醒：社区包可能落后于项目版本，或在配置方式上有所不同。采用此类包时，部署者需要确认维护来源、更新路径与配置差异。
Web Vault 需要 HTTPS，以及 Web Crypto API 所需的安全上下文；README 明确指出，未启用 HTTPS 时 Web Vault 无法工作。项目建议在部署中使用反向代理。容器示例还将数据目录挂载到宿主机以保存持久化数据，因此部署规划应覆盖数据存放位置、备份与恢复安排、域名配置及证书维护。
版本兼容同样不可忽略。1.37.2 的发布说明指出，为支持版本为 2026.8.0 及以上的客户端，需要更新到该版本。升级时应同时核对服务端发布版本和正在使用的客户端版本，并参考项目的 issue 与讨论记录，而不是只更新其中一端。所给来源没有提供最低硬件要求、性能指标、可用性承诺或安全性结论，本文不对此作推断。
适合谁
Vaultwarden 更适合愿意维护容器或自建服务，并能自行处理 HTTPS、反向代理、数据持久化、备份和升级安排的自托管用户。若使用者主要期待 Bitwarden 官方支持渠道，或不希望承担密码库服务的日常运维责任，则应谨慎评估这一选择。
上线前可先以非关键数据核对客户端登录、所需的组织功能、二次认证、附件访问和恢复步骤，并记录服务端与客户端版本、数据备份状态及恢复流程。这样做有助于在升级或排障时辨别配置、版本与客户端之间的关系。
资料来源
资料核对日期：2026-09-12