robostlund/rclone-sync

docker-rclone

镜像概述和主要用途

Docker镜像，用于基于cron调度执行rclone同步操作，并集成healthchecks.io监控功能。rclone是一个命令行工具，可在以下存储服务之间同步文件和目录：

• Google Drive
• Amazon S3
• Openstack Swift / Rackspace云文件 / Memset Memstore
• Dropbox
• Google Cloud Storage
• Amazon Drive
• Microsoft OneDrive
• Hubic
• Backblaze B2
• Yandex Disk
• SFTP
• FTP
• HTTP
• 本地文件系统

核心功能和特性

• 定时同步：通过cron调度配置同步频率
• 监控集成：支持healthchecks.io，同步成功后执行GET请求
• 配置持久化：通过挂载卷持久化rclone配置文件
• 启动强制同步：可配置容器启动时立即执行同步
• 同步中止：支持配置cron任务在指定时间中止同步
• 时区设置：可自定义时区，确保cron任务和日志时间准确
• 自定义选项：支持传递额外的rclone sync参数

使用场景和适用范围

• 定期将本地文件备份到云存储服务（如Google Drive、Amazon S3）
• 在不同云存储服务之间自动同步数据
• 自动化服务器数据迁移或复制
• 需要定时执行且需监控的文件同步任务

详细使用方法和配置说明

配置rclone

rclone需要配置文件存储访问不同存储服务的凭证。默认情况下，此镜像使用/config/rclone.conf文件，可通过挂载卷持久化该配置。

可通过首次运行容器创建配置文件，也可手动创建：

bash
$ mkdir config
$ docker run --rm -it -v $(pwd)/config:/config robostlund/rclone-sync

执行每日同步

通过环境变量可自定义同步行为：

• SYNC_SRC：rclone sync命令的源路径
• SYNC_DEST：rclone sync命令的目标路径
• CRON：cron调度表达式，如0 0 * * *表示每天午夜执行同步
• CRON_ABORT：cron调度表达式，如0 6 * * *表示每天6点中止同步
• FORCE_SYNC：设置该变量可在容器启动时执行同步
• CHECK_URL：healthchecks.io或类似cron监控服务的URL，同步成功后执行GET请求
• SYNC_OPTS：rclone sync命令的额外选项，默认为-v（详细输出）
• TZ：时区设置，如America/Argentina/Buenos_Aires，用于cron任务和日志时间

Docker运行示例

bash
$ docker run --rm -it \
  -v $(pwd)/config:/config \
  -v /path/to/source:/source \
  -e SYNC_SRC="/source" \
  -e SYNC_DEST="dest:path" \
  -e TZ="America/Argentina/Buenos_Aires" \
  -e CRON="0 0 * * *" \
  -e CRON_ABORT="0 6 * * *" \
  -e FORCE_SYNC=1 \
  -e CHECK_URL=https://hchk.io/hchk_uuid \
  robinostlund/rclone-sync

有关源/目标路径语法及额外选项，参见rclone sync文档。