密码存在浏览器里,换台设备就不同步;存表格里,又怕哪天误发。Vaultwarden 把密码库放回自己机器,客户端还是 Bitwarden,手机、浏览器都能用。
Vaultwarden 是什么
Vaultwarden 是 Bitwarden 服务端的轻量兼容实现,用 Rust 写,单容器就能跑,资源占用比官方服务端低很多。客户端、浏览器扩展和 Bitwarden 官方兼容,数据存在你自己的服务器。
Docker 部署
docker run -d --name vaultwarden \
--restart=unless-stopped \
-p 8080:80 \
-v /data/vaultwarden:/data \
-e SIGNUPS_ALLOWED=false \
-e ADMIN_TOKEN=换成随机长字符串 \
vaultwarden/server:latest
/data 里有数据库、附件和配置,必须单独备份。首次部署可以先开注册建号,建完立刻关掉。
HTTPS 和域名
Bitwarden 客户端要求 HTTPS,Web Crypto 在 HTTP 下不可用。用 Nginx 反代加证书:
server {
listen 443 ssl;
server_name vault.example.com;
client_max_body_size 100m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
}
}
反代要传 X-Real-IP,否则限流和日志拿不到真实 IP;WebSocket 也要透传,通知才及时。
账号和注册
- 建完账号把
SIGNUPS_ALLOWED设为 false - 需要邀请时用管理面板发邀请,别长期开公开注册
ADMIN_TOKEN用长随机串,别用默认值- 管理员账号和日常账号分开

2FA
Vaultwarden 支持 TOTP、WebAuthn 和 Duo。建议至少开 TOTP,管理员强制;恢复码单独保存,别只存手机里。

备份
备份整个 /data 目录,升级前先停容器再备:
docker stop vaultwarden
tar czf vaultwarden-$(date +%F).tar.gz -C /data vaultwarden
docker start vaultwarden
数据库、附件、rsa_key 都在里面;只备数据库,附件和密钥会丢。备份文件加密后放另一处。

德国还是新加坡
密码库是低频访问,但延迟影响解锁和同步体验。
- 德国:欧盟用户近,数据位置更合规
- 新加坡:东南亚用户近,回国访问也还行
- 香港:大陆访问最快,适合个人或小团队
团队在哪就放哪;跨境备份要加密,别把密码库明文传到另一地。
安全
- 关闭公开注册,管理员开 2FA
- HTTPS 强制,HSTS 打开
- 反代加限流,防撞库
- 定期升级镜像,关注安全公告
- 备份文件加密,权限 600
和官方服务端
官方服务端功能全、支持企业策略,但资源占用高;Vaultwarden 轻量、兼容客户端,适合小团队自用。
客户端
浏览器扩展、桌面端、手机端都能连;填自建域名,登录后同步。别用来源不明的第三方客户端。
升级
升级前备份 data,拉新镜像后重启;跨版本看 release notes,别直接 latest 不回头。
限流
登录和注册接口限流,防撞库;反代层加 fail2ban,别让日志只留在容器里。
组织共享
团队用组织共享密码库,按角色分权限;离职先移除组织成员,再删账号。
多用户
家庭或小团队可以各用各的账号,再建组织共享;别共用主账号,出问题无法追责。
审计
看登录失败、管理员操作和邀请记录;异常登录先禁用账号,再查 IP 和设备。
故障恢复
容器起不来先看 data 权限和数据库锁;恢复时用同版本镜像,避免数据库结构不兼容。
迁移
从 Bitwarden 或其它服务迁过来,用客户端导出再导入;迁完检查附件和文件夹,别只看登录成功。
性能
Vaultwarden 很轻,1 核 1G 能跑小团队;主要看磁盘和备份,CPU 不是瓶颈。
备份验证
备份完解压看一眼,确认数据库和附件都在;只备份不验证,等于没备。
常见错误
最常见的是没配 HTTPS、没关注册、ADMIN_TOKEN 用默认值;三件事上线前必须改。
合规
密码库含账号和密钥,属于敏感数据;位置、备份和访问日志按公司安全要求留档。
运维
监控容器、磁盘和证书到期;小服务也要有告警,别等登录不上才发现。
先把备份和 2FA 做好,再谈多用户和共享。
先跑通一个账号,再谈团队共享和迁移。
先把密码库搬进来,再谈团队共享。
先把数据守住,再谈功能。
先把账号和备份跑通,再谈共享。
先把安全底线守住。
先守住密码,再谈协作。
先守住,再共享啊。
常见问题 FAQ
Q1:Vaultwarden 和 Bitwarden 有什么区别?
Vaultwarden 是兼容服务端的轻量实现,客户端一样用;企业级功能和官方支持不如 Bitwarden。
Q2:必须 HTTPS 吗?
必须。客户端和 Web Crypto 都要求安全上下文,HTTP 下无法正常使用。
Q3:德国还是新加坡节点?
欧盟用户选德国,东南亚选新加坡,大陆个人/小团队选香港。
Q4:数据丢了能恢复吗?
只能靠备份。主密码和 rsa_key 丢了,官方也救不了。
Q5:能商用吗?
看许可证和合规要求;企业内部用没问题,对外提供服务要评估。
总结
Vaultwarden 适合想自己控密码库的团队:Docker 单容器、HTTPS 反代、关闭公开注册、管理员 2FA、备份整个 data 目录。节点按用户位置选,备份加密后异地存放。
需要一台密码库服务器,可以按小时开一台萤光云德国 VPS,先把 HTTPS 和备份跑通。
自托管密码库先把备份和 2FA 恢复码管好,再谈迁移。







