用 rsync + cron 实现跨服务器文件自动同步:增量传输、失败重试与巡检告警实践
一、场景
手里有两三台云服务器之后,一个很自然的需求是:A 服务器产生的数据,希望 B 服务器上有一份及时更新的镜像。比如运动健康数据每半小时在源服务器更新一次,我希望在另一台机器上直接读到最新副本做统计和日报;再比如配置文件、备份包,都适合用这种轻量方式同步。不需要上分布式存储,rsync + cron + SSH 这套老组合就足够可靠。本文记录实际做法和几个踩过的坑。
二、为什么是 rsync
增量传输:rsync 的滚动校验算法只传文件变化的部分,半小时同步一次几 MB 的数据,实际流量常常只有几十 KB。保留属性:权限、时间戳、软链接都能原样保留,镜像目录可以直接当源目录用。断点与容错:配合 --partial,大文件传一半断了,下次能续。
三、先打通免密 SSH
同步脚本要无人值守运行,必须用密钥登录,并为同步单独建一对密钥,不要和日常登录共用:ssh-keygen -t ed25519 -f ~/.ssh/sync_ed25519 -C "sync-job",再用 ssh-copy-id 把公钥装到源服务器。打通后先手动验证一次,并把源服务器指纹固定进 known_hosts,避免脚本运行时卡在首次连接确认上。一个容易忽略的环境差异:脚本在 cron 里运行时,环境变量和交互式终端不同,HOME、代理设置都可能不一样。做法是把同步逻辑写成独立脚本,在开头显式写清需要的变量和绝对路径,不依赖登录 shell 的配置。曾经因为脚本用了相对路径,手动跑一切正常、cron 里每次都失败,排查了很久。
四、同步脚本
脚本用 bash,set -euo pipefail 开头;定义 SRC 为 user@source-server:/opt/app/data/,DST 为本地镜像目录,LOG 为日志文件,SSH_CMD 为带专用密钥、BatchMode=yes、ConnectTimeout=15 的 ssh 命令。核心命令:rsync -az --partial --timeout=120 --exclude='*.tmp' --exclude='.cache/' -e "$SSH_CMD" "$SRC" "$DST",输出追加到日志,最后写一行带时间戳的 sync ok。参数说明:-a 归档保留权限时间戳,-z 传输压缩;--timeout 和 ConnectTimeout 一起给失败设上限,避免网络异常时脚本无限挂住、和下一次 cron 叠在一起跑;源路径末尾的斜杠表示同步目录内容而不是目录本身,斜杠有无是 rsync 新手最常见的错误来源;暂时不要加 --delete,源端误删时镜像还能救回来,确认需要严格镜像后再加,并先想好恢复方案。
五、cron 配置
每 30 分钟拉一次:*/30 * * * * 执行同步脚本。频率原则:比源数据更新频率略高即可,太密只增加无意义连接和日志。还要防并发:上一轮没跑完下一轮又启动可能互相踩,用 flock 加锁:*/30 * * * * flock -n /tmp/pull_data.lock 同步脚本,-n 表示拿不到锁直接退出,宁可跳过这一轮,也不排队堆积。
六、巡检:同步坏了要能第一时间知道
定时任务最大的风险不是失败,而是悄悄失败:脚本每天报错,日志没人看,一个月后才发现镜像还是旧的。对策是单独写巡检脚本,每 6 小时检查一次数据新鲜度:读取镜像目录 sync_meta.json 里源端写入的 synced_at 时间戳,计算距今小时数,超过 2 小时就输出 ALERT 并以非 0 退出,否则输出 OK 和最近同步时间。思路是检查结果而不是检查进程:不看 cron 有没有跑、脚本有没有报错,只看镜像里的数据到底新不新。巡检非 0 时通过常用通知渠道发一条告警即可。同样的思路也适用于其他自托管服务:判断健康的标准应该是产出的数据是否新鲜、接口是否真的能返回内容,而不是进程还在不在。
七、常见问题排查顺序
同步异常时按这个顺序查,基本覆盖九成情况:1)手动跑一次脚本看完整报错,不要只看 cron 邮件摘要;2)单独测 SSH,ssh -i 密钥 user@host true,确认密钥和网络通;3)看源端文件时间戳,确认源端本身在更新,有时候是源端先坏了;4)看目标端磁盘空间 df -h,日志和镜像把盘写满是静默失败的经典原因;5)最后再怀疑 rsync 参数和权限。
八、小结
这套方案没有用任何新工具,全是 Linux 自带的老家伙:SSH 管通道,rsync 管增量,cron 管调度,flock 防并发,再加一个只看数据新鲜度的巡检。简单、透明、坏了好查——对于个人服务器之间的数据同步,这四点比功能丰富更重要。