d3fk/s3cmd

s3cmd (Angatar> d3fk/s3cmd)

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

Docker镜像

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

• 镜像名称：d3fk/s3cmd

docker pull d3fk/s3cmd

Docker Hub仓库：https://hub.docker.com/r/d3fk/s3cmd/

镜像标签（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的自动构建节点构建。当https://github.com/Angatar/s3cmd%E5%8F%91%E7%94%9F%E5%8F%98%E6%9B%B4%E6%88%96%E6%AF%8F%E5%91%A8%E4%B8%80%E6%AC%A1%E6%97%B6%E8%A7%A6%E5%8F%91%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%9B%A0%E6%AD%A4%E4%BD%BF%E7%94%A8d3fk/s3cmd:latest%E9%95%9C%E5%83%8F%E5%8F%AF%E7%A1%AE%E4%BF%9D%E8%8E%B7%E5%8F%96**%E6%9C%80%E6%96%B0%E6%9B%B4%E6%96%B0%EF%BC%88%E5%8C%85%E6%8B%AC%E5%AE%89%E5%85%A8%E4%BF%AE%E5%A4%8D%EF%BC%89%E4%B8%94%E5%8A%9F%E8%83%BD%E6%AD%A3%E5%B8%B8**%E7%9A%84s3cmd%E8%BD%BB%E9%87%8F%E7%BA%A7Alpine%E9%95%9C%E5%83%8F%E7%89%88%E6%9C%AC%E3%80%82

--- Stable ---

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

• d3fk/s3cmd:arch-stable-gpg：多架构镜像，包含固定版本，支持GPG用于客户端加密。基于Alpine Linux v3.21，包含s3cmd S3客户端版本2.4.0和GPG版本2.4.7。未来不会更改或重建（代码可从https://github.com/Angatar/s3cmd%E8%8E%B7%E5%8F%96%EF%BC%89%E3%80%82

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

• d3fk/s3cmd:arch-stable：多架构镜像，包含固定版本。基于Alpine Linux v3.17，包含s3cmd S3客户端版本2.3.0。在生产环境中表现稳定，已冻结为代码仓库的发布版本并通过Docker Hub自动构建，未来不会更改或重建（代码可从https://github.com/Angatar/s3cmd%E8%8E%B7%E5%8F%96%EF%BC%89%E3%80%82

sh
$ docker pull d3fk/s3cmd:arch-stable

• d3fk/s3cmd:stable：历史初始稳定版本，仅支持amd64架构（初始版本未推送为多架构镜像）。基于Alpine Linux v3.14，包含s3cmd S3客户端版本2.2.0。在生产环境中表现稳定，已冻结为代码仓库的发布版本并通过Docker Hub自动构建，未来不会更改或重建（代码可从https://github.com/Angatar/s3cmd%E8%8E%B7%E5%8F%96%EF%BC%89%E3%80%82

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

若需从头手动配置，源代码仓库的https://github.com/Angatar/s3cmd/tree/master/.s3%E6%8F%90%E4%BE%9B%E7%A9%BA%E7%99%BD.s3cfg%E6%A8%A1%E6%9D%BF%E6%96%87%E4%BB%B6%E3%80%82

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兼容对象存储，建议使用https://hub.docker.com/r/d3fk/mysql-s3-backup%EF%BC%8C%E8%AF%A5%E9%95%9C%E5%83%8F%E5%90%8C%E6%A0%B7%E5%9F%BA%E4%BA%8EAlpine%EF%BC%8C%E9%99%A4s3cmd%E5%B7%A5%E5%85%B7%E5%A4%96%E8%BF%98%E5%8C%85%E5%90%ABMySQL%E5%AE%A2%E6%88%B7%E7%AB%AF%E3%80%82

许可证

https://github.com/Angatar/s3cmd%E5%86%85%E5%AE%B9%E5%9F%BA%E4%BA%8E**MIT**%E8%AE%B8%E5%8F%AF%E8%AF%81%E6%8F%90%E4%BE%9B!%5BGitHub license](https://github.com/Angatar/s3cmd/blob/master/LICENSE)%E3%80%82s3cmd%E8%87%AA%E8%BA%AB%E8%AE%B8%E5%8F%AF%E8%AF%81%E8%AF%A6%E8%A7%81https://github.com/s3tools/s3cmd%E3%80%82