rsync路径末尾斜杠决定同步“内容”或“整个目录”,--delete行为严格依赖该斜杠;远程同步需ssh免密及端口配置;排除文件必须用--exclude而非shell通配符。

rsync 是 Linux 下做目录同步最常用、也最可靠的工具,但直接敲 rsync -av source/ dest/ 并不总能如你所愿——路径末尾斜杠、--delete 的作用范围、远程传输时的压缩与 SSH 配置,稍有偏差就可能同步错层、删错文件,甚至卡在权限或连接上。
源路径末尾斜杠决定同步“内容”还是“整个目录”
这是新手踩坑最多的地方,和 cp 完全不同,rsync 对斜杠极其敏感:
不带斜杠:rsync -av /data/dir /backup/ → 把 dir 这个目录(含名字)整个复制进去,结果是 /backup/dir/
带斜杠:rsync -av /data/dir/ /backup/ → 只把 dir 里面的文件和子目录同步过去,结果是 /backup/file1.txt、/backup/sub/
- 加斜杠 = 同步“目录内容”,适合日常备份或部署更新
- 不加斜杠 = 同步“目录本身”,适合归档打包或迁移结构
- 如果目标是空目录,两者效果看起来一样;但一旦目标已有文件,尤其配合
--delete,行为差异会立刻暴露
用 --delete 之前必须确认源和目标的“比较层级”
--delete 不是简单“删掉目标里多出来的文件”,它删除的是“源目录下没有、但目标当前层级有的东西”。这个“当前层级”由斜杠决定:
假设源是 /srv/www/(带斜杠),目标是 /var/www/:
Linux 性能分析与调优专家,覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景:系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
-
rsync -av --delete /srv/www/ /var/www/→ 比较/srv/www/内容 和/var/www/内容,删掉/var/www/中多余的old.log -
rsync -av --delete /srv/www /var/www/→ 比较/srv/www目录(本身)和/var/www/内容,这时/var/www/下所有非www目录都会被删
换句话说:--delete 的安全前提是“源路径结尾斜杠与你的同步意图严格一致”。误用可能清空整个目标目录。
远程同步必须配好 SSH,否则卡在密码或连接拒绝
rsync 默认走 SSH,但很多失败不是命令写错,而是环境没准备好:
- 远程主机必须运行
sshd,且防火墙放行 22 端口(或自定义端口) - 本地执行
ssh user@host能免密登录,rsync才能免密;否则每次同步都卡在密码输入 - 指定非标 SSH 端口要用
-e "ssh -p 2222",不能只写--port=2222 - 加
-z压缩只对远程有效,本地同步加了也无用,还略增 CPU 开销
典型安全远程同步命令:rsync -avz --delete -e "ssh -p 2222" /local/dir/ user@host:/remote/dir/
排除临时文件和元数据要靠 --exclude,不是靠通配符直写
想跳过 .git、node_modules 或 *.tmp?不能靠 shell 展开,得用 --exclude 让 rsync 在传输前过滤:
-
--exclude='.git':排除所有名为.git的目录(无论在哪层) -
--exclude='*.log':排除所有.log文件,注意引号防止 shell 提前展开 -
--exclude='build/':排除build/目录及其全部内容(末尾斜杠可选,但推荐加上) - 多个排除项可重复写:
--exclude='temp' --exclude='*.swp' - 规则复杂时,用
--exclude-from=file.txt更清晰,每行一条模式
别写成 rsync -av !(node_modules)/ dest/ —— 这是 shell glob,rsync 根本不认,反而可能报错或漏排除。
真正容易被忽略的,是斜杠语义和 --delete 的联动关系。哪怕你记住了所有参数,只要源路径斜杠错了,--delete 就可能变成“删库”操作。










