Rsync详解

1.什么是rsync

Rsync是一款开源的、快速的、多功能的、可实现全量及增量的本地或远程数据同步备份的优秀工具。适用于unix/linux/windows等多种操作系统平台。

来自：http://www.samba.org/ftp/rsync/rsync.html

2.rsync特性

l  支持拷贝特殊文件如链接文件，设备等

l  可以有排除指定文件或者目录同步的功能，相当于打包命令tar的排除功能

l  可以做到保持原文件或者目录的权限、时间、软硬链接、属主、组等所有属性均不改变-p

l  可以实现增量同步、既只同步发生变化的数据，因此数据传输效率很高,tar -N

l  可以实现rcp、rsh、ssh等方式来配合数据文件（rsync本身不对数据加密）

l  可以通过socket（进程方式）传输文件和数据（服务端和客户端）

l  支持匿名的或认证（无需系统用户）的进程模式传输，可以实现方便安全的进行数据备份及镜像

3.常用参数

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选项. 

4.工作方式

4.1 本地拷贝

语法如下：
Local:
rsync [OPTION...] SRC... [DEST]
例如：拷贝/root/scripts目录到/tmp目录
[root@ansible day01]# rsync -zva --progress /root/scripts /tmp/
…
scripts/httpd-2.4.48/test/travis_run_linux.sh
          5,171 100%    9.33kB/s    0:00:00 (xfr#2971, to-chk=0/3073)

sent 18,756,297 bytes  received 57,117 bytes  5,375,261.14 bytes/sec
total size is 47,457,716  speedup is 2.52
# 查看拷贝
[root@ansible day01]# ls -l /tmp/
总用量 4
drwxr-xr-x 5 root root 4096 10月  3 15:27 scripts
[root@ansible day01]# rsync -zqa --progress /root/scripts/ /tmp/
[root@ansible day01]# ls /tmp/
20                     day01                dos.sh                  fs.dat                if.sh                       nginx_tj.sh                  test12.awk  test4.awk  test8.awk  var.sh
auth_install_lamp2.sh  df.awk               emp.dat                 host.info             linux-utilization-rate2.sh  redaltime-networktraffic.sh  test1.awk   test5.awk  test9.awk  websitecheck.sh
auth_install_lamp.sh   df.sh                findhigh-cpu-memory.sh  httpd-2.4.48          linux-utilization-rate.sh   test10.awk                   test2.awk   test6.awk  test.awk   yp.sh
awk_gj                 disk_monitoring2.sh  for.sh                  httpd-2.4.48.tar.bz2  list.info                   test11.awk                   test3.awk   test7.awk  var2.sh
备注：如果源目录后面跟"/"会将目录里的信息拷贝到目标目录，而不是整个目录

4.2 远程同步

　

语法如下：
Access via remote shell:
Pull:
  rsync [OPTION...] [USER@]HOST:SRC... [DEST]
Push:
  rsync [OPTION...] SRC... [USER@]HOST:DEST

案例1：将本地/root/scripts目录文件同步(上传)到远程192.168.138服务器/tmp目录，即push
# rsync -avc /root/scripts  root@192.168.138.22:/tmp
# 需要设置ssh免密登录

案例2：将远程192.168.138.22服务器/root/test目录同步(下载)到本地/tmp目录，即pull
[root@ansible tmp]# rsync -avz root@192.168.138.22:/root/test /tmp/
receiving incremental file list
test/
test/a.txt

sent 47 bytes  received 116 bytes  326.00 bytes/sec
total size is 0  speedup is 0.00

# 需要设置ssh免密登录

案例3：有时需要限制带宽同步数据，可以使用参数—bwlimit单位kb
[root@ansible ~]# rsync -avz --bwlimit=100 /root/tools/nginx-1.12.1.tar.gz root@192.168.138.21:/tmp/
sending incremental file list
nginx-1.12.1.tar.gz

sent 980,442 bytes  received 35 bytes  93,378.76 bytes/sec
total size is 981,093  speedup is 1.00 
[root@ansible ~]# ssh root@192.168.138.21 'ls /tmp/'
nginx-1.12.1.tar.gz
scripts
tmp.fXOl7QSk6X

4.3 以守护进程（socket）的方式传输数据

-- 服务端  192.168.138.20

配置文件
# vim /etc/rsyncd.conf
#用户
uid=rsync
#用户组  
gid=rsync
# 安全相关   
use chroot=no
#最大连接数    
max connections=200
#超时时间         
timeout=300
#进程对应的进程号文件             
pid file=/var/run/rsyncd.pid
#锁文件    
lock file=/var/run/rsync.lock
#日志文件      
log file=/var/log/rsync.log
# 模块名称       
[backup]
#服务器提供访问的目录 
path=/backup
# 忽略错误        
ignore errors
# 可写          
read only=false
# 客户端请求显示模块列表时，本模块名称是否显示        
list=false
#设置哪些主机可以同步数据，多ip和网段之间使用空格分隔             
hosts allow= 192.168.138.0/24
#除了hosts allow定义的主机外，拒绝其他所有
hosts deny=0.0.0.0/32
# 虚拟认证用户
auth users=rsync_backup
# 虚拟认证用户账号密码信息    
secrets file=/etc/rsync.password  

# 查看虚拟用户认证密码信息
[root@ansible ~]# cat /etc/rsync.password 
rsync_backup:123456
# 修改/etc/rsync.password权限
[root@ansible ~]# chmod 600 /etc/rsync.password 
[root@ansible ~]# ls -l /etc/rsync.password 
-rw------- 1 root root 20 10月  4 15:52 /etc/rsync.password

# 查看rsync --daemon 语法信息
[root@ansible ~]# rsync --daemon --help
rsync  version 3.1.2  protocol version 31
Copyright (C) 1996-2015 by Andrew Tridgell, Wayne Davison, and others.
Web site: http://rsync.samba.org/
Capabilities:
    64-bit files, 64-bit inums, 64-bit timestamps, 64-bit long ints,
    socketpairs, hardlinks, symlinks, IPv6, batchfiles, inplace,
    append, ACLs, xattrs, iconv, symtimes, prealloc

rsync comes with ABSOLUTELY NO WARRANTY.  This is free software, and you
are welcome to redistribute it under certain conditions.  See the GNU
General Public Licence for details.

Usage: rsync --daemon [OPTION]...
     --address=ADDRESS       bind to the specified address
     --bwlimit=RATE          limit socket I/O bandwidth
     --config=FILE           specify alternate rsyncd.conf file
 -M, --dparam=OVERRIDE       override global daemon config parameter
     --no-detach             do not detach from the parent
     --port=PORT             listen on alternate port number
     --log-file=FILE         override the "log file" setting
     --log-file-format=FMT   override the "log format" setting
     --sockopts=OPTIONS      specify custom TCP options
 -v, --verbose               increase verbosity
 -4, --ipv4                  prefer IPv4
 -6, --ipv6                  prefer IPv6
     --help                  show this help screen

# 启动 rsync
[root@ansible ~]# rsync --daemon
[root@ansible ~]# ps -ef|grep rsync|grep -v grep
root      1600     1  0 11:02 ?        00:00:00 rsync --daemon
# rsync daemon模式默认端口是873
[root@ansible ~]# netstat -lntp|grep 1600
tcp        0      0 0.0.0.0:873             0.0.0.0:*               LISTEN      1600/rsync          
tcp6       0      0 :::873                  :::*                    LISTEN      1600/rsync  


-- 客户端 192.168.138.21

1.需要安装rsync工具，若没有可yum安装
[root@ansb01 ~]# rpm -qa rsync
rsync-3.1.2-10.el7.x86_64
[root@ansb01 ~]# yum -y install rsync

2.添加虚拟认证密码信息

[root@ansb01 ~]# echo "123456" > /etc/rsync.password
[root@ansb01 ~]# cat /etc/rsync.password 
123456

3.修改权限
[root@ansb01 ~]# chmod 600 /etc/rsync.password 
[root@ansb01 ~]# ls -l /etc/rsync.password 
-rw------- 1 root root 7 10月  5 11:21 /etc/rsync.password


4.rsync daemon 语法格式
Access via rsync daemon:
    Pull:
        rsync [OPTION...] [USER@]HOST::SRC... [DEST]
        rsync [OPTION...] rsync://[USER@]HOST[:PORT]/SRC... [DEST]
    Push:
        rsync [OPTION...] SRC... [USER@]HOST::DEST
        rsync [OPTION...] SRC... rsync://[USER@]HOST[:PORT]/DEST)


案例1： 从客户端拉取服务端backup目录文件到本地/tmp
pull:
rsync [OPTION...] [USER@]HOST::SRC... [DEST]

USER：虚拟认证用户
HOST：服务器ip
SRC：/etc/rsyncd.conf配置文件中指定的模块名，比如[backup]

[root@ansb01 ~]# rsync -zva rsync_backup@192.168.138.20::backup /tmp
Password: 
receiving incremental file list
./
1.txt
10.txt
2.txt
3.txt
4.txt
5.txt
6.txt
7.txt
8.txt
9.txt

sent 221 bytes  received 600 bytes  49.76 bytes/sec
total size is 0  speedup is 0.00

# Password 为虚拟认证用户的密码 此处为123456


案例1客户端从服务端拉取文件时需要手动输入虚拟用户认证密码，由于客户端已经配置了虚拟用户认证密码，因此可以通过--password-file=FILE指定配置文件，读取认证密码，从而实现免密，如案例2
案例2：从客户端免密拉取服务端backup目录文件到本地/tmp
pull:
rsync [OPTION...] [USER@]HOST::SRC... [DEST]

[root@ansb01 ~]# rsync -zva rsync_backup@192.168.138.20::backup /tmp --password-file=/etc/rsync.password 
receiving incremental file list
./
1.txt
10.txt
2.txt
3.txt
4.txt
5.txt
6.txt
7.txt
8.txt
9.txt

sent 221 bytes  received 600 bytes  78.19 bytes/sec
total size is 0  speedup is 0.00
[root@ansb01 ~]# ls /tmp/ -l
总用量 0
-rw-r--r-- 1 root root 0 10月  5 11:35 10.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 1.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 2.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 3.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 4.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 5.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 6.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 7.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 8.txt
-rw-r--r-- 1 root root 0 10月  5 11:35 9.txt


案例3： 从客户端免密拉取服务端backup目录文件到本地/tmp
    Pull:
        rsync [OPTION...] rsync://[USER@]HOST[:PORT]/SRC... [DEST]

[root@ansb01 tmp]# rsync -avz rsync://rsync_backup@192.168.138.20/backup /tmp --password-file=/etc/rsync.password
receiving incremental file list
./
1.txt
10.txt
2.txt
3.txt
4.txt
5.txt
6.txt
7.txt
8.txt
9.txt
a
b
c
d
e
f
g

sent 359 bytes  received 1,078 bytes  124.96 bytes/sec
total size is 0  speedup is 0.00




案例4： 客户端推送src目录文件到服务端
Push:
        rsync [OPTION...] SRC... [USER@]HOST::DEST
SRC: 客户端目录或文件
USER： 虚拟认证用户
HOST: 服务端地址ip
DEST: /etc/rsyncd.conf配置文件中指定的模块名，比如[backup]

[root@ansb01 tmp]# rsync -azv /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
sending incremental file list
./
a
b
c
d
e
f
rsync: chgrp ".ICE-unix" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".Test-unix" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".X11-unix" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".XIM-unix" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".font-unix" (in backup) failed: Operation not permitted (1)
.ICE-unix/
.Test-unix/
.X11-unix/
.XIM-unix/
.font-unix/
rsync: chgrp ".a.fWKn0x" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".b.C3BWjg" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".c.kF8vDY" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".d.UB26WG" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".e.6hzIgp" (in backup) failed: Operation not permitted (1)
rsync: chgrp ".f.0McmA7" (in backup) failed: Operation not permitted (1)

sent 672 bytes  received 1,014 bytes  160.57 bytes/sec
total size is 0  speedup is 0.00
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(1179) [sender=3.1.2]
# 查看问题2
# 重启服务端后客户端重新同步
[root@ansb01 tmp]# rsync -azv /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
sending incremental file list
./
a
b
c
d
e
f
g
.ICE-unix/
.Test-unix/
.X11-unix/
.XIM-unix/
.font-unix/

sent 722 bytes  received 184 bytes  86.29 bytes/sec
total size is 0  speedup is 0.00

## 由此可以报错取消了


案例5：客户端推送src目录文件到服务端
    Push:
        rsync [OPTION...] SRC... rsync://[USER@]HOST[:PORT]/DEST)


[root@ansb01 tmp]# rsync -avz /tmp/ rsync://rsync_backup@192.168.138.20/backup --password-file=/etc/rsync.password
sending incremental file list
./
1.txt
10.txt
2.txt
3.txt
4.txt
5.txt
6.txt
7.txt
8.txt
9.txt
a
b
c
d
e
f
g

sent 1,063 bytes  received 355 bytes  135.05 bytes/sec
total size is 0  speedup is 0.00


案例6： 客户端排除单个文件上传 --exclude
[root@ansb01 tmp]# rsync -avz --exclude=1.txt /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
sending incremental file list
./
2.txt
3.txt
4.txt
5.txt

sent 407 bytes  received 108 bytes  49.05 bytes/sec
total size is 0  speedup is 0.00

案例7： 客户端排除多个文件上传 --exclude
1、
[root@ansb01 tmp]# rsync -avz --exclude={1.txt,2.txt} /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
sending incremental file list
./
3.txt
4.txt
5.txt

sent 355 bytes  received 89 bytes  42.29 bytes/sec
total size is 0  speedup is 0.00
2
[root@ansb01 tmp]# rsync -avz --exclude=1.txt --exclude=2.txt /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
sending incremental file list
./
3.txt
4.txt
5.txt

sent 355 bytes  received 89 bytes  42.29 bytes/sec
total size is 0  speedup is 0.00
3、有规律的范围 --exclude={1..3}.txt
[root@ansb01 tmp]# rsync -avz --exclude={1..3}.txt /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
sending incremental file list
./
4.txt
5.txt

4、指定排除文件 --exclude-from=文件路径
[root@ansb01 tmp]# cat /root/exclude.info 
1.txt
2.txt
[root@ansb01 tmp]# rsync -avz --exclude-from=/root/exclude.info /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
sending incremental file list
./
3.txt
4.txt
5.txt

sent 355 bytes  received 89 bytes  38.61 bytes/sec
total size is 0  speedup is 0.00


案例7： 无差异同步 --delete
rsync推送企业工作场景：push
数据备份
风险：客户端有啥，服务端就有啥，客户端没有的服务端也要删除。服务端的目录数据可能丢失

rsync拉取企业工作场景：pull
代码发布、下载
风险：服务端有啥，客户端就有啥，服务端没有的客户端也要删除。客户端的目录数据可能丢失




问题1：
[root@ansb01 ~]# rsync -zva rsync_backup@192.168.138.20::backup /tmp
rsync: failed to connect to 192.168.138.20 (192.168.138.20): No route to host (113)
rsync error: error in socket IO (code 10) at clientserver.c(125) [Receiver=3.1.2]
解决方案：
服务端端口没有打开，关闭服务端防火墙或者打开服务端873端口

问题2：
rsync: chgrp ".a.fWKn0x" (in backup) failed: Operation not permitted (1)
解决方案：
在服务端/etc/rsyncd.conf配置文件中加入 "fake super = yes",然后重启rsync服务

问题3：
[root@ansb01 tmp]# rsync -avz /tmp/ rsync_backup@192.168.138.20::backup --password-file=/etc/rsync.password
@ERROR: chdir failed
rsync error: error starting client-server protocol (code 5) at main.c(1649) [sender=3.1.2]

[root@ansible /]# cat /var/log/rsync.log 
2021/10/05 15:04:45 [1889] params.c:Parameter() - Ignoring badly formed line in config file: ignore errors
2021/10/05 15:04:55 [1889] name lookup failed for 192.168.138.21: Temporary failure in name resolution
2021/10/05 15:04:55 [1889] connect from UNKNOWN (192.168.138.21)
2021/10/05 15:04:55 [1889] rsync: chdir /backup failed
: No such file or directory (2)
解决方案：
服务端缺少目录 如/backup

问题4：
rsync: recv_generator: mkdir ".ICE-unix" (in backup) failed: Permission denied (13)
解决方案：
服务端uid用户没有指定目录操作权限，修改文件属主即可，例如
[root@ansible ~]# chown rsync /backup  -R

问题5：
2021/10/05 15:18:33 [1912] params.c:Parameter() - Ignoring badly formed line in config file: ignore errors
2021/10/05 15:18:43 [1912] name lookup failed for 192.168.138.21: Temporary failure in name resolution
2021/10/05 15:18:43 [1912] connect from UNKNOWN (192.168.138.21)
2021/10/05 15:18:43 [1912] secrets file must not be other-accessible (see strict modes option)
2021/10/05 15:18:43 [1912] auth failed on module backup from UNKNOWN (192.168.138.21) for rsync_backup: ignoring secrets file
解决方案：
密码文件权限问题，需要授权600
[root@ansible backup]# chmod 600 /etc/rsync.password



总结：
rsync server:
1.vim /etc/rsyncd.conf(用户，目录，模块，虚拟用户及密码文件)
2.创建共享目录 /backup_new
3.创建rsync用户，并授权访问/backup_new
4.创建密码文件，复制配置文件里的路径，然后添加密码内容
	格式： 虚拟用户名：密码

5.密码文件授权600
6.rsync --daemon 放入/etc/rc.local
7.查看日志 tailf /var/log/rsyncd.log


rsync client(多个)
1.密码文件和服务端没有任何关系
/etc/rsync.password 内容只有密码

2.密码文件 600