d3fk/mysql-s3-backup

mysql-s3-backup（Angatar> d3fk/mysql-s3-backup）

镜像概述和主要用途

这是一个多架构Docker镜像，基于最新Alpine容器，内置轻量级MySQL客户端（安装大小约4kB）用于创建数据库转储，以及s3cmd S3客户端用于与S3桶交互。适用于任何S3兼容对象存储系统存储数据库备份。MySQL客户端可与任何MySQL兼容数据库配合使用，如MySQL、MariaDB或Amazon Aurora MySQL等。容器以shell作为入口点，便于轻松组合mysqldump和s3cmd命令。

Docker镜像信息

预构建多架构镜像，支持Docker Hub"自动构建"选项。

• 镜像名称：d3fk/mysql-s3-backup
• 拉取命令：docker pull d3fk/mysql-s3-backup
• Docker Hub仓库：https://hub.docker.com/r/d3fk/mysql-s3-backup/

镜像标签

"d3fk/mysql-s3-backup:latest"、"d3fk/mysql-s3-backup:stable"和"d3fk/mysql-s3-backup:stable-gpg"均提供为多架构镜像。

这些多架构镜像支持大多数架构：

• linux/amd64
• linux/386
• linux/arm/v6
• linux/arm/v7
• linux/arm64/v8
• linux/ppc64le
• linux/s390x

latest标签

d3fk/mysql-s3-backup:latest 是多架构镜像，通过Docker Hub自动构建节点构建。每次代码仓库变更或每周触发自动构建，确保包含最新更新（包括安全修复）和功能正常的s3cmd与mysql客户端，基于轻量级Alpine镜像。

stable标签

• d3fk/mysql-s3-backup:stable-gpg：多架构镜像，不会重建，提供固定版本的客户端和GPG。适用于需要避免行为变更并需客户端GPG加密的场景。包含s3cmd 2.4.0、GPG 2.4.7和mysql-client 11.4.5，基于Alpine Linux v3.21。生产环境验证稳定，代码冻结在GitHub发布版中，未来不会变更或重建。

  sh
  docker pull d3fk/mysql-s3-backup:stable-gpg
  

• d3fk/mysql-s3-backup:stable：多架构镜像，不会重建，提供固定版本的客户端和Alpine发行版。适用于需要避免行为变更的场景。包含s3cmd 2.3.0和mysql-client 10.6.11，基于Alpine Linux v3.17。生产环境验证稳定，代码冻结在GitHub发布版中，未来不会变更或重建。

  sh
  docker pull d3fk/mysql-s3-backup:stable
  

核心功能和特性

• 多架构支持：适配多种硬件架构，满足不同环境需求
• 轻量级：基于Alpine容器，安装大小极小（MySQL客户端约4kB）
• 兼容性广：支持任何S3兼容对象存储和MySQL兼容数据库
• 灵活组合：以shell为入口点，便于组合mysqldump和s3cmd命令
• 安全选项：支持SSL传输加密及服务端/客户端存储加密

使用场景和适用范围

• 定期数据库备份到S3兼容存储
• Kubernetes环境下通过CRONJOB实现自动备份
• 需要轻量级工具链的数据库备份场景
• 需跨架构部署的备份解决方案

详细使用方法和配置说明

基本用法

sh
docker run --rm -v $(pwd):/s3 -v $HOME/.s3:/root d3fk/mysql-s3-backup sh -c 'mysqldump -h ${MYSQL_HOST:localhost} -u ${MYSQL_USER:root} --password=${MYSQL_PASSWORD:your_password} --databases ${DATABASES_NAMES:mysql}> "$(date +%F_%H)_mysqldump.sql" && s3cmd put --ssl  . s3://${BUCKET_NAME}'

卷挂载说明：

• 第一个卷-v $(pwd):/s3：将当前目录作为工作目录，可本地保留备份副本
• 第二个卷-v $HOME/.s3:/root：挂载S3配置目录，用于s3cmd配置

s3cmd设置

s3cmd使用.s3cfg配置文件。若本地已使用s3cmd，上述命令将使用$HOME/.s3/.s3cfg配置。如需生成新配置或不使用本地配置，可通过以下命令生成：

sh
mkdir .s3
docker run --rm -ti -v $(pwd):/s3 -v $(pwd)/.s3:/root d3fk/mysql-s3-backup s3cmd --configure

也可从https://github.com/Angatar/mysql-s3-backup/tree/master/.s3%E8%8E%B7%E5%8F%96%E7%A9%BA%E7%99%BD%60.s3cfg%60%E6%A8%A1%E6%9D%BF%EF%BC%8C%E6%89%8B%E5%8A%A8%E9%85%8D%E7%BD%AE%E3%80%82

s3cmd加密选项

• 传输加密：通过配置文件或命令行--ssl选项启用SSL
• 存储加密：
  • 服务端加密：使用--server-side-encryption指定KMS密钥
  • 客户端加密：使用-e或--encrypt标志

加密选项也可在.s3cfg配置文件中定义。

s3cmd完整文档

详见s3cmd官方文档。

Kubernetes自动定期备份

该容器设计用于K8s CRONJOB，可使用提供的s3-dump-cronjob.yaml作为模板。

配置步骤：

1. 创建s3cmd配置ConfigMap：

   sh
   kubectl create configmap s3config --from-file $HOME/.s3
   

2. 存储数据库凭据到Secret（推荐最佳实践）

3. 部署CRONJOB：
   配置数据卷/路径、桶信息（通过文件或环境变量：YOUR_KMS_KEY_ID、YOUR_BUCKET_NAME、MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD/secret、DATABASE_NAMES）后，执行：

   sh
   kubectl create -f s3-dump-cronjob.yaml
   

提示：启用S3桶版本控制可实现高效的版本化数据库备份系统。

其他数据备份

如需将其他数据存储到S3兼容对象存储，建议使用https://hub.docker.com/r/d3fk/s3cmd%E9%95%9C%E5%83%8F%EF%BC%8C%E5%9F%BA%E4%BA%8EAlpine%EF%BC%8C%E4%BB%85%E5%8C%85%E5%90%ABs3cmd%E5%B7%A5%E5%85%B7%EF%BC%8C%E4%BB%A5s3cmd%E4%B8%BA%E5%85%A5%E5%8F%A3%E7%82%B9%E3%80%82

许可证

GitHub代码仓库内容基于https://github.com/Angatar/mysql-s3-backup/blob/master/LICENSE%E3%80%82s3cmd%E8%AE%B8%E5%8F%AF%E8%AF%81%E8%AF%A6%E8%A7%81https://github.com/s3tools/s3cmd%E3%80%82MySQL%E5%AE%A2%E6%88%B7%E7%AB%AF%E5%8C%85%E8%AE%B8%E5%8F%AF%E8%AF%81%E8%AF%A6%E8%A7%81https://pkgs.alpinelinux.org/packages?name=mysql-client%E3%80%82