文件同步规则

rsync 基础知识

• 尾部斜杠至关重要：rsync src/ 复制目录内容，rsync src 复制目录本身——这是导致目录结构错误的最主要原因
• 始终以 -avz 作为基础参数：归档模式（archive）保留权限与时间戳，详细输出（verbose）显示进度，压缩（compress）加速传输
• 仅当明确希望目标端完全镜像源端时才添加 --delete；否则，源端已删除的文件仍会保留在目标端
• 执行任何具有破坏性的同步前，务必先使用 --dry-run —— 它会显示将发生的变更，但不实际修改任何内容

排除规则

• 建议使用排除文件而非多个 --exclude 参数：rsync -avz --exclude-from=.syncignore src/ dest/
• 代码项目的标准排除项：.git/、node_modules/、__pycache__/、.venv/、*.pyc、.DS_Store、Thumbs.db
• 排除模式相对于源根目录进行匹配：/logs/ 仅排除顶层的 logs 目录，而 logs/ 会排除任意位置的 logs/ 目录

云存储（rclone）

• rclone sync 会删除目标端中源端不存在的文件；rclone copy 仅新增文件——若不确定，优先使用 copy
• 通过交互式方式配置远程存储：rclone config —— 切勿在脚本中硬编码云服务凭证
• 首次运行务必使用 --dry-run 测试，正式同步时可搭配 --progress 获取可视化进度反馈
• 对于兼容 S3 的存储，处理大文件时应设置 --s3-chunk-size 64M，以避免超时

校验机制

• 关键同步完成后，建议使用校验和验证一致性：rsync -avzc 以校验和替代大小/时间戳判断（速度较慢但结果确定）
• 对于 rclone，可使用 rclone check source: dest: 在不传输数据的前提下比对两端内容
• 将同步操作记录到日志文件以便审计：rsync -avz src/ dest/ | tee sync.log

双向同步

• rsync 仅支持单向同步；如需真正的双向同步，请使用 unison：unison dir1 dir2
• unison 可检测双方均发生变更的冲突情形——需手动解决，或预先配置 prefer 规则
• Dropbox、Syncthing 等云服务原生支持自动双向同步——无需用 rsync 重复造轮子

远程同步

• 针对 SSH 远程主机，推荐使用密钥认证：rsync -avz -e "ssh -i ~/.ssh/key" src/ user@host:dest/
• 如需指定非标准 SSH 端口，使用：-e "ssh -p 2222"
• 在不可靠网络下同步大文件时，启用 --partial --progress —— 支持失败后从中断处恢复

常见陷阱

• 向静默卸载的挂载磁盘同步，可能导致系统自动创建同名本地目录——同步前请确认挂载状态
• 反复执行未带 --delete 的同步操作，会使目标端持续累积已被源端删除的陈旧文件
• 基于时间戳的同步在存在时钟偏移（clock skew）的机器间不可靠——应改用 --checksum 提升准确性，或先同步 NTP 时间