rsync 覆盖旧文件前怎么用 --backup-dir 留存变更版本

在 rsync 同步命令中指定 --backup-dir=目录，就能把接收端将被替换或删除的旧条目留到该目录。它隐含启用 --backup，留存的是目标端的旧版本，不是源目录的新文件。每次同步使用不同批次目录，才能避免把多次变更混在同一处。

rsync 官方地址：https://rsync.samba.org/

旧文件消失时先区分覆盖、删除和未变化

设想一次配置发布：源目录中有新的 conf/app.conf，目标目录中已有旧配置；目标还多出一份 conf/legacy.conf。普通同步会处理需要更新的配置，但目标多余文件是否删除取决于删除选项。备份参数只负责保存旧条目，并不会自行开启镜像删除。

因此，“留存目录里没有所有文件”本身不是错误。它是本次变化留下的旧条目集合，不是同步后目录的完整副本。

把留存目录放在目标同步树之外

推荐把目标目录与留存目录设为同一父目录下的两个独立子目录：例如 target/ 与 history/一次性批次/。这样不会把备份卷入源文件复制或目标多余文件删除。相对的 backup-dir 路径以接收端目标目录为基准；远程同步时，目录也位于接收端机器，而不是必然位于运行命令的本机。使用 rsync daemon 时还受模块路径范围限制。

# 只创建独立测试空间；不用真实业务目录，也不删除既有数据
sync_demo=$(mktemp -d)
mkdir -p "$sync_demo/source/conf" "$sync_demo/target/conf"

# 每次留存使用唯一的新目录，避免重复批次覆盖同一路径的旧条目
sync_history=$(mktemp -d "$sync_demo/history.XXXXXX")

# 查看测试位置后，在 source/conf 和 target/conf 放入自己的测试文件
printf '源目录：%s\n目标目录：%s\n留存目录：%s\n' \
  "$sync_demo/source" "$sync_demo/target" "$sync_history"

下面示例需由读者先放入明确的测试文件，本文不提供伪造运行输出。创建不同内容的源与目标配置时，也要确保它们会被 rsync 判为需更新；默认快速判断主要比较文件大小和修改时间，同样大小、同样时间的内容差异可能被跳过。

给同步命令增加备份目录

# 源目录尾部斜线表示同步其内容，不再额外嵌套一个 source 目录
# 这里只更新文件，不开启删除；-i 显示条目变化线索
rsync -ai --backup-dir="$sync_history" \
  "$sync_demo/source/" "$sync_demo/target/"
sync_rc=$?

# 非零退出码需要排查，不能宣称整批同步及留存已经完整
printf 'rsync退出码：%s\n' "$sync_rc"

假如 target/conf/app.conf 需要被替换，对应旧版本会按相对结构保存在 history.批次/conf/app.conf。使用 backup-dir 时默认备份后缀为空，所以通常保留原文件名；若另外指定 --suffix，查找与恢复时必须计入后缀。显式写 -b 也可以，但不是使用 backup-dir 的必要条件。

不要把多次部署写进同一个固定留存目录。相同相对路径反复出现时，不会自动生成无限版本；独立目录才把“哪次同步之前的文件”标清楚。为批次附上操作时间、源目标位置和变更记录，恢复时比猜文件修改时间更可靠。

需要镜像删除时明确增加删除选项

只有确认源目录代表完整且正确的目标集合，才考虑 --delete。它会处理目标目录中源端没有的条目，属于实际删除操作。先在上述测试空间演练，再根据业务范围制定部署方案；不要将下面命令直接改成不明生产路径。每次执行仍须新建独立留存目录。

# 新建这一轮专属留存目录；删除范围仅限前面明确创建的测试 target
sync_history=$(mktemp -d "$sync_demo/history.XXXXXX")

# 仅当测试源集合正确时执行：目标多余条目将删除，并留存其旧文件
rsync -ai --delete --backup-dir="$sync_history" \
  "$sync_demo/source/" "$sync_demo/target/"
sync_rc=$?
printf '本轮退出码：%s\n' "$sync_rc"

不要把“有备份参数”理解成可以随意删除。目录权限、磁盘空间或输入集合错误都可能影响结果；失败后必须保留现场，先查看退出码与错误信息。不要为了继续删除加入忽略错误的参数。

按相对路径找到旧文件并单独恢复

恢复配置时，先选中正确批次的 conf/app.conf，对比内容，再确认是否应覆盖当前配置。服务正在使用配置时，还需安排相应停写或维护措施。下面命令仅用于测试目录中的一个文件，并把当前版本再次备份到另一个目录，不作整树镜像删除。

# 先确认当前 sync_history 指向需要恢复的批次，并比较同一路径
diff -u "$sync_history/conf/app.conf" "$sync_demo/target/conf/app.conf"

# 确认要恢复后，新建恢复操作的留存目录，保护当前配置
restore_history=$(mktemp -d "$sync_demo/restore-history.XXXXXX")
rsync -ai --backup-dir="$restore_history" \
  "$sync_history/conf/app.conf" "$sync_demo/target/conf/"
restore_rc=$?
printf '恢复退出码：%s\n' "$restore_rc"

diff 返回存在差异不等于读文件失败，需要区分其退出状态。恢复成功后还要在读者环境按应用要求检查配置和服务状态。绝不能对这个变化留存目录使用整树 --delete 恢复：未变化文件原本就不在其中，照它镜像会误删其他有效文件。源端新增文件也没有旧版本，整体回滚还需要变更清单决定如何处理。

留存目录为空或版本不完整时怎么判断

先看是否确实存在目标旧文件、是否判定需要更新，以及是否开启了目标多余文件删除。再看接收端路径、权限和退出状态。没有更新就可能没有旧文件；目标位于远端时，不应只在本地寻找备份。

这与 --link-dest 有什么区别？

--backup-dir 收集本轮被替换或删除的旧条目；--link-dest 用已有目录作为比较基础，对满足条件的未变化文件建立硬链接，常用于构造快照目录。两者的数据组织不同，不能把变化留存目录当作可直接镜像还原的完整快照。

可以一直复用同一个目录吗？

不建议。若要保留多批版本，每轮创建新目录，并独立制定保留期限和空间管理方案；rsync 不会替你实现完整的版本索引和历史清理策略。

配置目录能否保证事务性回滚？

不能。单次同步的退出码、旧文件留存与整套应用配置的一致性是不同问题。多文件配置、数据库和持续写入数据需要额外的一致性与恢复设计，不能只依靠这一参数。

官方参数手册：https://rsync.samba.org/ftp/rsync/rsync.1。