tgbyte/mydumper Docker 镜像 - 轩辕镜像

MySQL 每小时备份镜像（基于mydumper）

镜像概述与主要用途

本镜像是一个基于mydumper工具的自动化MySQL备份解决方案，专注于每小时定时执行MySQL数据库备份任务。mydumper是一款高性能的MySQL备份工具，相比传统mysqldump具有多线程导出能力，可显著提升备份效率。该镜像旨在简化MySQL数据库的定时备份流程，通过容器化方式提供开箱即用的自动化备份能力，适用于需要定期、可靠备份MySQL数据的环境。

核心功能与特性

• 高效备份性能：基于mydumper实现多线程数据导出，备份速度优于传统mysqldump，适合中小规模数据库高效备份
• 定时自动执行：默认每小时触发一次备份任务，无需手动干预，实现全自动化备份流程
• 灵活配置选项：支持通过环境变量自定义数据库连接参数、备份保留策略、备份文件命名规则等
• 备份管理支持：可配置备份文件保留天数，自动清理过期备份，节省存储空间
• 广泛兼容性：支持MySQL 5.5+、MariaDB等兼容MySQL协议的数据库系统
• 轻量级设计：基于精简基础镜像构建，容器体积小，资源占用低

使用场景与适用范围

• 中小规模MySQL数据库：适用于数据量在GB级别以下的MySQL/MariaDB数据库日常备份
• 自动化备份需求：需要无需人工干预、按固定周期（每小时）执行备份的场景
• 开发/测试环境：为开发或测试环境提供便捷的定时数据备份，保障数据可恢复性
• 轻量级部署环境：适合在Docker容器化环境中快速部署，无需复杂的备份脚本配置
• 需要备份历史管理：需要自动清理旧备份、控制备份存储占用的场景

使用方法与配置说明

前提条件

• 已安装Docker环境（Docker 19.03+推荐）
• 目标MySQL数据库可通过网络访问，且备份用户具备足够权限（SELECT、SHOW VIEW、RELOAD、LOCK TABLES权限）

Docker Run 命令示例

bash
docker run -d \
  --name mysql-hourly-backup \
  -e MYSQL_HOST=mysql-server \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USER=backupuser \
  -e MYSQL_PASSWORD=strongpassword \
  -e MYSQL_DATABASE=appdb,userdb \  # 多个数据库用逗号分隔，不指定则备份所有数据库
  -e BACKUP_RETENTION_DAYS=7 \      # 备份保留7天
  -e TZ=Asia/Shanghai \             # 设置时区，确保定时任务时间准确
  -v /host/backup/path:/backup \    # 将容器内备份目录挂载到宿主机
  mysql-hourly-backup:latest

Docker Compose 配置示例

yaml
version: '3'
services:
  mysql-backup:
    image: mysql-hourly-backup:latest
    container_name: mysql-hourly-backup
    environment:
      - MYSQL_HOST=mysql-server
      - MYSQL_PORT=3306
      - MYSQL_USER=backupuser
      - MYSQL_PASSWORD=strongpassword
      - MYSQL_DATABASE=appdb  # 单个数据库
      - BACKUP_RETENTION_DAYS=3
      - TZ=Asia/Shanghai
      - BACKUP_PREFIX=mysql_backup_  # 备份文件前缀
    volumes:
      - /data/mysql/backups:/backup
    restart: unless-stopped

配置参数说明

备份文件说明

备份文件默认存储在容器内BACKUP_PATH目录下，命名格式为：
${BACKUP_PREFIX}${YYYYMMDD}_${HHMMSS}.sql.gz（若启用压缩）或.sql（未压缩）

示例：mysql_backup_20240520_***.sql.gz（2024年5月20日14:00的备份）

注意事项

• 确保MYSQL_USER具备足够权限，否则可能导致备份失败
• 备份存储目录（宿主机挂载路径）需有足够存储空间，避免备份失败
• 首次运行时建议手动触发一次备份验证配置是否正确（可通过docker exec -it <容器名> /backup.sh执行）
• 对于超大规模数据库（100GB+），建议评估mydumper性能及备份时间是否适配每小时周期
• 生产环境建议结合备份校验机制（如定期测试恢复）确保备份可用性