lstellway/mysql-backup-s3

MySQL数据库备份到S3存储桶

sh
docker pull docker.xuanyuan.run/lstellway/mysql-backup-s3

镜像概述

本镜像旨在简化MySQL数据库到S3存储桶的备份流程，通过环境变量灵活配置数据库连接与S3存储参数，支持多数据库备份及敏感信息的文件式配置，保障数据备份的安全性与便捷性。

核心功能

• 支持指定单个或多个MySQL数据库进行备份
• 通过环境变量配置数据库连接信息（用户、密码、主机、端口）
• 支持S3存储的参数配置（协议、区域、桶名称、端点、访问密钥等）
• 允许通过文件方式提供敏感信息（数据库密码、S3访问密钥）
• 推荐使用只读权限的MySQL用户，降低数据安全风险

使用场景

• 定期自动备份MySQL数据库到S3存储桶
• 跨环境（如开发、测试、生产）的数据备份与迁移
• 需要可靠数据备份方案的业务系统

配置说明

环境变量

• BACKUP_DATABASES：需备份的数据库名称列表，以逗号分隔（用户需拥有指定数据库的访问权限）
• DB_USER：数据库用户名
• DB_PASS：数据库密码
• DB_PASS_FILE：存储数据库密码的秘密文件路径
• DB_HOST（默认值：localhost）：数据库主机地址
• DB_PORT（默认值：3306）：数据库端口
• S3_PROTOCOL（默认值：https）：连接S3服务器的协议
• S3_REGION（默认值：us-east-1）：S3服务器区域
• S3_BUCKET：S3存储桶名称
• S3_ENDPOINT：S3服务器端点
• S3_ACCESS_KEY：S3访问密钥
• S3_ACCESS_KEY_FILE：存储S3访问密钥的文件路径
• S3_ACCESS_SECRET：S3访问密钥密码
• S3_ACCESS_SECRET_FILE：存储S3访问密钥密码的文件路径

推荐实践

MySQL用户配置

建议创建仅拥有备份数据库只读权限的MySQL用户，以提升数据安全性：

mysql
CREATE USER '{{DB_USER}}'@'%' IDENTIFIED BY '{{DB_PASS}}';
GRANT LOCK TABLES, SELECT ON {{DB_NAME}}.* TO '{{DB_USER}}'@'%';

部署示例

Docker Run命令

sh
docker run -d \
  -e BACKUP_DATABASES="mydb1,mydb2" \
  -e DB_USER="backup_user" \
  -e DB_PASS="backup_password" \
  -e DB_HOST="mysql_host" \
  -e S3_BUCKET="my-backup-bucket" \
  -e S3_REGION="cn-northwest-1" \
  -e S3_ACCESS_KEY="your_access_key" \
  -e S3_ACCESS_SECRET="your_access_secret" \
  docker.xuanyuan.run/lstellway/mysql-backup-s3

资源链接

• https://github.com/lstellway/docker-mysql-backup-s3
• https://hub.docker.com/repository/docker/lstellway/mysql-backup-s3
• https://github.com/lstellway/docker-mysql-backup-s3/issues