jaaaco/mysql-s3-backup-restore

MySQL S3备份与恢复容器

该Docker镜像用于将MySQL数据库备份至AWS S3存储桶，并支持从S3恢复数据，提供定时（cron模式）和手动（等待模式）两种操作方式。

核心功能

1. 定时备份：默认模式下，根据CRON_SCHEDULE环境变量设置的频率自动执行备份
2. 手动操作：等待模式下，可通过docker exec命令手动触发备份或恢复
3. S3版本管理：建议开启S3桶版本控制，结合生命周期规则保留历史备份

使用场景

• 需要定期备份MySQL数据库到云端存储的场景（如网站数据库、应用数据备份）
• 需手动触发备份或恢复操作的应急场景

配置说明

环境变量

• 必填变量：
  • AWS_ACCESS_KEY_ID：拥有S3读写权限的AWS用户密钥ID
  • AWS_SECRET_ACCESS_KEY：对应AWS用户的密钥
  • S3BUCKET：存储备份的S3桶名称
• 可选变量：
  • FILEPREFIX：备份文件前缀，默认值为"backup"
  • CRON_SCHEDULE：定时备份规则，默认值为"3 3 * * *"（每日3:03执行）
  • MYSQL_HOST：MySQL数据库地址，默认值为"mysql"
  • MYSQL_USER：MySQL用户名，默认值为"root"
  • MYSQL_PASSWORD：MySQL密码，默认值为"password"

操作命令

• 备份命令：docker exec -it <container-id> backup
• 恢复命令：docker exec -it <container-id> restore

部署示例（docker-compose.yml）

yaml
version: '3.3'
services:
  app:
    image: wordpress
    environment:
      WORDPRESS_DB_HOST: mysql
      WORDPRESS_DB_PASSWORD: password
  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: password
  mysql-backup:
    image: jaaaco/mysql-s3-backup-restore
    environment:
      FILEPREFIX: wordpress/default
      S3BUCKET: <你的S3桶名称>
      AWS_ACCESS_KEY_ID: <你的AWS密钥ID>
      AWS_SECRET_ACCESS_KEY: <你的AWS密钥>
    depends_on:
      - mysql