jmqm/vaultwarden_backup

vaultwarden_backup Docker镜像文档

镜像概述

vaultwarden_backup是一款用于自动备份vaultwarden文件和目录的Docker镜像，将指定数据备份为tar.xz归档文件，可通过7-Zip、WinRAR等压缩工具打开。适用于需要定期保护vaultwarden数据安全的场景。

核心功能与特性

备份内容

自动备份以下vaultwarden文件和目录：

• db.sqlite3
• config.json
• rsa_key.der
• rsa_key.pem
• rsa_key.pub.der
• /attachments
• /sends

备份模式

• 自动备份：默认模式，通过定时任务自动执行
• 手动备份：通过指定命令手动触发

使用场景

• 个人或企业vaultwarden实例的数据定期备份
• 密码管理数据的灾备方案
• 需要自定义备份周期和保留策略的场景

使用方法

自动备份

通过docker-compose配置实现，默认启用自动备份，具体配置见下方示例。

手动备份

在docker run或docker-compose中指定command为manual即可触发手动备份。

Docker Compose配置示例

yaml
services:
  vaultwarden:
    # 此处为vaultwarden的配置
  backup:
    image: jmqm/vaultwarden_backup:latest
    container_name: vaultwarden_backup
    network_mode: none
    volumes:
      - /vaultwarden_data_directory:/data:ro  # 只读挂载vaultwarden数据目录
      - /backup_directory:/backups            # 备份文件存储目录
      - /etc/localtime:/etc/localtime:ro      # 容器使用主机时间
    environment:
      - DELETE_AFTER=30                       # 自动删除30天前的备份
      - CRON_TIME=* */24 * * *                # 每天0点执行备份
      - UID=1024                              # 运行cron任务的用户ID
      - GID=100                               # 运行cron任务的组ID

卷配置（权限要求）

权限说明：环境变量中指定的UID和GID用户必须对/backups目录有写权限。若需将该用户设为备份目录所有者，执行：

bash
chown ${UID}:${GID} /path/to/backups

环境变量

必填项 ⭐ / 推荐项 👍

可选项

¹ 时区列表参考：<[***]>

常见错误

意外时间戳

解决方法：挂载/etc/localtime（推荐只读挂载）或设置TZ环境变量。