ogivuk/rsync

rsync

rsync是一款开源工具，提供快速的增量文件传输功能。本镜像将rsync容器化，便于在集群可视化工具中管理进程，遵循无状态、不可变容器的最佳实践。

核心功能

• 执行一次性本地目录同步任务
• 通过ssh（镜像内置）实现远程目录同步
• 使用cron（镜像内置）调度定时同步任务

支持架构

• 多架构支持：x86-64、arm32
• 采用Docker Manifest实现多平台感知，拉取ogivuk/rsync:latest时将自动匹配对应架构

镜像包含工具

• rsync：核心同步工具
• openssh-client：远程ssh同步支持
• tzdata：时区设置（确保文件时间戳准确）
• cron：定时任务调度
• rsync.sh：配置cron任务并启动守护进程的脚本

使用场景

• 本地文件备份与同步
• 跨服务器远程文件同步
• 定时自动备份任务

配置说明

快速开始：一次性本地同步

bash
docker run --rm \
    --name=rsync \
    --volume /本地源目录:/data/src \
    --volume /本地目标目录:/data/dst \
    ogivuk/rsync [参数] /data/src/ /data/dst/

替换说明：

• /本地源目录：需同步的源文件夹路径
• /本地目标目录：同步目标文件夹路径
• [参数]：rsync可选参数（如-avz）

定时任务或远程同步（ssh）

步骤1：准备目录（首次使用）

创建本地目录存储配置文件、日志等：

bash
mkdir -p ~/rsync/logs

• ~/rsync：挂载到容器的目录，可替换为其他路径
• ~/rsync/logs：日志存储目录（Docker Swarm需确保所有节点可访问此目录）

步骤2：启动容器

普通容器模式

bash
docker run --rm \
    --name=rsync \
    --env TZ="Asia/Shanghai" \
    --env RSYNC_CRONTAB="crontab" \
    --volume ~/rsync:/rsync \
    --volume /本地源目录:/data/src \
    --volume /本地目标目录:/data/dst \
    ogivuk/rsync

Docker Swarm服务模式

bash
docker service create \
    --name=rsync \
    --env TZ="Asia/Shanghai" \
    --env RSYNC_CRONTAB="crontab" \
    --mount type=bind,src=~/rsync,dst=/rsync \
    --mount type=bind,src=/本地源目录,dst=/data/src \
    --mount type=bind,src=/本地目标目录,dst=/data/dst \
    ogivuk/rsync

参数说明

注意事项

• 需在crontab文件中明确rsync命令及参数（默认不自动执行）
• 修改crontab后需重启容器生效，建议将同步逻辑写在脚本中并在crontab调用
• 远程ssh同步需将私钥、known_hosts等文件放在~/rsync/ssh/目录，使用-e "ssh -F /rsync/ssh/ssh_config"指定配置
• 可绑定多个目录满足复杂同步需求