metala/digitalocean-s3cmd

metala/digitalocean-s3cmd

这是一个容器化的s3cmd工具，专门用于与DigitalOcean Spaces（兼容AWS S3 API的云存储服务）进行交互，简化云存储的文件管理操作。

配置选项

环境变量

• DATACENTER_REGION：DigitalOcean数据中心区域标识（如AMS3）
• ACCESS_KEY：DigitalOcean API访问密钥
• SECRET_KEY：DigitalOcean API秘密密钥
• ENCRYPTION_PASSWORD：s3cmd使用的GPG加密密码（可选）

卷

• /local/path:/mnt：将本地路径挂载到容器内的/mnt目录，用于本地文件与云存储的同步

快速开始

通过环境变量传递凭证

bash
docker run --rm -e 'DATACENTER_REGION=AMS3' -e 'ACCESS_KEY=<你的访问密钥>' -e 'SECRET_KEY=<你的秘密密钥>' metala/digitalocean-s3cmd ls s3://bucket-name/

通过命令行参数传递凭证

bash
docker run --rm -e 'DATACENTER_REGION=AMS3' metala/digitalocean-s3cmd --access_key=<你的访问密钥> --secret_key=<你的秘密密钥> ls s3://bucket-name/

完全通过命令行参数配置

bash
docker run --rm metala/digitalocean-s3cmd --host=ams3.digitaloceanspaces.com --host-bucket="%(bucket)s.ams3.digitaloceanspaces.com" --access_key=<你的访问密钥> --secret_key=<你的秘密密钥> ls s3://bucket-name

同步本地文件到云存储

容器默认工作目录为/mnt，可通过卷挂载本地路径实现同步。首先创建s3cmd.env文件存储环境变量：

env
DATACENTER_REGION=AMS3
ACCESS_KEY=<你的访问密钥>
SECRET_KEY=<你的秘密密钥>

执行同步命令：

bash
docker run --rm --env-file s3cmd.env -v /local/path/to/sync:/mnt metala/digitalocean-s3cmd sync ./ s3://bucket-name/prefix-directory/

参考文档

有关s3cmd的完整使用说明，请访问s3cmd官方文档。