itsmycargo/s3sync

ItsMyCargo Docker镜像 - s3sync

镜像概述

itsmycargo/s3sync是ItsMyCargo Docker镜像仓库中的工具镜像，旨在实现本地目录与AWS S3 Bucket目录间的文件同步，帮助用户便捷维护本地与云存储的数据一致性。

核心功能

• 支持本地与S3 Bucket的单向/双向同步
• 可配置同步频率（定时或实时）
• 自动处理文件增删改操作，保持数据一致
• 支持S3访问权限配置，保障数据安全

使用场景

1. 云备份：将本地重要文件定期同步至S3 Bucket，实现数据备份
2. 多环境同步：跨开发/测试环境同步配置文件或资源文件
3. 静态资源分发：同步本地静态资源至S3，用于CDN加速或公网访问

配置说明

需通过环境变量配置以下核心参数：

• AWS_ACCESS_KEY_ID：AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS秘密访问密钥
• S3_BUCKET：目标S3 Bucket名称
• LOCAL_DIR：本地待同步目录路径
• SYNC_FREQUENCY：同步频率（如"5m"表示每5分钟，默认实时）
• SYNC_DIRECTION：同步方向（"local-to-s3"或"s3-to-local"，默认双向）

部署示例

Docker Run命令

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e S3_BUCKET=your_bucket_name \
  -e LOCAL_DIR=/path/to/local/dir \
  -v /path/to/local/dir:/path/to/local/dir \
  itsmycargo/s3sync

Docker Compose配置

yaml
version: '3'
services:
  s3sync:
    image: itsmycargo/s3sync
    environment:
      - AWS_ACCESS_KEY_ID=your_access_key
      - AWS_SECRET_ACCESS_KEY=your_secret_key
      - S3_BUCKET=your_bucket_name
      - LOCAL_DIR=/app/data
      - SYNC_FREQUENCY=10m
      - SYNC_DIRECTION=local-to-s3
    volumes:
      - ./data:/app/data