用 rsync 同步文件:常用参数、末尾斜杠和安全删除的要点

举报
赛博大妈 发表于 2026/11/19 09:10:25 2026/11/19
【摘要】 整理 rsync 日常最常用的参数,讲清楚源路径末尾斜杠的区别、--delete 的安全用法和排障思路。

前言

rsync 是 Linux 下最常用的文件同步工具之一。它只传输有差异的部分,适合做目录备份、网站发布、服务器之间的数据迁移。很多人只会 rsync -avz,遇到末尾斜杠、删除选项时却容易出错。本文整理几个要点。

一、基本写法

rsync -avz 源 目标
  • -a:归档模式,等价于 -rlptgoD,递归并保留权限、时间、属主、符号链接等。
  • -v:显示过程。
  • -z:传输时压缩,带宽紧张时有用;本机目录之间同步没有必要。
  • 远程同步通过 SSH:rsync -av ./site/ user@host:/var/www/site/

二、源路径末尾的斜杠

这是最容易踩的坑:

  • rsync -av src/ dst/:同步 src 里面的内容到 dst。
  • rsync -av src dst/:把 src 目录本身放进 dst,结果是 dst/src/。

目标路径末尾的斜杠影响不大,但源路径的斜杠决定了目录层级。养成习惯:同步内容时源路径一律加斜杠,并先用演习模式确认。

三、先演习再执行

-n(–dry-run)只显示将要做什么,不真正改动:

rsync -avn --delete src/ dst/

配合 -i(–itemize-changes)可以看到每个文件为什么会被传输,是内容变化、时间变化还是权限变化。确认输出符合预期后,去掉 -n 再执行。

四、–delete 要小心

默认情况下 rsync 不会删除目标端多出来的文件。加上 --delete 后,目标会被改成与源完全一致,目标里多余的文件会被删掉。

使用建议:

  • 第一次使用一定先 -n 演习。
  • 确认源路径不是空目录或写错的路径,否则可能清空目标。
  • 需要保险时用 --backup --backup-dir=目录,被删除或覆盖的文件会被移到备份目录。
  • 用 --max-delete=N 限制单次最多删除的文件数,作为兜底。

五、排除与包含

rsync -av --exclude='*.log' --exclude='node_modules/' src/ dst/
  • 模式是相对于传输根目录匹配的。
  • 规则很多时,用 --exclude-from=文件 统一管理。
  • 注意规则顺序:先匹配到的规则生效。

六、几个实用参数

  • –progress 或 -P:显示进度,并支持断点续传(-P 等于 --partial --progress)。
  • –bwlimit=KB/s:限速,避免占满带宽。
  • -e “ssh -p 2222”:指定 SSH 端口等参数。
  • –checksum:按校验和而不是大小和修改时间判断差异,更慢但更严格。
  • -H、-A、-X:分别保留硬链接、ACL、扩展属性,需要完整迁移时再加。

七、常见问题排查

  1. 权限被拒绝:检查目标目录是否有写权限,-a 里的保留属主需要 root 才能生效,普通用户会提示无法 chown,通常可以忽略。
  2. 每次都重新传全部文件:多半是两端时间不一致或文件系统不支持保留时间戳,可试 --size-only 或 --modify-window。
  3. 连接中断:用 -P 重新执行即可续传。
  4. 文件名乱码:检查两端的字符集设置。

我的几点看法

  1. 末尾斜杠要先想清楚,再动手;不确定就先演习。
  2. –delete 前永远先 -n,这是习惯,不是可选项。
  3. 重要数据的同步,建议配合 --backup-dir 或 --max-delete 留一道保险。
  4. rsync 适合同步和增量备份,但它不是版本管理,误改的文件同步过去就覆盖了,重要数据仍需要快照或多份备份。
  5. 排除规则写进文件里,便于复查和复用。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。