Vaultwarden 是使用 Rust 编写的 Bitwarden 兼容密码库服务端,可以配合官方浏览器扩展、桌面、移动端和 CLI 客户端,把服务端部署在自己的 NAS、服务器或 VPS 上。它由独立社区维护,与 Bitwarden, Inc. 没有隶属关系;服务端问题应交给 Vaultwarden 社区处理。

它适合明确需要掌握数据位置、且能长期维护实例的个人、家庭和小团队。项目采用 AGPL-3.0 许可,推荐容器部署。部署前先想清楚服务器故障后怎样恢复密码库。数据放在自己机器上,意味着可用性、更新和恢复也需要自己负责。
沿用客户端后,能怎样管理密码
已有 Bitwarden 使用习惯的人,主要需要在客户端设置自托管服务器地址。个人保险库、附件和 Send 等能力让条目与资料可以跨设备使用;家庭或团队共享则通过组织、集合、成员角色和群组划分范围,不必把所有账号都放进一个共同账户。
项目还提供验证器、邮件、FIDO2 WebAuthn、YubiKey、Duo 等二次验证方式,以及紧急访问。应先为自己选定的方式准备恢复路径,再考虑扩大到其他成员。兼容实现可能与官方服务存在版本差异,服务端与客户端升级时要一起关注;要求厂商 SLA、正式支持或合规证明的组织,需要另行评估支持责任。
Docker 配置中,域名与数据目录最先确定
以下 Compose 起步示例以同一宿主机上配置 HTTPS 反向代理为前提。先把域名改成自己的实际地址,创建可靠的数据目录;当前示例使用 latest 便于展示,长期实例可按 Release 选择并固定镜像标签。
services:
vaultwarden:
image: vaultwarden/server:latest
restart: unless-stopped
environment:
DOMAIN: "https://vault.example.com"
volumes:
- ./vw-data:/data
ports:
- "127.0.0.1:8000:80"
保存为 compose.yaml 后,在同一目录运行 docker compose up -d。其中 DOMAIN 只是声明访问地址,不会替你申请证书或启用 HTTPS;反向代理要把实际域名转发到本机的 8000 端口。若代理位于另一台机器或独立容器网络,需按自己的网络拓扑调整连接方式。
/data是容器的持久化位置。将它映射到宿主机目录,容器重建后才能继续使用已有数据库、附件与配置;数据目录应限制权限。- Web Vault 依赖 Web Crypto API 的安全上下文。正式域名访问必须开启 HTTPS,若只配通 HTTP 访问,即使网页能打开也无法完成密码库的加密验证。
- 按使用范围限制新用户注册,并保护管理入口。仓库
.env.template列出SIGNUPS_ALLOWED和ADMIN_TOKEN等配置项;正式部署时切忌沿用示例令牌字符,须生成高强度随机密钥。
可通过 GHCR、Docker Hub 或 Quay.io 获取项目提供的镜像。第三方 NAS 打包的路径和更新节奏可能不同,采用时先确认数据存在哪里,再制定恢复方案。
备份要能恢复条目,也要能恢复附件
默认 SQLite 部署把重要数据放在数据目录,但数据库与附件是不同文件。下面按恢复用途列出常见对象,采用外部 PostgreSQL 或 MySQL 时,还要另外备份对应数据库。
| 对象 | 恢复时的作用 |
|---|---|
db.sqlite3 | 密码条目及用户、组织等数据库状态 |
attachments/ | 条目附带文件;只备份数据库不会带上这些文件 |
config.json、部署配置和 rsa_key* | 实例设置与签名密钥;配置及私钥可能含敏感信息,应保护备份 |
sends/ | 若需要恢复现有文件 Send,一并纳入;网站图标缓存则通常可重新获取 |
拷贝运行中的 SQLite 数据库切忌只拉取单一数据文件:Wiki 建议使用 SQLite 在线备份命令,若停机复制也须连带打包同目录下的 WAL 日志文件。Wiki 推荐 SQLite 的在线备份方式;停机复制时还要处理可能存在的 WAL 文件。无论选择哪种方法,都应按对应恢复流程验证一致性,备份保留版本并存一份到其他设备。
导入真实密码之前,走一次恢复流程
- 在测试实例创建少量可丢弃条目,确认网页与常用客户端可以登录、同步,且所选二次验证方式可用。
- 按实际数据目录和数据库类型生成备份,同时纳入测试附件及必要配置。
- 在隔离环境恢复这份备份,确认条目内容、附件和客户端连接都正常;保留原测试数据,避免恢复失败后没有对照。
- 确认恢复路径可重复执行,再逐步迁移真实密码,并建立证书、磁盘、备份结果与安全更新的维护安排。
升级前读目标版本说明,先备份,再更新镜像。若升级包含数据库变化,回滚镜像未必就能回滚数据,因此可恢复的旧数据副本比只记住旧标签更重要。无法持续完成这些维护时,选择有人维护的托管方案通常更合适。
- 项目仓库与容器示例:
https://github.com/dani-garcia/vaultwarden - 配置与部署 Wiki:
https://github.com/dani-garcia/vaultwarden/wiki - 备份与恢复说明:
https://github.com/dani-garcia/vaultwarden/wiki/Backing-up-your-vault - 版本说明:
https://github.com/dani-garcia/vaultwarden/releases












暂无评论内容