leen15/docker-s3-mysql-dump

MySQL备份至S3 Docker镜像

镜像概述

本镜像用于自动备份MySQL数据库的所有数据，并将备份文件上传至AWS S3 Bucket。默认以定时任务（每小时）运行，也可作为一次性备份工具使用，支持多种参数配置以适配不同场景需求。

核心功能

1. 定时备份：默认每小时执行一次备份，可通过BACKUP_CRON_SCHEDULE调整执行周期
2. 一次性备份：直接运行backup.sh脚本触发单次备份
3. 优先级控制：通过BACKUP_PRIORITY参数调整备份任务的系统资源优先级（使用ionice和nice）
4. 灵活配置：支持排除指定数据库、自定义备份目录、调整MySQL dump参数
5. S3存储：支持将备份文件上传至S3 Bucket，可指定子目录存储

使用场景

• 中小企业MySQL数据库的定期自动备份需求
• 个人项目或开发环境的数据保护
• 需要将数据库备份存储至云端（S3）的场景

配置说明

MySQL连接变量

需设置以下变量以连接目标MySQL服务：

MYSQL_HOST=mysql  # MySQL服务地址
MYSQL_PASSWORD=password  # MySQL访问密码

S3备份变量

需设置以下变量以启用S3上传功能：

BACKUP_S3_BUCKET=bucket_name  # S3 Bucket名称（末尾无斜杠，可加子目录如bucket_name/subdir）
AWS_DEFAULT_REGION=cn-north-1  # AWS区域（如中国区cn-north-1）
AWS_ACCESS_KEY_ID=your_access_key  # AWS访问密钥ID
AWS_SECRET_ACCESS_KEY=your_secret_key  # AWS秘密访问密钥

可选调整变量

BACKUP_CRON_SCHEDULE=0 * * * *  # 定时任务表达式（默认每小时）
MYSQL_BACKUP_DIR=/var/backup/mysql  # 本地备份目录，可挂载卷保留文件
MYSQL_EXCLUDE_DBS=|sys|mysql  # 需排除的数据库（用|分隔）
BACKUP_PRIORITY="ionice -c 3 nice -n 10"  # 备份任务优先级（默认低优先级）
MYSQL_DUMP_PARAMS="--lock-tables=false --single-transaction --quick"  # MySQL dump参数

部署示例

Docker Run命令

bash
docker run -d \
  -e MYSQL_HOST=mysql \
  -e MYSQL_PASSWORD=your_mysql_password \
  -e BACKUP_S3_BUCKET=your_bucket_name \
  -e AWS_DEFAULT_REGION=cn-north-1 \
  -e AWS_ACCESS_KEY_ID=your_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret \
  -e BACKUP_CRON_SCHEDULE="0 * * * *" \
  leen15/docker-s3-mysql-dump

Docker Compose示例

yaml
version: '3'
services:
  mysql-backup:
    image: leen15/docker-s3-mysql-dump
    environment:
      MYSQL_HOST: mysql
      MYSQL_PASSWORD: your_mysql_password
      BACKUP_S3_BUCKET: your_bucket_name/backup
      AWS_DEFAULT_REGION: cn-north-1
      AWS_ACCESS_KEY_ID: your_key
      AWS_SECRET_ACCESS_KEY: your_secret
      BACKUP_CRON_SCHEDULE: "0 * * * *"
    volumes:
      - ./local-backup:/var/backup/mysql  # 挂载本地目录保留备份文件