Vaultwarden:把自己的密码库搬回家里,顺便省下订阅费
读者假设:用过密码管理器(或准备用),会敲命令行。 需要:一台常开机器 + 一个域名(推荐)。25 分钟。 成品:打开
https://你的域名是登录页,手机 / 浏览器扩展 / 桌面端都能同步。
一、为什么要自建
密码管理器是所有账号的钥匙,选择标准跟别的软件不太一样:
| 关注点 | 商业托管 | 自建 |
|---|---|---|
| 数据在哪 | 别人的服务器 | 你的硬盘 |
| 订阅费 | 家庭版每年几十到上百元 | 服务器电费 + 域名 |
| 可用性 | 大厂基本不挂 | 你自己负责,机器挂了就同步不了 |
| 迁移成本 | 导出方便 | 更自由,但要会运维 |
Vaultwarden 是什么:Bitwarden 官方服务端的轻量重写版(Rust),内存占用小、用 SQLite 单文件存储,但兼容 Bitwarden 全部官方客户端——浏览器扩展、手机 App、桌面端、CLI 都能直连。
也就是说:你用的是官方客户端,后端换成自己的。不用付订阅费,也不用装来路不明的客户端。
二、部署前必须明白:HTTPS 是硬要求
浏览器扩展在非安全上下文里会拒绝工作。所以:
http://localhost可以(本机调试)https://你的域名可以http://你的IP:8080—— 扩展会拒绝,手机 App 也可能报错
所以本文按"域名 + 反向代理 + Let's Encrypt"来写。
三、第一步:起容器
mkdir -p /opt/vaultwarden/data
docker run -d \
--name vaultwarden \
--restart unless-stopped \
-p 127.0.0.1:8080:80 \
-v /opt/vaultwarden/data:/data \
-e DOMAIN="https://vault.example.com" \
-e SIGNUPS_ALLOWED=true \
vaultwarden/server:latest
三个要点:
| 参数 | 为什么这么写 |
|---|---|
-p 127.0.0.1:8080:80 |
只监听本机,外网必须经反代。别把裸 HTTP 端口暴露出去 |
-v /opt/vaultwarden/data:/data |
所有数据都在这:库、附件、RSA 密钥。必须挂出来 |
SIGNUPS_ALLOWED=true |
先开着注册,注册完立刻关(见第五节) |
你应该看到
docker ps --filter name=vaultwarden
CONTAINER ID IMAGE STATUS PORTS
xxxx vaultwarden/server:latest Up 5 seconds 127.0.0.1:8080->80/tcp
再验一下:
curl -I http://127.0.0.1:8080
返回 200 或 302 就说明服务起来了。
四、第二步:反代与证书
server {
listen 443 ssl http2;
server_name vault.example.com;
ssl_certificate /etc/letsencrypt/live/vault.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/vault.example.com/privkey.pem;
client_max_body_size 128m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 600s;
}
}
证书:
sudo certbot --nginx -d vault.example.com
两个最容易漏的:
X-Forwarded-Proto—— 不传的话 Vaultwarden 以为自己在 HTTP 上,部分链接会错- WebSocket 那两行 —— 不配的话"实时同步"失效,改一条密码要手动刷新才看见
五、第三步:注册,然后立刻关掉注册
- 打开
https://vault.example.com - 点 Create account,填邮箱 + 主密码
- 主密码必须记住——它是解密钥匙,服务端只存哈希,忘了谁都救不了
- 登录进去看到空密码库,成功
然后关注册。把参数写进 docker-compose.yml 更省事:
services:
vaultwarden:
image: vaultwarden/server:latest
container_name: vaultwarden
restart: unless-stopped
ports:
- "127.0.0.1:8080:80"
volumes:
- ./data:/data
environment:
DOMAIN: "https://vault.example.com"
SIGNUPS_ALLOWED: "false"
ADMIN_TOKEN: "替换成 openssl rand -base64 48 的输出"
docker compose up -d
生成管理口令:
openssl rand -base64 48
六、客户端怎么连(这一步最多人卡住)
核心事实:官方客户端默认连 bitwarden.com,你必须手动改服务器地址。
浏览器扩展
- 装 Bitwarden 扩展
- 登录页左上角/右上角找齿轮图标
- 找到 Self-hosted environment(自托管环境)
- Server URL 填
https://vault.example.com - 保存 → 回登录页,用邮箱 + 主密码登录
手机 App
- 打开 App,登录页点齿轮/设置
- Self-hosted environment → Server URL 填同样的地址
- 返回登录
桌面端
同样在登录页找设置改 Server URL。
"登录不进去 / 一直提示用户名密码错误"的绝大多数原因,是服务器地址没改——它还在连 bitwarden.com,而你那个账号在那边根本不存在。
七、管理面板与加人
面板地址:https://vault.example.com/admin,输入 ADMIN_TOKEN 即可进入,能做:
- 看用户列表、邀请新用户
- 删除用户、查看诊断(SMTP 通不通、域名配对没)
- 调整全局设置
加第二个用户(家人)
面板里 Users → Invite User,填邮箱发邀请(需要配 SMTP)。
不配 SMTP 也能加:临时把 SIGNUPS_ALLOWED 改回 true,让对方自助注册,注册完再关掉。麻烦但有效。
八、备份:这一步别省
所有数据都在 /opt/vaultwarden/data:
db.sqlite3 数据库(密码条目加密后存在这里)
attachments/ 附件
sends/ 临时分享
rsa_key.pem 服务端密钥,丢了客户端会报密钥不匹配
config.json 运行时配置
#!/bin/bash
set -euo pipefail
DEST="/backup/vaultwarden"
mkdir -p $DEST
STAMP=$(date +%F)
# SQLite 要用 .backup,直接 cp 可能拷到写了一半的文件
docker exec vaultwarden sqlite3 /data/db.sqlite3 ".backup '/data/db-backup.sqlite3'"
docker cp vaultwarden:/data/db-backup.sqlite3 "$DEST/db-$STAMP.sqlite3"
docker cp vaultwarden:/data/rsa_key.pem "$DEST/rsa_key-$STAMP.pem"
tar czf "$DEST/attachments-$STAMP.tar.gz" /opt/vaultwarden/data/attachments
echo "backup done: $DEST"
关键点:SQLite 不能直接 cp,要用 .backup 或停机拷贝,否则可能拿到损坏的库。
配合定时任务每天一份,异地存一份。备份不验证等于没备份——偶尔真恢复一次试试。
九、八个常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 扩展登录失败,网页却能登 | Server URL 没改 | 见第六节 |
| 白屏 / 一直转圈 | 反代没传 X-Forwarded-Proto |
Nginx 加该 header |
| 改了密码其它设备不同步 | WebSocket 没配 | 补 Upgrade / Connection 头 |
/admin 提示 token 无效 |
环境变量没生效 | docker logs vaultwarden 看启动参数,确认重启过 |
| 注册提示 disabled | SIGNUPS_ALLOWED=false |
临时改 true,加完人再关 |
| 附件上传失败 | 反代 body 限制 | client_max_body_size 128m; |
| 手机连不上 | 用了 IP + http | 必须 https + 域名 |
| 忘记主密码 | 服务端只存哈希 | 无法恢复,只能靠备份或提前导出 |
最后一条不是玩笑。建议:
- 主密码写纸上锁抽屉(老办法,有效)
- 开两步验证
- 定期导出一份加密的密码库备份
十、出处与参考
- 项目仓库:https://github.com/dani-garcia/vaultwarden
- Wiki(配置项全集,最有用的一页):https://github.com/dani-garcia/vaultwarden/wiki
- 反向代理示例:https://github.com/dani-garcia/vaultwarden/wiki/Proxy-examples
- 备份说明:https://github.com/dani-garcia/vaultwarden/wiki/Backing-up-your-vault
- 官方客户端下载:https://bitwarden.com/download/
- 镜像:
vaultwarden/server(Docker Hub)
项目以 AGPL-3.0 开源,与 Bitwarden 官方无隶属关系。命令在 2026-11 的
latest镜像上验证;环境变量名以对应版本 Wiki 为准。
默认评论
Halo系统提供的评论