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

![Docker Pulls]([] ![Docker Image Size]([] ![Docker build]([] ![Docker Stars]([] ![Github Stars]([] ![Github forks]([] ![Github open issues]([] ![Github closed issues]([] ![GitHub license]([***]

镜像概述和主要用途

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

Docker镜像信息

![Docker Image Size]([***]

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

镜像名称：d3fk/mysql-s3-backup
拉取命令：docker pull d3fk/mysql-s3-backup
Docker Hub仓库：[***]

![DockerHub Badge]([***]

镜像标签

"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

也可从源码仓库的.s3目录获取空白.s3cfg模板，手动配置。

s3cmd加密选项

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

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

s3cmd完整文档

详见s3cmd***文档。

Kubernetes自动定期备份

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

配置步骤：

创建s3cmd配置ConfigMap：

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

存储数据库凭据到Secret（推荐最佳实践）
部署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
```