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

s3cmd (Angatar> d3fk/s3cmd)

这是一个Docker多架构镜像，包含基于最新Alpine容器的简单s3cmd S3客户端，适用于任何S3兼容的对象存储系统。

Docker镜像

通过Docker Hub的“自动构建”选项预构建为多架构镜像。

• 镜像名称：d3fk/s3cmd

docker pull d3fk/s3cmd

Docker Hub仓库：[***]

![DockerHub Badge]([***]

镜像标签（TAGS）

“d3fk/s3cmd:latest”、“d3fk/s3cmd:arch-stable-gpg”和“d3fk/s3cmd:arch-stable”均为多架构镜像。

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

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

--- Latest ---

• d3fk/s3cmd:latest 作为多架构镜像，由Docker Hub的自动构建节点构建。当镜像代码仓库发生变更或每周一次时触发自动构建，因此使用d3fk/s3cmd:latest镜像可确保获取最新更新（包括安全修复）且功能正常的s3cmd轻量级Alpine镜像版本。

--- Stable ---

若需固定版本以避免行为变更，Docker Hub还提供以下3个稳定镜像：

• d3fk/s3cmd:arch-stable-gpg：多架构镜像，包含固定版本，支持GPG用于客户端加密。基于Alpine Linux v3.21，包含s3cmd S3客户端版本2.4.0和GPG版本2.4.7。未来不会更改或重建（代码可从镜像代码仓库的“releases”部分获取）。

sh
$ docker pull d3fk/s3cmd:arch-stable-gpg

• d3fk/s3cmd:arch-stable：多架构镜像，包含固定版本。基于Alpine Linux v3.17，包含s3cmd S3客户端版本2.3.0。在生产环境中表现稳定，已冻结为代码仓库的发布版本并通过Docker Hub自动构建，未来不会更改或重建（代码可从镜像代码仓库的“releases”部分获取）。

sh
$ docker pull d3fk/s3cmd:arch-stable

• d3fk/s3cmd:stable：历史初始稳定版本，仅支持amd64架构（初始版本未推送为多架构镜像）。基于Alpine Linux v3.14，包含s3cmd S3客户端版本2.2.0。在生产环境中表现稳定，已冻结为代码仓库的发布版本并通过Docker Hub自动构建，未来不会更改或重建（代码可从镜像代码仓库的“releases”部分获取）。

sh
$ docker pull d3fk/s3cmd:stable

基本用法

sh
docker run --rm -v $(pwd):/s3 -v $HOME/.s3:/root d3fk/s3cmd sync . s3://bucket-name

第一个卷将当前目录用作工作目录，第二个卷用于S3连接的配置。

s3cmd设置

该镜像使用.s3cfg配置文件。若本地已使用s3cmd，上述命令将使用$HOME/.s3/.s3cfg中的现有配置文件。若未本地使用s3cmd或不想使用本地配置，可通过以下命令生成.s3cfg文件：

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

若需从头手动配置，源代码仓库的.s3目录提供空白.s3cfg模板文件。

s3cmd与加密

s3cmd支持通过配置文件或命令行选项启用传输过程中的SSL加密。还支持静态加密：使用--server-side-encryption标志启用服务器端加密（如指定服务器上的KMS密钥），或使用-e/--encrypt标志启用客户端加密。这些选项也可在.s3cfg配置文件中定义。

s3cmd完整文档

详见s3tools***文档。

Kubernetes自动定期备份

该容器适用于K8s CRONJOB。可使用提供的s3-backup-cronjob.yaml文件作为CRONJOB模板。通过以下kubectl命令从.s3cfg配置文件创建configmap：

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

配置数据卷/路径和存储桶（通过补全文件或定义环境变量：YOUR_KMS_KEY_ID、YOUR_BUCKET_NAME、NFS_SERVER、SHARED-FOLDER）后，通过以下命令创建K8s CRONJOB：

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

注：sync命令的--no-check-md5选项通过仅比较文件大小加速同步，但可能遗漏变更文件。在使用服务器端加密时，该选项尤为实用，因存储桶中加密文件的md5签名与待备份的非加密文件不同。

s3cmd与MySQL备份

若需将数据库转储存储到S3兼容对象存储，建议使用d3fk/mysql-s3-backup，该镜像同样基于Alpine，除s3cmd工具外还包含MySQL客户端。

许可证

GitHub代码仓库内容基于MIT许可证提供![GitHub license]([***]