知识与效率

Vaultwarden:自托管密码库部署

  • 0 次阅读
  • 0 条评论
文章摘要

Vaultwarden 实现兼容 Bitwarden 客户端的服务接口,适合自托管密码库。密码库需要可恢复的备份和可靠 HTTPS,不能只检查登录页面是否出现。 服务兼容 Bitwarden 客户端,客户端使用自己的服务器地址同步密码库。HTTPS、账号策略和备份共同决定能否长期可靠使用。 适合希望自托管密码资料的用户。正式迁移前先验证多设备同步和恢复,主密码应另行妥善记住。

项目介绍

Vaultwarden 是兼容 Bitwarden 客户端的轻量级密码库服务。下面结合截图介绍部署、HTTPS 反向代理、账户注册、管理后台和客户端连接。完成首个账号注册后,需要检查注册策略,并备份数据目录和管理凭据。

Vaultwarden 是一个使用 Rust 编写的轻量级 Bitwarden 兼容密码管理服务器,资源占用低,非常适合在 NAS(如群晖)或小型服务器上自建使用。


前提条件

  • 已安装 Docker 和 Docker Compose

  • 至少 512MB 内存

  • 至少 1GB 可用磁盘空间

  • 官网:https://bitwarden.com/


一、快速部署

1. 创建项目目录

mkdir -p /volume1/docker/vaultwarden
cd /volume1/docker/vaultwarden

💡 如果你不是在群晖上部署,请将路径 /volume1/docker/... 替换为你自己的路径。

2. 创建 Docker Compose 文件

在上述目录中创建 docker-compose.yml 文件,内容如下:

version: '3.8'

services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: unless-stopped
    environment:
      # 管理员密码(可以改成您自己喜欢的)
      ADMIN_TOKEN: "请填写自己的Token"
      # 使用您的群晖 IP
      DOMAIN: "http://192.168.0.47:8008"
      # 允许注册(首次使用后改为false)
      SIGNUPS_ALLOWED: "true"
      # 中国时区
      TZ: "Asia/Shanghai"
      # 实时同步功能
      WEBSOCKET_ENABLED: "true"
    volumes:
      - ./vaultwarden_data:/data
    ports:
      - "8008:80"

二、设置反代,实现https访问

⚠️ 注意:

  • DOMAIN 中的 IP 和端口需替换为你自己的服务器 IP 和映射端口。

  • 可使用 Lucky 或群晖自带的反向代理为 Vaultwarden 配置 HTTPS。下面以群晖的反向代理入口为例。
  • 路径:控制面板-登录门户-高级

操作步骤配图

操作步骤配图

反代后访问地址是:【https协议】

https://192.168.0.47:8899/

三、账户注册

1. 访问您的密码管理器

打开浏览器,访问:https://192.168.0.47:8899/

您会看到这样的界面:

操作步骤配图

2. 创建您的第一个账户

  1. 点击 创建账户

  2. 填写信息:

  • 姓名:您的名字

  • 邮箱:您的常用邮箱

  • 主密码:设置一个强密码(务必记住!)

  • 确认主密码:再次输入

  • 提示:密码提示(可选)

  1. 点击 创建账户

3. 登录管理后台(可选)

访问:https://192.168.0.47:8899/admin

  • 输入管理员密码:请填写自己的Token

  • 这里可以查看服务器状态和管理设置

重要安全设置

关闭公开注册

为了防止他人随意注册,完成首次注册后需要关闭注册功能:

方法:修改配置文件

  1. 编辑 docker-compose.yml 文件

找到SIGNUPS_ALLOWED: "true"

改为:SIGNUPS_ALLOWED: "false"

  1. 重启服务:

四、客户端配置

下载 Bitwarden 客户端

  • 手机端:在 App Store / 应用商店搜索 "Bitwarden"

  • 电脑端:在浏览器扩展商店搜索 "Bitwarden" 或访问 bitwarden.com

  • 已google为例

操作步骤配图

操作步骤配图

浏览器配置自定义服务器

  1. 打开 Bitwarden 客户端

  2. 点击 设置 → 服务器

  3. 设置 服务器 URL:https://192.168.0.47:8899

  4. 点击 保存

  5. 使用您注册的邮箱和密码登录

操作步骤配图


补充:部署与使用

安装与使用步骤

  1. 建立独立项目目录,替换示例 DOMAIN 为自己的 HTTPS 域名;本例端口只绑定宿主回环,由同机代理回源。
  2. 配置反向代理后初始化自己的账号,检查客户端能否连接;若代理运行在其他容器,按实际网络调整回源方式。
  3. 完成首个账号创建后按官方文档关闭不需要的注册,测试保存、同步、导出与恢复。

首次使用与操作检查

建立几条虚拟记录,分别在手机和扩展中同步,再修改一条确认更新。

导出后在独立测试库恢复,确认附件及组织数据的覆盖范围。升级前备份数据目录,保留数据库一致性。

Docker Compose

以下为整理后的配置示例。使用前替换目录、端口和凭据;浮动镜像标签会随上游变更,正式使用时应记录实际镜像摘要。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/vaultwarden/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/vaultwarden /volume1/docker/vaultwarden/data
cd /volume1/docker/vaultwarden
HALO_PREPARE
cd /volume1/docker/vaultwarden

https://vault.example.com 是域名示例,需改成自己的 HTTPS 域名并配置反向代理。此项目需要安全连接,域名无法由通用配置自动代填。

services:
  vaultwarden:
    image: vaultwarden/server:latest
    restart: unless-stopped
    environment:
      DOMAIN: "https://vault.example.com"
    ports:
      - "127.0.0.1:8000:80"
    volumes:
      - /volume1/docker/vaultwarden/data:/data

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 127.0.0.1:8000 不能直接从另一台电脑访问,必须经已配置的代理;不要误判为服务故障。
  • 主密码不能通过服务器备份找回,应妥善保存恢复信息。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

按官方一致性备份说明保存数据库、附件与密钥文件,备份加密并定期恢复演练。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

注册策略与恢复核对

完成自己需要的首批账号注册后,按当前服务文档配置注册策略,例如不再允许新用户自行注册时使用 SIGNUPS_ALLOWED=false。已有配置可能受管理后台保存值覆盖,调整后需要实际从未登录窗口检查,不能只看 Compose 文件。

如果开启管理后台,管理凭据单独生成与保管,不复用主密码,也不把示例 Token 直接粘贴到生产配置。反向代理与 DOMAIN 一致,先用测试账号确认网页、扩展和手机都能同步,再正式迁移密码。

备份应包含 /data 中的数据库、附件和关键密钥文件,数据库按官方一致性备份方式处理。恢复时在隔离环境检查一条测试记录及附件,再接回正式入口。密码导出如果为明文,完成恢复核对后妥善处理,不能上传到公开附件。

参考资料