rsync 的命令格式
rsync 的命令格式
rsync [OPTION]... SRC DEST
推荐在 SSH 的基础上使用rsync。可以事先在~/.ssh/config中加入配置，这样远端可以写作SSH配置名:路径。
目录SRC是否以斜杠结尾，会影响同步的结果：
- 以斜杠结尾：目录
DEST里面有 [目录SRC里面的文件] - 不以斜杠结尾：目录
DEST里面有 [目录SRC本身]
目录DEST是否以斜杠结尾，对同步的结果没有任何影响。
转载：
- 标题：rsync 同步的艺术
- 作者：roc
- 原文：http://roclinux.cn/?p=2643
如果你是一位运维工程师，你很可能会面对几十台、几百台甚至上千台服务器，除了批量操作外，环境同步、数据同步也是必不可少的技能。
说到“同步”，不得不提的利器就是rsync，今天就来说说我从这个工具中看到的同步的艺术。
不带任何选项
我们经常这样使用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 显示帮助信息。
