hochzehn/s3cmd

s3cmd-docker

致谢

本仓库基于 https://github.com/sekka1/docker-s3cmd 修改而来，但对其工作方式进行了大量调整。

徽章

https://img.shields.io/***/url/https/github.com/hochzehn/s3cmd-docker.svg?style=social](https://***.com/intent/tweet?text=S3cmd%20in%20a%20%40Docker%20container:&url=https://github.com/hochzehn/s3cmd-docker)

镜像概述

这是一个包含 https://github.com/s3tools/s3cmd 工具的Docker容器，基于轻量的Alpine Linux构建（镜像体积约15MB）。适用于已使用Docker的环境，可直接拉取镜像，通过运行容器实现本地与S3存储之间的文件传输和管理操作。该镜像在Docker Hub上有自动化构建版本：https://hub.docker.com/r/hochzehn/s3cmd/%E3%80%82

核心功能

1. 支持本地文件/目录与S3存储桶之间的双向同步（上传、下载）
2. 可执行任意s3cmd命令
3. 通过环境变量快速配置AWS密钥
4. 基于Alpine Linux，镜像体积小，资源占用低

使用场景

• 备份本地文件或目录到S3存储
• 从S3存储下载文件或目录到本地
• 在Docker环境中执行s3cmd的其他管理操作（如列出存储桶内容、删除文件等）

配置说明

环境变量

• aws_key: AWS访问密钥（必填）
• aws_secret: AWS秘密密钥（必填）
• cmd: 执行的命令类型，可选值：sync-local-to-s3（本地到S3同步）、sync-s3-to-local（S3到本地同步）
• DEST_S3: 当cmd为sync-local-to-s3时，指定S3目标路径（如s3://your-bucket-name/）
• SRC_S3: 当cmd为sync-s3-to-local时，指定S3源路径（如s3://your-bucket-name/）

部署示例

1. 本地文件同步到S3

bash
AWS_KEY=<你的AWS密钥>
AWS_SECRET=<你的AWS秘密密钥>
BUCKET=s3://your-bucket-name/
LOCAL_FILE=/tmp/database

docker run --rm \
  --env aws_key=${AWS_KEY} \
  --env aws_secret=${AWS_SECRET} \
  --env cmd=sync-local-to-s3 \
  --env DEST_S3=${BUCKET}  \
  -v ${LOCAL_FILE}:/opt/src \
  hochzehn/s3cmd

• 将LOCAL_FILE替换为需要上传到S3的文件或目录
• 可在命令末尾添加s3cmd的额外参数，例如--delete-removed（删除S3中本地不存在的文件）

2. S3文件同步到本地

bash
AWS_KEY=<你的AWS密钥>
AWS_SECRET=<你的AWS秘密密钥>
BUCKET=s3://your-bucket-name/
LOCAL_FILE=/tmp

docker run --rm \
  --env aws_key=${AWS_KEY} \
  --env aws_secret=${AWS_SECRET} \
  --env cmd=sync-s3-to-local \
  --env SRC_S3=${BUCKET} \
  -v ${LOCAL_FILE}:/opt/dest \
  hochzehn/s3cmd

• 将LOCAL_FILE替换为接收S3文件的本地目录
• 可添加额外参数，如--delete-removed（删除本地中S3不存在的文件）

3. 执行任意s3cmd命令

bash
AWS_KEY=<你的AWS密钥>
AWS_SECRET=<你的AWS秘密密钥>

docker run --rm \
  --env aws_key=${AWS_KEY} \
  --env aws_secret=${AWS_SECRET} \
  hochzehn/s3cmd \
  ls 

• 替换ls为任意s3cmd命令（如mb s3://new-bucket创建存储桶）