自建 Vaultwarden:反代、备份、2FA 与升级的完整清单

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

访问次数:8

详细介绍
结论:Vaultwarden 的最小可用部署 = 一台 1C1G + Docker + 域名 + 反代 HTTPS + 每天备份 data 目录。四件事缺一件都别上线;升级前先备份,出错时你会感谢自己。

最小部署

官方推荐容器。最小命令是:镜像 vaultwarden/server:latest,环境变量 DOMAIN 指向你的 https 域名,把宿主目录挂到容器的 /data,端口只绑 127.0.0.1:8000,再交给 Nginx 或 Caddy 做 TLS。

端口不要直接暴露到公网:Web 端依赖 Web Crypto,必须 HTTPS,直接开 80 端口只会得到一个不能用的界面。证书用 acme.sh 或 certbot 都行(站内 ID204、ID205 有完整流程)。反代要转发 WebSocket,否则通知和实时同步会断;请求头记得带 X-Forwarded-For,不然日志里全是 127.0.0.1。

首次配置清单

  • 设 ADMIN_TOKEN,进 /admin 检查版本与数据库连接;
  • 关掉公开注册,改用邀请或手动建号;
  • 配 SMTP,否则用户忘记密码没法自救;
  • 开 2FA:TOTP、FIDO2、YubiKey 都支持;
  • 给组织建集合,按最小权限分配;
  • 确认 DOMAIN 与实际访问地址完全一致,包括 https。

这几项里最容易漏的是 SMTP。没有邮件服务,用户改密码、验证邮箱、紧急访问通知全部失效;等到出事才发现,已经晚了。

反代与常见故障

Nginx 侧至少三件事:把 / 转发到 127.0.0.1:8000;转发 Upgrade 与 Connection 头,让 WebSocket 通;给 client_max_body_size 一个够大的值,默认 1MB 会让附件上传直接 413。再加 X-Forwarded-Proto 与 X-Forwarded-For,生成链接和日志才不会错。

三个最常见的故障:页面能开但登录后空白——多半是 HTTPS 没配好,Web Crypto 不可用;附件上传失败——先看 client_max_body_size;邀请或找回密码邮件收不到——先看 SMTP 端口与发件域名,再看垃圾箱。这三个占了我遇到的故障的八成。

备份:三样东西

data 目录里真正不能丢的是三样:db.sqlite3,存库、用户、组织、设备元数据;attachments,附件按 UUID 存成单独文件;rsa_key 系列,用来签发登录令牌。sends 是可选的,config.json 只在开过管理后台后存在。

官方建议用 sqlite3 的 .backup 或 VACUUM INTO,而不是直接 cp——运行中的库直接复制可能拿到半写状态;1.32.1 之后还有内置的 /vaultwarden backup 命令。

我的脚本每天 03:00 跑 .backup,然后 tar 打包 attachments 与 rsa_key,保留 14 天,另一份推到异地对象存储。官方特别提醒不要拿虚拟机快照当唯一备份:恢复复杂、容易漏文件,真出事时通常救不回来。

升级

  • 先备份,再 docker pull;
  • 停旧容器、起新容器,迁移会在启动时自动跑;
  • 看启动日志有没有 migration 报错;
  • 登录一次、传一个附件、发一次 Send,三项都通再收工;
  • 保留上一版镜像 tag,回滚时能立刻切回。

Vaultwarden 是非官方实现,release notes 里偶尔会有破坏性变更,数据库字段、客户端兼容都可能动。我的习惯是「小版本直接升,大版本先看一周 issues」,生产库不赌。

成本与风险

1C1G 跑几十人足够,内存主要吃在并发同步上;真正占资源的是附件,不是数据库。风险有三条:单点故障,机器挂了就全挂;备份没演练,文件在但恢复不了;非官方支持,出问题只能靠社区。前两条能靠脚本和演练解决,第三条只能接受。

再加一层监控:外部探活盯首页 200、磁盘盯 /data 所在分区、备份脚本跑完发一条成功通知。三样都用免费的(Uptime Kuma 或 Healthchecks 都行),成本几乎为零,但能把「出事时才知道」变成「出事前就知道」。

自建 Vaultwarden:反代、备份、2FA 与升级的完整清单

图:Vaultwarden 官方 Wiki 的备份页,db.sqlite3 标为 Backup required,并给出 sqlite3 .backup 命令

如果这三条风险里有任何一条你无法接受,那就别自建——用官方托管版,或者退回 KeePassXC。自建的价值是控制权,不是省钱。

网友评论