Vaultwarden 搭建与自动备份

简介#

Vaultwarden 是一个用 Rust 编写的非官方 Bitwarden 服务器实现，完全兼容官方 Bitwarden 客户端，特别适合资源有限的自托管场景。

dani-garcia

vaultwarden

Waiting for api.github.com...

00K

Waiting...

vaultwarden-backup 是一个专门为 Vaultwarden 设计的备份工具，可将数据加密后通过 Rclone 同步到多种远程存储（如阿里云 OSS、AWS S3 等）。

ttionya

vaultwarden-backup

Waiting for api.github.com...

00K

Waiting...

本文的重点是分别部署 Vaultwarden 和 vaultwarden-backup 服务，并实现自动备份。如果你希望一键快速体验，也可以直接使用项目自带的 docker-compose.yml 进行部署（具体参考官方仓库）。接下来我们将详细讲解手动部署的整个过程。

分别部署 Vaultwarden 与备份服务#

1. 部署 Vaultwarden#

创建一个工作目录，并在其中新建 compose.yml，内容如下：

1
services:
2
  vaultwarden:
3
    image: vaultwarden/server:latest
4
    container_name: vaultwarden
5
    restart: always
6
    environment:
7
      DOMAIN: "<domain name>"       # 替换为你的域名
8
      SIGNUPS_ALLOWED: "true"       # 初次启动时允许注册，稍后关闭
9
    volumes:
10
      - ./vw-data:/data             # 数据持久化目录
11
    ports:
12
      - 11001:80                    # 可根据需要修改宿主机端口

启动容器：

1
docker compose up -d

配置反向代理（以 Caddy 为例）#

在 Caddyfile 中添加如下站点配置（根据实际路径调整）：

1
<domain name> {
2
    log {
3
        level INFO
4
        output file /var/www/vaultwarden/access.log {
5
            roll_size 10MB
6
            roll_keep 10
7
        }
8
    }
9
    encode zstd gzip
10
    reverse_proxy localhost:11001 {
11
        header_up X-Real-IP {remote_host}
12
    }
13
}

重载 Caddy 使配置生效：

1
sudo caddy reload --config /etc/caddy/Caddyfile

Note

请确保日志目录（如 /var/www/vaultwarden）存在且有写入权限。

现在通过域名访问你的 Vaultwarden 实例，注册管理员账号并登录。

关闭公开注册#

注册完成后，停止容器，将 SIGNUPS_ALLOWED 改为 false，再重新启动，以防止他人注册。

1
docker compose down
2
# 编辑 compose.yml，将 SIGNUPS_ALLOWED 改为 "false"
3
docker compose up -d

2. 部署 vaultwarden-backup 并同步至阿里云 OSS#

2.1 创建对象存储 Bucket#

登录阿里云控制台，创建一个 OSS Bucket，并获取 AccessKey ID 和 AccessKey Secret。具体步骤可参考阿里云官方文档，此处不再赘述。

2.2 配置 Rclone#

运行以下命令进入 Rclone 交互式配置界面，挂载配置目录 vaultwarden-rclone-data：

1
docker run --rm -it \
2
  -v ./vaultwarden-rclone-data:/config \
3
  ttionya/vaultwarden-backup:latest \
4
  rclone config

Alibaba OSS官方配置文档

按照提示创建新远程（remote），建议将名称设置为 BitwardenBackup。配置过程会要求填写云服务商（选择 Amazon S3、Provider 选 Alibaba）、AccessKey、SecretKey、Endpoint（如 oss-cn-shenzhen.aliyuncs.com）等信息。

完成后，可通过以下命令验证配置是否正确：

1
docker run --rm -it \
2
  -v ./vaultwarden-rclone-data:/config \
3
  ttionya/vaultwarden-backup:latest \
4
  rclone config show
5

6
# 示例输出：
7
# [BitwardenBackup]
8
# type = s3
9
# provider = Alibaba
10
# access_key_id = <access_key_id>
11
# secret_access_key = <secret_access_key>
12
# endpoint = oss-cn-shenzhen.aliyuncs.com
13
# acl = private
14
# storage_class = STANDARD
15
# bucket_acl = private

2.3 添加备份服务到 compose.yml#

在之前创建的 compose.yml 中添加 backup 服务，完整示例如下：

1
services:
2
  vaultwarden:
3
    image: vaultwarden/server:latest
4
    container_name: vaultwarden
5
    restart: always
6
    environment:
7
      DOMAIN: "<domain name>"
8
      SIGNUPS_ALLOWED: "false"   # 生产环境建议关闭注册
9
    volumes:
10
      - ./vw-data:/data
11
    ports:
12
      - 11001:80
13

14
  backup:
15
    image: ttionya/vaultwarden-backup:latest
16
    container_name: vaultwarden-backup
17
    restart: always
18
    environment:
19
      RCLONE_REMOTE_DIR: '/<bucket-name>/'     # 替换为你的 Bucket 名称
20
      CRON: '15 1 * * *'                       # 备份计划：每天 01:15 执行
21
      ZIP_ENABLE: 'TRUE'                       # 启用压缩加密
22
      ZIP_PASSWORD: '<password>'               # 设置加密密码，务必妥善保管
23
      ZIP_TYPE: 'zip'
24
      TIMEZONE: 'Asia/Shanghai'
25
      DATA_DIR: "/data"
26
    volumes:
27
      - ./vw-data:/data:ro                     # 以只读方式挂载数据目录
28
      - ./vaultwarden-rclone-data:/config      # Rclone 配置目录

IMPORTANT

通过以上配置，备份工具将每天早上 01:15 自动将 /data 下的 Vaultwarden 数据打包为加密 ZIP 文件，然后通过 Rclone 上传到阿里云 OSS 的指定路径。更多高级选项（如邮件通知、健康检查等）请参阅官方文档。

启动全部服务：

1
docker compose up -d

简介#

分别部署 Vaultwarden 与备份服务#

1. 部署 Vaultwarden#

配置反向代理（以 Caddy 为例）#

关闭公开注册#

2. 部署 vaultwarden-backup 并同步至阿里云 OSS#

2.1 创建对象存储 Bucket#

2.2 配置 Rclone#

2.3 添加备份服务到 compose.yml#

文章分享

文章目录