热门搜索:
zappi/s3-sync
zappi
同步容器本地目录与AWS S3存储桶，支持文件上传、下载、实时监控及定期同步，适用于数据备份与节点间数据同步。
下载次数: 0状态：社区镜像维护者：zappi仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
S3 Sync
https://github.com/Intellection/docker-s3-sync/actions/workflows/release.yml/badge.svg](https://github.com/Intellection/docker-s3-sync/actions/workflows/release.yml) https://github.com/Intellection/docker-s3-sync/actions/workflows/test.yml/badge.svg](https://github.com/Intellection/docker-s3-sync/actions/workflows/test.yml)
此Docker容器可将本地目录同步到AWS S3存储桶，便于数据备份和同步。
若指定的本地目录为空，容器会先从指定的S3存储桶执行初始同步，然后将该目录与S3存储桶保持同步；若本地目录非空，则跳过初始同步。
该容器适用于在S3中创建数据的最新备份副本，以便启动新节点时轻松检索。
注意：此容器设计用于从单个节点向S3同步文件，不推荐作为永久备份解决方案。
默认情况下，容器内的下载位置为/sync，可通过SYNCDIR环境变量修改。
命令
该镜像支持以下命令：
download：（默认）下载文件后退出upload：上传文件后退出sync：使用inotify监控文件变化，当文件更改时将目录上传至S3（见SYNCDIR）periodic_upload：设置定时任务定期将文件上传至S3（见CRON_TIME和INITIAL_DOWNLOAD）periodic_download：设置定时任务定期从S3下载文件（见CRON_TIME和INITIAL_DOWNLOAD）
环境变量
| 环境变量 | 是否必填 | 描述 |
|---|---|---|
| AWS_ACCESS_KEY_ID | 是 | （或有效的IAM角色） |
| AWS_SECRET_ACCESS_KEY | 是 | （或有效的IAM角色） |
| AWS_DEFAULT_REGION | 是 | （或有效的IAM角色） |
| S3PATH | 是 | S3同步位置（例如：s3://mybucket/myprefix） |
| SYNCDIR | 是 | 本地同步位置（必须可被s3sync用户写入） |
| AWS_S3_SSE | 否 | 使用S3服务器端加密；可选值：false（不加密）、aes256或true（使用S3托管密钥的服务器端加密，SSE-S3）、kms（使用AWS KMS托管密钥的服务器端加密，SSE-KMS）（默认值：false）。更多信息参见<[***]>（注意：目前不支持使用客户提供密钥的服务器端加密（SSE-C）） |
| AWS_S3_SSE_KMS_KEY_ID | 否 | 用于S3对象服务器端加密的AWS KMS密钥ID（仅在与AWS_S3_SSE配合使用时有效） |
| CRON_TIME | 否 | 有效的cron表达式（例如：CRON_TIME='0 */6 * * *'表示每6小时运行一次；默认每小时运行） |
| INITIAL_DOWNLOAD | 否 | 是否初始下载文件（默认值：true）；仅当目录为空时才下载文件。设置为force可跳过此检查 |
| SYNCEXTRA | 否 | 为aws-cli sync命令添加额外选项 |
使用方法
下载文件并退出
consoledocker run --rm \ -e S3PATH='s3://mybucket/myprefix' \ zappi/s3sync
上传文件并退出
consoledocker run --rm \ -e S3PATH='s3://mybucket/myprefix' \ zappi/s3sync upload
定期上传文件（每6小时）
consoledocker run -d \ -e S3PATH='s3://mybucket/myprefix' \ -e CRON_TIME='0 */6 * * *' \ zappi/s3sync cron
监控本地目录
consoledocker run -d \ -e S3PATH='s3://mybucket/myprefix' \ zappi/s3sync sync
监控指定本地目录（主机挂载）
consoledocker run -d \ -e S3PATH='s3://mybucket/myprefix' \ -e SYNCDIR='/mydir' \ -v $(pwd):/mydir \ zappi/s3sync sync
外部AWS凭证
consoledocker run -d \ -e S3PATH='s3://mybucket/myprefix' \ -v ~/.aws:/root/.aws:ro \ zappi/s3sync
注意：
- “下载文件并退出”命令中的
--rm标志会在容器退出后删除容器，避免堆积已停止的容器。 - “上传文件并退出”命令中的
upload参数指示容器在退出前上传文件。 - “监控指定本地目录（主机挂载）”命令中，
$(pwd)用于指定当前目录作为同步目录。根据实际需求修改为相应目录。
credits
此镜像很大程度上基于@vladgh的https://github.com/vladgh/docker_base_images/blob/main/s3sync%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E3%80%82
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull zappi/s3-sync:<标签>
更多 s3-sync 镜像推荐
justonecommand/s3-sync
justonecommand
Concourse CI的资源镜像，用于在流水线中通过AWS CLI的s3 sync命令上传或下载多个文件到S3存储桶，支持角色凭证、路径指定及过滤选项。
100万+ 次下载
6 年前更新
plugins/s3-sync
plugins
Drone CI的S3同步插件，用于在CI/CD流程中自动将文件同步到Amazon S3存储桶，支持配置同步源、目标及相关参数，由drone-plugins管理并通过Drone CI构建。
100万+ 次下载
3 年前更新
scaleoutsystems/s3-sync
scaleoutsystems
暂无描述
10万+ 次下载
6 年前更新
lehneres/s3-sync
lehneres
暂无描述
5万+ 次下载
6 年前更新
skpr/s3-sync
skpr
暂无描述
5万+ 次下载
4 年前更新
kaorimatz/s3-sync
kaorimatz
用于同步本地目录与Amazon S3前缀的工具镜像，支持定时同步、一次性同步及同步后构建推送容器镜像至指定registry。
1万+ 次下载
6 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"