Backup-Tool Docker镜像文档

概述

Backup-Tool 是一个专为数据备份设计的Docker镜像，旨在简化各类数据的自动化备份流程。该镜像集成了多种备份工具与调度机制，支持灵活配置备份源、目标存储及执行周期，适用于从小型服务器到企业级应用的各类数据保护场景。

核心功能与特性

• 多源备份支持：兼容文件系统（本地目录、挂载卷）及主流数据库（MySQL、PostgreSQL、MongoDB等）备份
• 多样化存储目标：支持将备份文件保存至本地路径、AWS S3/兼容S3存储、FTP/SFTP服务器、WebDAV等
• 定时任务调度：内置cron服务，可通过环境变量或配置文件设置备份周期（如每日、每周）
• 数据安全保障：支持备份文件压缩（gzip/bzip2）及加密（AES-256），保护敏感数据
• 轻量高效：基于Alpine Linux构建，镜像体积小，资源占用低，运行高效稳定

使用场景

• 服务器数据备份：定期备份Web服务器网站文件、日志数据及配置文件
• 数据库定时备份：对MySQL、PostgreSQL等数据库执行自动备份，防止数据丢失
• 个人/家庭数据保护：备份本地文档、照片等个人数据至云端存储或外接设备
• 应用迁移支持：生成标准化备份文件，便于跨服务器/环境的数据迁移与恢复

使用方法与配置说明

基本使用（Docker Run）

docker run -d \
  --name backup-tool \
  -v /path/to/source:/backup/source \  # 挂载需备份的源目录
  -v /path/to/local-backup:/backup/dest \  # 挂载本地备份目标目录（可选）
  -e BACKUP_SOURCE="/backup/source" \  # 备份源路径
  -e BACKUP_DEST="local:/backup/dest" \  # 备份目标（格式：类型:路径）
  -e SCHEDULE="0 3 * * *" \  # cron表达式，每日凌晨3点执行备份
  -e COMPRESSION="gzip" \  # 启用压缩（可选：gzip/bzip2/none）
  backup-tool:latest

环境变量配置

数据库备份示例（MySQL）

docker run -d \
  --name mysql-backup \
  -e BACKUP_SOURCE="mysql://root:password@mysql-host:3306/mydb" \  # MySQL连接信息
  -e BACKUP_DEST="s3:s3://my-backup-bucket/mysql" \  # 备份至S3
  -e AWS_ACCESS_KEY_ID="your-access-key" \  # S3访问密钥（如目标为S3时必填）
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e SCHEDULE="0 2 * * *" \  # 每日凌晨2点备份
  -e RETENTION_DAYS=7 \  # 保留7天备份
  backup-tool:latest

Docker Compose配置示例

version: '3'
services:
  backup:
    image: backup-tool:latest
    volumes:
      - ./local-backups:/backup/local  # 本地备份存储
    environment:
      - BACKUP_SOURCE="/data"  # 假设挂载了/data目录到容器内
      - BACKUP_DEST="local:/backup/local"
      - SCHEDULE="0 0 * * *"  # 每日午夜执行
      - COMPRESSION="bzip2"
      - RETENTION_DAYS=14
    restart: always  # 确保容器持续运行以执行定时任务

注意事项

• 首次使用前请验证BACKUP_SOURCE和BACKUP_DEST配置的可访问性，避免权限问题
• 加密备份文件需妥善保管ENCRYPTION_KEY，丢失将导致无法恢复数据
• 对于云存储目标（如S3），需确保容器网络可访问对应服务，并配置正确的访问凭证