小岳
2026-11-22
点 赞
0
热 度
0
评 论
0

Vaultwarden:把自己的密码库搬回家里,顺便省下订阅费

  1. 首页
  2. 开源分享
  3. Vaultwarden:把自己的密码库搬回家里,顺便省下订阅费

文章摘要

摸鱼小助手

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

两个最容易漏的:

  1. X-Forwarded-Proto —— 不传的话 Vaultwarden 以为自己在 HTTP 上,部分链接会错
  2. WebSocket 那两行 —— 不配的话"实时同步"失效,改一条密码要手动刷新才看见

五、第三步:注册,然后立刻关掉注册

  1. 打开 https://vault.example.com
  2. 点 Create account,填邮箱 + 主密码
  3. 主密码必须记住——它是解密钥匙,服务端只存哈希,忘了谁都救不了
  4. 登录进去看到空密码库,成功

然后关注册。把参数写进 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,你必须手动改服务器地址。

浏览器扩展

  1. 装 Bitwarden 扩展
  2. 登录页左上角/右上角找齿轮图标
  3. 找到 Self-hosted environment(自托管环境)
  4. Server URL 填 https://vault.example.com
  5. 保存 → 回登录页,用邮箱 + 主密码登录

手机 App

  1. 打开 App,登录页点齿轮/设置
  2. Self-hosted environment → Server URL 填同样的地址
  3. 返回登录

桌面端

同样在登录页找设置改 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 + 域名
忘记主密码 服务端只存哈希 无法恢复,只能靠备份或提前导出

最后一条不是玩笑。建议:

  • 主密码写纸上锁抽屉(老办法,有效)
  • 开两步验证
  • 定期导出一份加密的密码库备份

十、出处与参考

项目以 AGPL-3.0 开源,与 Bitwarden 官方无隶属关系。命令在 2026-11 的 latest 镜像上验证;环境变量名以对应版本 Wiki 为准。


本站站长,主角光环,怎么滴,你还想攻击你的站长吗,真是好big的狗胆

小岳

intp 逻辑家

站长

不具版权性
不具时效性

文章内容不具时效性。若文章内容有错误之处,请您批评指正。

目录

欢迎来到摸鱼干货栈,这里为您提供开源与摸鱼源码

43 文章数
7 分类数
0 评论数
47标签数
最近评论