2024年6月2日发(作者：)

rsync 参数

rsync数是Linux中经常被使用的一种文件同步工具。它可以快

速有效地将文件从一台计算机复制到另一台计算机，也可以将一个目

录下文件同步到另一目录，rsync支持双向同步，以及支持特定网络

文件传输协议，比如ssh协议。

rsync数是控制 rsync具执行的一系列选项，不同的参数可以调

整 rsync行为，从而实现不同的功能。本文将对 rsync数进行简单

介绍，帮助初学者了解 rsync工作原理，熟练使用 rsync具复制文

件。

1、rsync数的种类

rsync数分为三大类：

（1）基础参数：基础参数采用简短的短语，如“-v”、“-n”、“-z”

等，它们用来控制 rsync行为，以实现 rsync能的基本实现。

（2）选项参数：选项参数以--开头，并根据其功能分为多个子

参数，如“--link-dest”、“--exclude”等，支持一些复杂的功能需

求。

（3）扩展参数：扩展参数以--开头，支持 rsync现更多更复杂

的功能，如“--delete”、“--delete-excluded”等。

2、基础参数

（1）-v数：这个参数指定 rsync行时输出更多的状态信息，可

以查看每次复制文件的详细过程，比如文件块大小，复制速度，复制

耗时等信息；

- 1 -

（2）-a数：这个参数表示rsync复制的文件的权限，属性，时

间都会进行保留；

（3）-z数：这个参数会对文件内容进行压缩，在网络传输时提

高效率，但如果文件已经被压缩，则该参数不会起到作用；

（4）-n数：这个参数表示不执行任何更新操作，仅仅显示将要

执行什么操作，如果仅仅想要看到执行结果，而不想实际执行，则可

以加上该参数；

（5）-r数：这个参数表示rsync会对目标目录下的所有文件夹

递归处理；

（6）-u数：这个参数表示只会把源文件的更新版本传到目标目

录，而不会传输源目录比目标目录新的文件；

（7）--times数：这个参数表示rsync会将源目录下文件时间

信息也一起复制到目标目录；

（8）--delete数：这个参数表示rsync会将目标目录中没有出

现在源目录中的文件删除。

3、选项参数

（1）--link-dest数：该参数用来实现目标目录中未更新的文

件使用硬链接指向源目录中相同的文件，从而节省空间，优化同步；

（2）--exclude数：该参数用于指定可以排除复制的过滤模式，

支持各种常用的文件格式；

（3）--include数：该参数用于指定包含在复制的文件模式，

支持各种常用的文件格式（它可以和 exclude项一起使用）；

- 2 -

（4）--dry-run数：该参数表示将会在不执行任何操作的情况

下，预览将要进行的内容；

（5）--backup数：该参数表示将在目标目录下创建一个备份文

件夹，将会把文件更新前的版本备份到该文件夹中，以防止意外的数

据丢失；

（6）--temp-dir数：该参数用于指定本次更新所需要的中间文

件存放的位置，当源和目标之间空间不足以存放临时文件时，可以指

定一个具有足够空间的文件夹；

（7）--copy-links数：该参数表示如果源目录中存在符号链接，

则目标目录中也会出现对应的符号链接；

（8）--bwlimit数：该参数用于设置rsync复制文件的最大速

度，单位为KBytes/s，以防止影响网络性能。

4、扩展参数

（1）--delete-excluded数：该参数表示如果源目录下的文件

被排除，则不会被复制，而且会在目标目录中进行删除；

（2）--relative数：该参数用于表示在把文件从源目录复制到

目标目录时，也会把源目录中原有的相对路径也一起复制；

（3）--backup-dir数：该参数用于指定备份文件夹所在的位置，

不会破坏目标目录的原有结构；

（4）--partial数：该参数表示rsync会保留部分完成的文件，

如果下次同步时，只要传输剩余部分，而不是整个文件；

（5）--bwlimit-burst数：该参数用于控制 rsync bwlimit数

- 3 -

指定的节奏下的最大传输速率，单位仍然是 KBytes/s；

（6）--timeout数：该参数用于指定连接超时时间，以避免由

于网络问题而导致 rsync制不完全。

以上就是 rsync数的简要介绍，rsync具有很多选项，根据实际

需求灵活搭配参数，可以实现定制化的文件复制操作。有了这些参数

的基本了解，就可以熟练地使用 rsync具完成文件复制了。

- 4 -