Vaultwarden:71.1k star 的 Bitwarden 兼容服务端,一条 Docker 命令自建

Rust 写的 Bitwarden 兼容服务端,可自建

更新时间:2026-11-22 15:46:28

访问次数:4

详细介绍
一句话结论:想自己拿住密码库、又不想放弃 Bitwarden 的客户端生态,Vaultwarden 是最省事的答案:Rust 写的兼容服务端,71.1k star,一条 docker run 就能起;前提是你能搞定 HTTPS 和每天备份。

这是什么

Vaultwarden 是非官方的 Bitwarden 兼容服务端(原名 bitwarden_rs),用 Rust 写,基于 Rocket,许可为 AGPL-3.0。仓库现在 71.1k star、3.5k fork、3,166 次提交,最新版本 1.37.5。

它实现了 Bitwarden 客户端 API 的绝大部分:个人库、Send、附件、组织与集合、密码共享、成员角色、事件日志、TOTP、FIDO2 WebAuthn、YubiKey、Duo、紧急访问、管理后台。官方 README 有三条硬提醒:Web 端依赖 Web Crypto,必须 HTTPS;建议放在反向代理后面;推荐用容器镜像(ghcr、docker、quay 都有)。

我怎么用它

  • 一台 1C1G 的机器装 Docker,run 时给 DOMAIN、把 /data 挂出来、只监听 127.0.0.1:8000;
  • 前面用 Nginx 或 Caddy 做 TLS,证书走 acme.sh 或 certbot(站内 ID204、ID205);
  • 首次进管理后台设 ADMIN_TOKEN,关掉公开注册,改用邀请;
  • 手机和桌面客户端登录时填自己的域名,先做一次全量同步;
  • 每天跑一次 db.sqlite3 的 .backup,加上 attachments 打包,异地存一份。

我自己的用法是「一个人 + 两台设备」:小机器上跑容器,反代走已有的 Nginx,备份脚本每天 03:00 跑,保留 14 天。真实感受是资源占用确实低,Rust 单进程,平时内存几百 MB 级别,比官方全套服务轻得多。

但「非官方」三个字要认:出问题没有 Bitwarden 官方支持,升级前必须自己看 release notes。我把它当「可控的自建服务」,不是「免费的企业级产品」——这个定位想清楚,后面很多期待就不会错位。

和官方自建版比,它的优势是「组件少」:官方那套要 Web、API、数据库、反代分开部署,Vaultwarden 是一个容器加一个数据目录,迁移时把 /data 打包走就行。代价是「非官方」——客户端兼容性靠社区跟版本,偶尔会有某个客户端版本对不上的情况。

还有两件上线前必须想清楚的事:SMTP 和推送。没有 SMTP,邀请、找回密码、紧急访问通知都发不出去;手机推送需要额外接一个中继服务,或者接受「打开 App 才同步」。这两项不配,功能是「能用」,但离「好用」还差一截。

上手截图

Vaultwarden:71.1k star 的 Bitwarden 兼容服务端,一条 Docker 命令自建

图:Vaultwarden 仓库页,71.1k star、3.5k fork、3,166 次提交、AGPL-3.0、最新 1.37.5

优点

  • 数据完全在自己机器上,客户端还是 Bitwarden 那一套,迁移成本低;
  • Rust 单进程,1C1G 就能跑,小团队足够;
  • 功能覆盖全:组织共享、Send、附件、TOTP、FIDO2、紧急访问都有;
  • AGPL-3.0,代码可审计,社区活跃。

缺点

  • 非官方实现,没有官方 SLA 与技术支持;
  • HTTPS 是硬要求,反代配错就是空白页;
  • /data 丢了就全丢,备份必须自动化并演练;
  • 手机推送、SSO 这类功能要额外配置,不是开箱即用。

什么时候别用它

不想维护服务器、不想碰证书和备份的人;团队要求 SLA、合规审计、工单支持的场景;以及只用一个人的——直接用 Bitwarden 免费版或 KeePassXC,省下的时间比省下的钱值钱。

网友评论