dsteinkopf/backup-all-mysql

镜像概述

该镜像用于定期备份MySQL数据库，通过链接名为“mysql”的数据库容器，将所有数据库备份文件存储到/var/dbdumps卷中，支持自定义备份策略和安全配置。

核心功能与特性

• 定期自动备份：可通过环境变量配置备份间隔时间，实现无人值守的定时备份
• 初始延迟保护：支持设置首次备份延迟，避免容器启动时立即覆盖现有备份
• 灵活的MySQL连接配置：自定义主机地址、用户名、密码等连接参数，适配不同环境
• 备份优化：默认通过管道直接压缩备份数据，减少临时文件占用的磁盘空间
• 敏感信息安全：支持从文件读取敏感配置（如密码），兼容Docker Secrets管理
• 备份状态监控：通过错误日志文件实时监控备份执行状态，便于问题排查

使用场景

适用于Docker环境中需要定期备份MySQL数据库的场景，包括单机Docker部署或Docker Swarm集群，特别适合对数据安全性要求高、需避免备份文件泄露的生产环境。

设置步骤

1. 运行镜像容器：使用dsteinkopf/backup-all-mysql镜像启动容器
2. 链接数据库：创建名为“mysql”的链接，指向需备份的MySQL数据库容器
3. 挂载备份卷：创建并挂载/var/dbdumps卷，用于存储备份文件

环境变量配置

敏感信息安全：MYSQLDUMP_ADD_OPTS、MYSQL_CONNECTION_PARAMS、MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD支持添加_FILE后缀，从文件中读取值（如MYSQL_PASSWORD_FILE=/run/secrets/mysql-pwd），适用于Docker Swarm Secrets或隐藏敏感数据。

监控备份状态

备份状态通过/var/dbdumps/errorslastrun.log文件监控：

• 文件为空表示上一次备份成功
• 文件非空则包含错误信息，指示备份失败原因
• 需定期检查文件修改时间，确认备份按预期间隔执行

使用示例

普通Docker Compose配置

yml
mysql-backup:
  image: docker.xuanyuan.run/dsteinkopf/backup-all-mysql:latest
  environment:
    - BACKUP_INTERVAL=20000  # 备份间隔（秒）
    - BACKUP_FIRSTDELAY=3600  # 首次备份延迟（秒）
    - MYSQL_USER=backupuser  # 自定义备份用户
  links:
    - mysql  # 链接到名为mysql的数据库容器
  restart: always
  volumes:
    - /opt/mysql-backups:/var/dbdumps  # 挂载备份存储卷
    - /etc/localtime:/etc/localtime  # 同步容器时间
    - /etc/timezone:/etc/timezone

Docker Swarm模式（含Secrets）

yml
version: '3.2'

services:
  backup:
    image: dsteinkopf/backup-all-mysql:latest
    environment:
      - BACKUP_INTERVAL=21600  # 6小时备份一次
      - BACKUP_FIRSTDELAY=3600  # 首次备份延迟1小时
      - MYSQL_HOST=mariadb  # 数据库主机名
      - MYSQL_ENV_MYSQL_ROOT_PASSWORD_FILE=/run/secrets/mysql-pwd  # 从Secrets读取密码
    restart: always
    volumes:
      - /opt/mysql-backups:/var/dbdumps
      - /etc/localtime:/etc/localtime
    secrets:
      - mysql-pwd  # 挂载Secrets

  mariadb:
    image: mariadb:latest
    secrets:
      - mysql-pwd
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD_FILE: /run/secrets/mysql-pwd  # 数据库使用相同Secrets

secrets:
  mysql-pwd:
    external: true  # 使用外部定义的Secrets