rsync 命令详解

rsync 的命令格式
rsync [OPTION]… SRC DEST
推荐在 SSH 的基础上使用rsync。可以事先在~/.ssh/config中加入配置，这样远端可以写作SSH配置名:路径。

目录SRC是否以斜杠结尾，会影响同步的结果：

以斜杠结尾：目录DEST里面有 [目录SRC里面的文件]
不以斜杠结尾：目录DEST里面有 [目录SRC本身]
目录DEST是否以斜杠结尾，对同步的结果没有任何影响。

我们经常这样使用rsync：

$ rsync main.c machineB:/home/userB
只要目的端的文件内容和源端不一样，就会触发数据同步，rsync会确保两边的文件内容一样。

但rsync不会同步文件的 modify time ，凡是有数据同步的文件，目的端的文件的 modify time 总是会被修改为最新时刻的时间。

rsync不会太关注目的端文件的 rwx 权限，如果目的端没有此文件，那么权限会保持与源端一致；如果目的端有此文件，则权限不会随着源端变更。

只要rsync有对源文件的读权限，且对目标路径有写权限，rsync就能确保目的端文件同步到和源端一致。

rsync只能以登陆目的端的账号来创建文件，它没有能力保持目的端文件的输主和属组和源端一致。除非你使用 root 权限，才有资格要求属主一致、属组一致。

-t 选项
我们经常这样使用-t选项：

$ rsync -t main.c machineB:/home/userB
使用-t选项后，rsync总会想着一件事，那就是将源文件的 modify time 同步到目标机器。

带有-t选项的rsync，会变得更聪明些，它会在同步前先对比两边文件的时间戳和文件大小，如果一致，则就认为两边文件一样，对此文件就不再采取更新动作了。

因为rsync的聪明，也会反被聪明误。如果目的端的文件的时间戳、大小和源端完全一致，但是内容恰巧不一致时，rsync是发现不了的。这就是传说中的“坑”！

对于rsync自作聪明的情况，解决办法就是使用-I选项。

-I 选项
我们经常这样使用-I选项：

$ rsync -I main.c machineB:/home/userB
-I选项会让rsync变得很乖很老实，它会挨个文件去发起数据同步。

-I选项可以确保数据的一致性，代价便是速度上会变慢，因为我们放弃了 quick check 策略。 quick check 策略，就是先查看文件的时间戳和文件大小，依次先排除一批认为相同的文件。

无论情况如何，目的端的文件的 modify time 总会被更新到当前时刻。

-v 选项
这个选项，简单易懂，就是让rsync输出更多的信息，我们可以举一个例子：

$ rsync -vI main.c machineB:/home/userB
main.c

sent 81 bytes received 42 bytes 246.00 bytes/sec
total size is 11 speedup is 0.09
你增加越多的v，就可以获得越多的日志信息。

$ rsync -vvvvt abc.c machineB:/home/userB
cmd= machine=machineB user= path=/home/userB
cmd[0]=ssh cmd[1]=machineB cmd[2]=rsync cmd[3]=–server cmd[4]=-vvvvte. cmd[5]=. cmd[6]=/home/userB
opening connection using: ssh machineB rsync --server -vvvvte. . /home/userB
note: iconv_open(“ANSI_X3.4-1968”, “ANSI_X3.4-1968”) succeeded.
(Client) Protocol versions: remote=28, negotiated=28
(Server) Protocol versions: remote=30, negotiated=28
[sender] make_file(abc.c,*,2)
[sender] flist start=0, used=1, low=0, high=0
[sender] i=0 abc.c mode=0100664 len=11 flags=0
send_file_list done
file list sent
send_files starting
server_recv(2) starting pid=31885
recv_file_name(abc.c)
received 1 names
[receiver] i=0 abc.c mode=0100664 len=11
recv_file_list done
get_local_name count=1 /home/userB
recv_files(1) starting
generator starting pid=31885 count=1
delta transmission enabled
recv_generator(abc.c,0)
abc.c is uptodate
generate_files phase=1
send_files phase=1
recv_files phase=1
generate_files phase=2
send files finished
total: matches=0 hash_hits=0 false_alarms=0 data=0
generate_files finished
recv_files finished
client_run waiting on 14318

sent 36 bytes received 16 bytes 104.00 bytes/sec
total size is 11 speedup is 0.21
_exit_cleanup(code=0, file=main.c, line=1031): entered
_exit_cleanup(code=0, file=main.c, line=1031): about to call exit(0)
-z 选项
这是个压缩选项，只要使用了这个选项，rsync就会把发向对端的数据先进行压缩再传输。对于网络环境较差的情况下建议使用。

一般情况下，-z的压缩算法会和 gzip 的一样。

-r 选项
我们在第一次使用rsync时，往往会遇到这样的囧境：

$ rsync superman machineB:/home/userB
skipping directory superman
如果你不额外告诉rsync你需要它帮你同步文件夹的话，它是不会主动承担的，这也正是rsync的懒惰之处。

所以，如果你真的想同步文件夹，那就要加上-r选项，即 recursive（递归的、循环的），像这样：

$ rsync -r superman machineB:/home/userB
我们在上面的讲解中说过，如果时间戳和文件大小完全一致，只有文件内容不同，且你没有使用-I选项的话，那么，rsync是不会进行数据同步的。

那么，提个问题：“因为在Linux的世界里，文件夹也是文件，如果这类文件（文件夹）也只有内容不同，而时间戳和文件大小都相同，rsync会发现么？”

实验大家可以自己动手做，结论在这里告诉大家：

对于文件夹，rsync是会明察秋毫的，只要你加了-r选项，它就会恪尽职守的进入到文件夹里去检查，而不会只对文件夹本身做 quick check 的。

-l 选项
如果我们要同步一个软链接文件，你猜rsync会提示什么？

$ ll
total 128
-rw-rw-r-- 1 userA userA 11 Dec 26 07:00 abc.c
lrwxrwxrwx 1 userA userA 5 Dec 26 11:35 softlink -> abc.c
$ rsync softlink machineB:/home/userB
skipping non-regular file “softlink”
嗯，你猜对了，rsync又无情地拒绝了我们。它一旦发现某个文件是软链接，就会无视它，除非我们增加-l选项。

$ rsync -l softlink machineB:/home/userB
使用了-l选项后，rsync会完全保持软链接文件类型，原原本本的将软链接文件复制到目的端，而不会 follow link 到指向的实体文件。

如果我偏偏就想让rsync采取 follow link 的方式，那就用-L选项就可以了。你可以自己试试效果。

-p 选项
这个选项的全名是 perserve permissions，顾名思义，就是保持权限。

如果你不使用此选项的话，rsync是这样来处理权限问题的：

如果目的端没有此文件，那么在同步后会将目的端文件的权限保持与源端一致；
如果目的端已存在此文件，那么只会同步文件内容，权限保持原有不变。
如果你使用了-p选项，则无论如何，rsync都会让目的端保持与源端的权限一致的。

-g 和 -o 选项
这两个选项是一对，用来保持文件的属组（group）和属主（owner），作用应该很清晰明了。不过要注意的一点是，改变属主和属组，往往只有管理员权限才可以。

-D选项
-D选项，原文解释是 preserve devices (root only)，从字面意思看，就是保持设备文件的原始信息。由于博主没有实际体验过它的好处，所以没有太多发言权。

-a 选项
-a选项是rsync里比较霸道的一个选项，因为你使用-a选项，就相当于使用了-rlptgoD这一坨选项。以一敌七，唯-a选项也。（在看了前文之后，你应该可以很轻松的理解这七个选项的作用了。）

-a选项的学名应该叫做 archive option，中文叫做归档选项。使用-a选项，就表明你希望采取递归方式来同步，且尽可能的保持各个方面的一致性。

但是-a选项也有阿克琉斯之踵，那就是-a无法同步“硬链接”情况。如果有这方面需求，要加上-H选项。

-delete 选项
如果源端没有此文件，那么目的端也别想拥有，删除之。

-delete选项必须和-r选项搭配使用。

-delete-excluded 选项
专门指定一些要在目的端删除的文件。

-delete-excluded选项必须和-r选项搭配使用。

-delete-after 选项
默认情况下，rsync是先清理目的端的文件再开始数据同步；如果使用此选项，则rsync会先进行数据同步，都完成后再删除那些需要清理的文件。

-delete-after选项必须和-r选项搭配使用。

-n 选项
看到这么多 delete，你是否有点肝颤？的确，在rsync的官方说明里也有这么一句话：

This option can be dangerous if used incorrectly!

It is a very good idea to run first using the dry run option (-n) to see what files would be deleted to make sure important files aren’t listed.
从这句话里，我们学到了一个小技巧，那就是-n选项，它是一个吓唬人的选项，它会用受影响的文件列表来警告你，但不会真的去执行，这就让我们有了确认的机会和回旋的余地。我们看看实际用法吧：

$ rsync -n --delete -r . machineB:/home/userB/
deleting superman/xxx
deleting main.c
deleting acclink
-exclude 和 -exclude-from 选项
如果你不希望同步一些东西到目的端的话，可以使用-exclude选项来隐藏，rsync还是很重视大家隐私的，你可以多次使用-exclude选项来设置很多的“隐私”。

如果你要隐藏的隐私太多的话，在命令行选项中设置会比较麻烦，rsync还是很体贴，它提供了-exclude-from选项，让你可以把隐私一一列在一个文件里，然后让rsync直接读取这个文件就好了。

-include 和 -include-from 选项
这两个选项的作用是：重新加入已经被-exclude或-exclude-from选项排除的文件。

-include选项可以被多次使用。-include-from选项用于指定文件中读取文件列表。

请注意 exclude 和 include 的先后顺序。先 exclude 再 include。

-partial 选项
这就是传说中的断点续传功能。默认情况下，rsync会删除那些传输中断的文件，然后重新传输。但在一些特别情况下，我们不希望重传，而是续传。

我们在使用中，经常会看到有人会使用-P选项，这个选项其实是为了偷懒而设计的。以前人们总是要手动写-partial -progress，觉得太费劲了，倒不如用一个新的选项来代替，于是-P应运而生了。有些读者会问-partial我知道作用了，可-progress是干什么用的呢？为什么很多人要使用它呢，它有那么大的吸引力？

真有……

-progress 选项
使用这个选项，rsync会显示出传输进度信息，有什么用呢，rsync给了一个很有意思的解释：

This gives a bored user something to watch.
好了，写了这么多，大家看的已经很乏味了，去实际用用-progress解解闷，是个不错的选择。

PS：后续会讲解有关rsync的-exclude的 PATTERN 语法。

谢谢！

转载：

标题：rsync 命令参数详解
作者：subsir
原文：https://www.cnblogs.com/subsir/articles/2565373.html
全部参数
-v, --verbose 详细模式输出。
-q, --quiet 精简输出模式。
-c, --checksum 打开校验开关，强制对文件传输进行校验。
-a, --archive 归档模式，表示以递归方式传输文件，并保持所有文件属性，等于 -rlptgoD。
-r, --recursive 对子目录以递归模式处理。
-R, --relative 使用相对路径信息。
-b, --backup 创建备份，也就是对于目的已经存在有同样的文件名时，将老的文件重新命名为 ~filename。可以使用 --suffix 选项来指定不同的备份文件前缀。
–backup-dir 将备份文件（~filename）存放在在目录下。
-suffix=SUFFIX 定义备份文件前缀。
-u, --update 仅仅进行更新，也就是跳过所有已经存在于 DST，并且文件时间晚于要备份的文件。（不覆盖更新的文件。）
-l, --links 保留软链结。
-L, --copy-links 想对待常规文件一样处理软链结。
–copy-unsafe-links 仅仅拷贝指向 SRC 路径目录树以外的链结。
–safe-links 忽略指向 SRC 路径目录树以外的链结。
-H, --hard-links 保留硬链结。
-p, --perms 保持文件权限。
-o, --owner 保持文件属主信息。
-g, --group 保持文件属组信息。
-D, --devices 保持设备文件信息。
-t, --times 保持文件时间信息。
-S, --sparse 对稀疏文件进行特殊处理以节省 DST 的空间。
-n, --dry-run 显示哪些文件将被传输（新增、修改和删除）。
-W, --whole-file 拷贝文件，不进行增量检测。
-x, --one-file-system 不要跨越文件系统边界。
-B, --block-size=SIZE 检验算法使用的块尺寸，默认是 700 字节。
-e, --rsh=COMMAND 指定使用 rsh, ssh 方式进行数据同步。
–rsync-path=PATH 指定远程服务器上的 rsync 命令所在路径信息。
-C, --cvs-exclude 使用和 CVS 一样的方法自动忽略文件，用来排除那些不希望传输的文件。
–existing 仅仅更新那些已经存在于 DST 的文件，而不备份那些新创建的文件。
–delete 删除那些 DST 中 SRC 没有的文件。
–delete-excluded 同样删除接收端那些被该选项指定排除的文件。
–delete-after 传输结束以后再删除。
–ignore-errors 即使出现 IO 错误也进行删除。
–max-delete=NUM 最多删除 NUM 个文件。
–partial 保留那些因故没有完全传输的文件，以便实现断点续传。
–force 强制删除目录，即使不为空。
–numeric-ids 不将数字的用户和组 ID 匹配为用户名和组名。
–timeout=TIME IP 超时时间，单位为秒。
-I, --ignore-times 不跳过那些有同样的时间和长度的文件。
–size-only 当决定是否要备份文件时，仅仅察看文件大小而不考虑文件时间。
–modify-window=NUM 决定文件是否时间相同时使用的时间戳窗口，默认为 0。
-T --temp-dir=DIR 在 DIR 中创建临时文件。
–compare-dest=DIR 同样比较 DIR 中的文件来决定是否需要备份。
–progress 显示传输过程。
-P 等同于 -partial -progress。
-z, --compress 对备份的文件在传输时进行压缩处理。
–exclude=PATTERN 指定排除不需要传输的文件模式。
–include=PATTERN 指定不排除而需要传输的文件模式。
–exclude-from=FILE 排除 FILE 中指定模式的文件。
–include-from=FILE 不排除 FILE 指定模式匹配的文件。
–version 打印版本信息。
–address 绑定到特定的地址。
–config=FILE 指定其他的配置文件，不使用默认的 rsyncd.conf 文件。
–port=PORT 指定其他的 rsync 服务端口。
–blocking-io 对远程 shell 使用阻塞 IO。
–stats 给出某些文件的传输状态。
–log-format=formAT 指定日志文件格式。
–password-file=FILE 从 FILE 中得到密码。
–bwlimit=KBPS 限制 I/O 带宽，KBytes per second。
-h, --help 显示帮助信息。

rsync 命令详解相关推荐

linux下rsync命令,Linux 命令之rsync命令详解
rsync命令 rsync命令是一个远程数据同步工具,可通过LAN/WAN快速同步多台主机间的文件.rsync使用所谓的"rsync算法"来使本地和远程两个主机之间的文件达到同步, ...
Linux rsync命令详解
rsync命令是一个远程数据同步工具,可通过LAN/WAN快速同步多台主机间的文件.rsync使用所谓的"rsync算法"来使本地和远程两个主机之间的文件达到同步,这个算法只传送两 ...
linux下rsync命令,linux上的rsync命令详解
rsync 简介 rsync 就是远程同步的意思remote sync. rsync 被用在UNIX / Linux执行备份操作操作. rsync 工具包被用来从一个位置到另一个位置高效地同步文件和文 ...
nmcli命令详解_【高新课堂】第一百二十五期Liunx必备命令
点击上方"蓝字"关注我们吧! Liunx系统启动默认为字符界面,一般不会启用图像界面,所以对命令行的熟练程度能更加高效.便捷的管理Liunx服务器. 这节课向读者介绍Liunx系统 ...
pigz 快速压缩命令详解
pigz 快速压缩命令详解安装pigz命令 yum install -y pigzPigz官网:http://zlib.net/pigz/ 常用命令参数 Options:-0 to -9, -11 ...
linux inotifywait脚本,inotify之inotifywait命令详解
1.inotify简介 inotify 是一个从 2.6.13 内核开始,对 Linux 文件系统进行高效率.细粒度.异步地监控机制, 用于通知用户空间程序的文件系统变化.可利用它对用户空间进行安全. ...
Linux常用命令详解（最全）
Linux命令目录 Linux命令集合系统信息关机 (系统的关机.重启以及登出 ) 文件和目录文件搜索挂载一个文件系统磁盘空间用户和群组文件的权限 - 使用 "+" ...
SSH终端远程复制：scp命令详解
scp命令详解先说下常用的情况: 两台机器IP分别为:A.104.238.161.75,B.43.224.34.73. 在A服务器上操作,将B服务器上/home/lk/目录下所有的文件全部复制到本地 ...
docker常用命令详解
docker常用命令详解本文只记录docker命令在大部分情境下的使用,如果想了解每一个选项的细节,请参考官方文档,这里只作为自己以后的备忘记录下来. 根据自己的理解,总的来说分为以下几种: Doc ...

rsync 命令详解

rsync 命令详解相关推荐

最新文章

热门文章