brainbitsgmbh/mysql-backup Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

MySQL Backup 镜像

镜像概述和主要用途

该镜像为MySQL和MariaDB数据库提供简单的备份策略。通过mysqldump创建备份并压缩，仅需修改一个环境变量即可切换备份或恢复模式，适用于需要定期备份数据库并自动管理备份文件的场景。

核心功能和特性

• 备份与恢复：支持通过环境变量切换备份（backup）或恢复（restore）模式
• 智能备份策略：自动区分每日（daily）和每小时（hourly）备份
• 自动清理：根据配置自动删除过期的每日备份和超出数量的每小时备份
• 灵活配置：通过环境变量自定义备份目录、保留天数/数量等参数

备份策略

镜像采用以下策略管理备份文件的创建与清理：

1. 备份类型判断：

   • 检查输出目录中是否存在当天创建的备份文件
   • 若不存在，创建“每日”备份（文件命名以daily-开头）
   • 若已存在，创建“每小时”备份（文件命名以hourly-开头）

2. 备份清理规则：

   • 每日备份：删除超过指定天数（MAX_DAILY_BACKUP_AGE）的所有每日备份文件
   • 每小时备份：仅保留指定数量（MAX_HOURLY_BACKUP_COUNT）的最新每小时备份文件

此策略确保保留最近几天的备份文件，同时维持一定数量的近期备份，避免存储过多冗余文件。

环境变量配置

以下环境变量用于配置脚本行为：

使用方法和示例

Docker Run 示例

创建备份

bash
# 创建备份，自动创建指向最新备份的`latest`链接
docker run -it --rm \
  -e "MODE=backup" \
  -e "DATABASE_DSN=mysql://MyDbUser:***/my-database" \
  -v "$(pwd)/backup:/backup" \
  brainbitsgmbh/mysql-backup:latest

恢复备份

bash
# 恢复`latest`备份
docker run -it --rm \
  -e "MODE=restore" \
  -e "DATABASE_DSN=mysql://MyDbUser:***/my-database" \
  -v "$(pwd)/backup:/backup" \
  brainbitsgmbh/mysql-backup:latest

使用场景和适用范围

• 开发环境：定期自动备份数据库，便于测试和回滚
• 生产环境：配置定时任务执行备份，确保数据安全
• 数据迁移：通过备份文件快速迁移数据库到新环境

故障排除

脚本无法连接数据库

• 确保DSN格式正确且容器内可访问数据库
• 若DSN中使用localhost，容器可能无法访问主机数据库，建议使用host.docker.internal（如示例所示）或数据库所在主机的实际IP
• 验证数据库用户权限（需有足够权限执行mysqldump和恢复操作）