schickling/mysql-backup-s3

mysql-backup-s3

镜像概述和主要用途

将MySQL数据库备份到S3存储（支持定期备份和多文件备份）

核心功能和特性

• 支持将MySQL数据库备份到AWS S3或兼容S3的存储服务（如minio）
• 可配置定期自动备份
• 支持单文件备份或按数据库分多个文件备份
• 可自定义mysqldump选项和备份文件路径

使用场景和适用范围

• 需要定期备份MySQL数据库并存储到S3的场景
• 希望将数据库备份与云存储集成的应用
• 需要灵活配置备份策略（如备份频率、文件命名、数据库选择）的用户

使用方法和配置说明

基本用法

sh
$ docker run -e S3_ACCESS_KEY_ID=密钥 -e S3_SECRET_ACCESS_KEY=密钥 -e S3_BUCKET=我的存储桶 -e S3_PREFIX=备份 -e MYSQL_USER=用户 -e MYSQL_PASSWORD=密码 -e MYSQL_HOST=localhost schickling/mysql-backup-s3

环境变量

• MYSQLDUMP_OPTIONS：mysqldump选项（默认值：--quote-names --quick --add-drop-table --add-locks --allow-keywords --disable-keys --extended-insert --single-transaction --create-options --comments --net_buffer_length=***）
• MYSQLDUMP_DATABASE：要备份的数据库列表（默认值：--all-databases）
• MYSQL_HOST：MySQL主机地址 必填
• MYSQL_PORT：MySQL端口（默认值：3306）
• MYSQL_USER：MySQL用户名 必填
• MYSQL_PASSWORD：MySQL密码 必填
• S3_ACCESS_KEY_ID：AWS访问密钥 必填
• S3_SECRET_ACCESS_KEY：AWS密钥 必填
• S3_BUCKET：AWS S3存储桶路径 必填
• S3_PREFIX：存储桶中的路径前缀（默认值：'backup'）
• S3_FILENAME：用于覆盖备份的固定文件名。如果未设置，将使用时间戳。
• S3_REGION：AWS S3存储桶区域（默认值：us-west-1）
• S3_ENDPOINT：AWS端点URL，用于兼容S3的API（如minio）（默认值：无）
• S3_S3V4：设置为yes以启用AWS Signature Version 4，minio服务器需要此设置（默认值：no）
• MULTI_FILES：设置为yes时允许每个数据库一个文件（默认值：no）
• SCHEDULE：备份调度时间，详见下文说明

自动定期备份

您可以额外设置SCHEDULE环境变量，例如-e SCHEDULE="@daily"，以自动运行备份。

有关调度的更多信息，请参见此处。