avides/mysql-s3-backup
avides
用于备份MySQL服务器数据，将每个表单独压缩为sql.gz文件并按指定cron表达式自动上传到Amazon S3的Docker镜像
下载次数: 0状态：社区镜像维护者：avides仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
mysql-s3-backup
镜像概述和主要用途
该Docker镜像用于备份MySQL服务器数据，将每个表单独导出为SQL文件并压缩为.gz格式，然后通过指定的cron表达式定时自动上传到Amazon S3存储。适用于需要定期备份MySQL数据并安全存储到云端的场景。
核心功能和特性
- 定时备份：通过cron表达式配置备份执行时间（UTC时区）
- 独立文件：为每个表生成单独的sql.gz压缩文件，便于选择性恢复
- S3集成：自动将备份文件上传到指定的Amazon S3 bucket
- 监控指标：提供HTTP端点暴露备份相关指标，支持监控备份状态、文件大小和执行时间
使用场景和适用范围
- 生产环境MySQL数据库的定期自动备份
- 需要将数据库备份存储到Amazon S3的场景
- 需监控备份状态和性能的企业级应用
- 兼容MySQL 5.7及以上版本的数据库系统
使用方法和配置说明
环境变量说明
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| CRON_EXPR | 备份执行的cron表达式（UTC时区） | 无 |
| S3_BUCKET_NAME | Amazon S3 bucket名称 | 无 |
| S3_ACCESS_KEY | AWS访问密钥 | 无 |
| S3_SECRET_KEY | AWS密钥 | 无 |
| S3_REGION | AWS区域 | 无 |
| MYSQL_HOST | MySQL服务器主机地址 | 无 |
| MYSQL_HOST_ALIAS | MySQL主机别名 | ${MYSQL_HOST} |
| MYSQL_PORT | MySQL服务器端口 | 3306 |
| MYSQL_BACKUP_USER | 用于备份的MySQL用户名 | root |
| MYSQL_BACKUP_PASS | 用于备份的MySQL用户密码 | 无 |
Docker部署示例
在Docker服务器上设置环境变量后，执行以下命令启动容器：
bashdocker run \ -d \ --name=mysql-s3-backup \ --env CRON_EXPR="0 18 * * * (说明：UTC时区)" \ --env S3_BUCKET_NAME="AWS_BUCKET_NAME" \ --env S3_ACCESS_KEY="AWS_ACCESS_KEY" \ --env S3_SECRET_KEY="AWS_SECRET_KEY" \ --env S3_REGION="AWS_REGION" \ --env MYSQL_HOST="MYSQL_HOST" \ --env MYSQL_HOST_ALIAS="MYSQL_HOST_ALIAS (默认：${MYSQL_HOST})" \ --env MYSQL_PORT="MYSQL_PORT (默认：3306)" \ --env MYSQL_BACKUP_USER="root" \ --env MYSQL_BACKUP_PASS="MYSQL_BACKUP_PASS" \ -p 9300:9300 \ avides/mysql-s3-backup:2.5.0
构建与测试
以下命令适用于本地开发和测试：
构建镜像
bashdocker build -t mysql-s3-backup-dev .
运行开发镜像
bashdocker run \ -d \ --name=mysql-s3-backup \ --env CRON_EXPR="0 18 * * * (说明：UTC时区)" \ --env S3_BUCKET_NAME="AWS_BUCKET_NAME" \ --env S3_ACCESS_KEY="AWS_ACCESS_KEY" \ --env S3_SECRET_KEY="AWS_SECRET_KEY" \ --env S3_REGION="AWS_REGION" \ --env MYSQL_HOST_ALIAS="MYSQL_HOST_ALIAS (默认：${MYSQL_HOST})" \ --env MYSQL_HOST="MYSQL_HOST" \ --env MYSQL_PORT="MYSQL_PORT (默认：3306)" \ --env MYSQL_BACKUP_USER="root" \ --env MYSQL_BACKUP_PASS="MYSQL_BACKUP_PASS" \ -p 9300:9300 \ mysql-s3-backup-dev
查看日志
bashdocker logs -f mysql-s3-backup
进入容器
bashdocker exec -it mysql-s3-backup /bin/bash
监控指标
容器提供备份相关指标，可通过HTTP端点/metrics在9300端口访问。收集的指标如下：
| 指标名称 | 数据类型 | 描述 |
|---|---|---|
| mysql_s3_backup_successful | gauge | 备份状态（1=成功 / 0=失败） |
| mysql_s3_backup_start_timestamp | gauge | 备份开始时间戳（毫秒） |
| mysql_s3_backup_file_size_in_bytes{database="数据库名", table="表名"} | gauge | 备份文件大小（字节） |
| mysql_s3_backup_duration_in_ms{database="数据库名", table="表名"} | gauge | 备份执行时间（毫秒） |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 mysql-s3-backup 镜像标签
docker pull docker.xuanyuan.run/avides/mysql-s3-backup:<标签>
DockerHub 原生拉取命令
docker pull avides/mysql-s3-backup:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"