rsync笔记

（参考：https://chegva.com/2827.html）

Rsync（remote synchronize）是一个远程数据同步工具，Rsync使用“Rsync算法”来使两个主机间的文件达到同步，这个算法之传送两个文件的不同部分，而不是每次都整份传送，因此速度相当快。Rsync支持大多数的类Unix系统，此外在Windows下也有相应的版本，如cwRsync和Sync2NAS等。

特点

• 快速：所有数据只同步一次；
• 安全：加密传输；
• 占用带宽少：传输过程中可压缩传输；
• 特权：无需特权即可安装执行。

模式
Rsync有两种工作模式，分别是ssh模式和daemon模式。

1. ssh模式

ssh模式使用ssh协议来传输文件，基本命令格式如下：

rsync [options] [user]@[HOST]:/SRC_dir /DEST_dir

若要指定ssh的端口和登录的系统用户名，使用如下方式：

rsync [options] -e "ssh -p 2222 -l test" <SRC> <DEST>

2. daemon模式

以服务的形式启动，默认监听TCP 873端口。基本命令格式为：

rsync [options] [user]@[HOST]::[module] /DEST_dir

这个模式需要手动做一些配置，大致流程：
1）建立配置文件；rsync的配置文件为/etc/rsyncd.conf，下面为一个简单的配置模板：

#全局配置
port=873
uid=root #默认为nobody
gid=root
use chroot = yes
read only = yes #不允许上传
hosts allow = * #设置允许同步的客户端，*表示所有
max connections = 4
pid file = /var/run/rsyncd.pid
timeout = 600

#以中括号开头的部分代表一个模块(module)，也即一个同步项目
[home_bin]
path = /home/bin
ignore errors
list = no #不允许列出模块清单
auth users = root #认证的用户
secrets file = /etc/rsync/rsync.pass #账号、密码文件

[rsync_test]
path=/root/testdir/test
list = no
read only = yes
max connections = 4
auth users = test
secrets file = /etc/rsync/rsync.pass
#exclude from = /etc/rsync/exclude.txt

2）设置权限；
rsync的权限验证配置，也即上述配置文件中的auth users和secrets file，但是密码文件也即这里的/etc/rsync/rsync.pass需要手动创建且格式如下，一个用户一行。

username：password

注：该文件所有者必须为root，且权限必须为600.

3）添加排除文件或文件夹；
可以通过exclude from选项配置不需要同步的文件或者文件夹，排除文件的内容：一行一个要排除的目录。同时也可以在命令行中的--exclude选型设置需要排除的目录（同样的include也类似）

4）启动rsync的daemon。

rsync --deamon --config=/etc/rsyncd.conf

或者

systemctl start rsyncd

实例解析

1）列出模块清单

rsync  test@HOST::rsync_test

2. 同步服务器文件到本地（常用选项-a：保留文件属性，-v：显示传输信息，-z：压缩传输）

rsync -avz  test@HOST::rsync_test /test/

3. 上传本地文件到服务端（注：这个需要服务端设置允许上传：read only=yes）

rsync -avz /test/ test@HOST::rsync_test

4. 本地和服务端完全一致，即需要删除本地有而服务端没有的文件，需要使用--delete选项

rsync -avz  --delete test@HOST::rsync_test  /test/

5. 显示每个文件的传输进度:--progress

rsync -avz --progress test@HOST::rsync_test  /test/

6. 若本地和服务端都需要修改文件，则使用-u选项

rsync -avzu  test@HOST::rsync_test  /test/

7. 设置需要同步和排除的目录

rsync -avz  --exclude "log"  test@HOST::rsync_test  /test/
rsync -avz  --include "*.txt"  --exclude "*"  test@HOST::rsync_test  /test/
rsync -avz  --max-size="1M"  test@HOST::rsync_test  /test/  #限制同步文件的大小<1M
rsync -avz  --existing  test@HOST::rsync_test  /test/  #仅同步本地存在的目录

8. 同步时需要输入认证密码，为了避免手动输入，可以利用--password-file选项制定密码文件

rsync -avz  --password-file=/root/rsync.pass  /test/

注：改密码文件内容为：password，且权限为600.

Tips：
（1）上述实例是以deamon模式为例，ssh模式就较简单了，只需制定<SRC>和<DEST>即可，且目录为ssh协议的形式，以单冒号：分隔。
（2）上述实例在Linux环境下，若是Windows环境，在则需安装Windows版rsync，并进入安装目录执行rsync.exe命令，且目录以/cygdrive/开头。
（3）ssh模式结合任务计划适用于较简单和轻量级的远程同步备份，其利用的是ssh连接，因此同步时会占用ssh，从而无法远程连接。daemon模式虽然配置复杂，适用于备份任务较大，且需要经常备份的场景，同时对系统的负担也较大。daemon模式也可以结合inotify，可以做到实时远程同步备份，这个咱们下一次再进行探究。

附录
Rsync 命令参数详解
rsync是一个功能非常强大的工具，其命令也有很多功能特色选项，我们下面就对它的选项一一进行分析说明。
Rsync的命令格式可以为以下六种： 　　
rsync [OPTION]... SRC DEST 　　
rsync[OPTION]... SRC [USER@]HOST:DEST 　　
rsync [OPTION]... [USER@]HOST:SRC DEST 　　
rsync [OPTION]... [USER@]HOST::SRC DEST 　　
rsync [OPTION]... SRC [USER@]HOST::DEST 　　
rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST] 　　
对应于以上六种命令格式，rsync有六种不同的工作模式：

1. 拷贝本地文件。当SRC和DES路径信息都不包含有单个冒号":"分隔符时就启动这种工作模式。如：rsync -a /data /backup
2. 使用一个远程shell程序(如rsh、ssh)来实现将本地机器的内容拷贝到远程机器。当DST路径地址包含单个冒号":"分隔符时启动该模式。如：rsync -avz *.c foo:src
3. 使用一个远程shell程序(如rsh、ssh)来实现将远程机器的内容拷贝到本地机器。当SRC地址路径包含单个冒号":"分隔符时启动该模式。如：rsync -avz foo:src/bar /data
4. 从远程rsync服务器中拷贝文件到本地机。当SRC路径信息包含"::"分隔符时启动该模式。如：rsync -av root@172.16.78.192::www /databack
5. 从本地机器拷贝文件到远程rsync服务器中。当DST路径信息包含"::"分隔符时启动该模式。如：rsync -av /databack root@172.16.78.192::www
6. 列远程机的文件列表。这类似于rsync传输，不过只要在命令中省略掉本地机信息即可。如：rsync -v rsync://172.16.78.192/www
   rsync参数的具体解释如下：
   -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中的文件来决定是否需要备份
   -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 给出某些文件的传输状态
   --progress在传输时现实传输过程
   --log-format=formAT指定日志文件格式
   --password-file=FILE从FILE中得到密码
   --bwlimit=KBPS限制I/O带宽，KBytes per second
   -h, --help 显示帮助信息
   一般都使用azv选项