drubin/tarsnapper

drubin/tarsnapper镜像说明

镜像概述

本镜像基于https://github.com/miracle2k/tarsnapper%E5%B7%A5%E5%85%B7%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%AE%B9%E5%99%A8%E5%8C%96%E7%9A%84%E5%AE%9A%E6%97%B6%E5%A4%87%E4%BB%BD%E5%8A%9F%E8%83%BD%E3%80%82%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E6%97%B6%E4%BC%9A%E5%9C%A8%E5%90%8E%E5%8F%B0%E8%AE%BE%E7%BD%AE cron 任务，定期备份一个或多个目录到Tarsnap服务，用户可通过环境变量或挂载文件自定义镜像行为。

核心功能

• 定时备份：通过 cron 表达式指定备份频率，默认每日随机时间执行以减轻Tarsnap服务器压力。
• 自定义配置：支持通过环境变量设置备份命令，或挂载自定义Tarsnapper配置文件（/etc/tarsnapper.conf）实现高级定制。
• 数据恢复：提供简洁的恢复命令，可快速从Tarsnap备份中恢复数据。
• 时间同步：支持挂载主机时区文件确保备份时间准确。
• 缓存维护：每次调用Tarsnapper时自动执行tarsnap --fsck，保持缓存最新（注意：会产生少量元数据下载费用）。

使用场景

• 服务器重要数据的定期自动备份。
• 个人或团队文件的云端备份（依赖Tarsnap服务）。
• 需要自定义备份策略（如保留不同时间周期的备份版本）的场景。

配置说明

部署示例

bash
docker run -d \
    --name=tarsnapper \
    -v <待备份数据路径>:/backup:ro \
    -v <Tarsnap密钥路径>:/tarsnap/key:ro \
    -v /etc/localtime:/etc/localtime:ro \
    -e "BACKUP_CRON=0 0 * * *" \
    -e "BACKUP_COMMAND=-o v -c /etc/tarsnapper.conf make" \
    drubin/tarsnapper

参数说明

• -v /backup：挂载待备份的数据目录（只读模式）。
• -v /tarsnap/key：挂载Tarsnap的私钥文件（只读模式）。
• -v /etc/localtime：挂载主机时区文件，确保容器时间与主机同步。
• -e BACKUP_CRON：备份任务的 cron 表达式，默认每日随机时间。
• -e BACKUP_COMMAND：Tarsnapper执行的备份命令，默认值为-c /etc/tarsnapper.conf make。

注意事项

1. 环境变量使用：若需在/etc/tarsnapper.conf中使用环境变量，需自定义入口点将变量写入/etc/environment，否则 cron 任务无法读取。
2. 费用提示：自动执行的tarsnap --fsck会产生少量元数据下载费用，请留意Tarsnap账单。

数据恢复

如需恢复备份数据，执行以下命令：

bash
docker run --rm -it \
    -v <恢复目标目录>:/backup \
    -v <Tarsnap密钥路径>:/tarsnap/key:ro \
    -v /etc/localtime:/etc/localtime:ro \
    drubin/tarsnapper \
    sh -c "tarsnap --fsck && tarsnap -pxf <备份名称>"