tozd/rdiff-backup

tozd/rdiff-backup

<[***]>

可用镜像地址：

• https://hub.docker.com/r/tozd/rdiff-backup
• registry.gitlab.com/tozd/docker/rdiff-backup

镜像继承关系

tozd/base ← tozd/dinit ← tozd/mailer ← tozd/cron ← tozd/rdiff-backup

标签

• latest: rdiff-backup 2.2.6

卷

• /source/host: 需挂载主机待备份目录（通常为/，也可指定其他目录）。
• /source/data: 每次备份前，额外数据会被收集并存储于此，随后与其他文件一同备份。
• /backup: 备份文件的存储目标目录（自动排除自身，避免备份嵌套）。
• /etc/backup.d: 可选脚本目录，用于收集需备份的额外数据（如数据库转储）并存储至/source/data。

环境变量

• RDIFF_BACKUP_EXPIRE: 历史版本保留时长，格式需符合rdiff-backup手册的“时间格式”部分。默认值为12M（12个月）。

镜像概述

本Docker镜像基于rdiff-backup提供每日备份功能。主要用途是备份主机（含容器外数据卷），支持集成数据库转储等自定义数据，也可用于特定目录备份。通过rdiff-backup可直接访问最新版本，并能重建历史版本，历史变更通过反向增量方式存储。

如需远程备份（非本地主机备份），可考虑tozd/rdiff-backup-remote Docker镜像。

使用前提

容器需挂载主机的/var/run/docker.sock至容器内相同路径，以便镜像通过Docker客户端获取Docker目录位置（用于排除备份）。

使用方法

基础挂载配置

1. 将待备份目录（通常为主机/）挂载至/source/host卷。
2. 将备份存储目录挂载至/backup卷。

自定义备份范围

如需仅备份/source/host中的部分目录，可提供/source/backup.list文件，该文件将作为include-globbing-filelist参数传递给rdiff-backup。示例配置：

+ /source/host/etc
+ /source/host/home
+ /source/host/root
+ /source/host/var/backups
+ /source/host/var/log
+ /source/host/usr/local/bin
+ /source/host/usr/local/etc
+ /source/host/usr/local/sbin
- /source/host

上述配置指定备份/etc、/home、/root及部分/var目录，忽略/source/host下其他文件。所有路径需以/source/host为前缀。可通过挂载该文件至容器实现配置。

自定义数据收集脚本

通过/etc/backup.d目录添加脚本，可在备份前收集额外数据（如数据库转储）并存储至/source/data。示例脚本：

PostgreSQL数据库转储

创建/etc/backup.d/pgsql脚本：

bash
#!/bin/bash -e
docker exec pgsql pg_dumpall -U postgres > /source/data/pgsql.sql

MySQL数据库转储

创建/etc/backup.d/mysql脚本：

bash
#!/bin/bash -e
PASSWORD=$(docker exec mysql grep password /etc/mysql/debian.cnf | awk '{print $3}' | head -1)
echo "$PASSWORD" | docker exec mysql mysqldump --user=debian-sys-maint --password="$PASSWORD" --all-databases > /source/data/mysql.sql

邮件通知配置

如需在每日备份出错时接收邮件通知，需配置MAILTO、ADMINADDR和REMOTES环境变量，具体说明参见tozd/mailer和tozd/cron Docker镜像文档。

部署示例

docker run命令示例

bash
docker run -d \
  --name rdiff-backup \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /:/source/host \
  -v /path/to/backup:/backup \
  -v /path/to/backup.d:/etc/backup.d \
  -e RDIFF_BACKUP_EXPIRE="6M" \
  -e MAILTO="admin@example.com" \
  -e ADMINADDR="admin@example.com" \
  -e REMOTES="smtp.example.com:587" \
  tozd/rdiff-backup

GitHub镜像

项目提供https://github.com/tozd/docker-rdiff-backup%EF%BC%8C%E4%BE%9B%E9%9C%80%E8%A6%81%E5%9C%A8GitHub%E4%B8%8A fork 项目时使用。