文件同步规则

rsync 基础知识

• 尾部斜杠至关重要：rsync src/ 复制目录内容，rsync src 复制目录本身——这是导致目录结构错误的最主要原因
• 始终使用 -avz 作为基础参数：归档模式保留权限与时间戳，详细模式显示进度，压缩模式加速传输
• 仅当需要目标端完全镜像源端时才添加 --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 时间