rsync命令参数详解

rsync的命令格式可以为以下六种：

1 rsync [OPTION]... SRC DEST
2 rsync [OPTION]... SRC [USER@]HOST:DEST
3 rsync [OPTION]... [USER@]HOST:SRC DEST
4 rsync [OPTION]... [USER@]HOST::SRC DEST
5 rsync [OPTION]... SRC [USER@]HOST::DEST
6 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

ubuntu安装rsync:

sudo apt-get install rsync xinetd

rsync参数的具体解释如下：

1 -v, --verbose 详细模式输出
 2 -q, --quiet 精简输出模式
 3 -c, --checksum 打开校验开关，强制对文件传输进行校验
 4 -a, --archive 归档模式，表示以递归方式传输文件，并保持所有文件属性，等于-rlptgoD
 5 -r, --recursive 对子目录以递归模式处理
 6 -R, --relative 使用相对路径信息
 7 -b, --backup 创建备份，也就是对于目的已经存在有同样的文件名时，将老的文件重新命名为~filename。可以使用--suffix选项来指定不同的备份文件前缀。
 8 --backup-dir 将备份文件(如~filename)存放在在目录下。
 9 -suffix=SUFFIX 定义备份文件前缀
10 -u, --update 仅仅进行更新，也就是跳过所有已经存在于DST，并且文件时间晚于要备份的文件。(不覆盖更新的文件)
11 -l, --links 保留软链结
12 -L, --copy-links 想对待常规文件一样处理软链结
13 --copy-unsafe-links 仅仅拷贝指向SRC路径目录树以外的链结
14 --safe-links 忽略指向SRC路径目录树以外的链结
15 -H, --hard-links 保留硬链结
16 -p, --perms 保持文件权限
17 -o, --owner 保持文件属主信息
18 -g, --group 保持文件属组信息
19 -D, --devices 保持设备文件信息
20 -t, --times 保持文件时间信息
21 -S, --sparse 对稀疏文件进行特殊处理以节省DST的空间
22 -n, --dry-run现实哪些文件将被传输
23 -W, --whole-file 拷贝文件，不进行增量检测
24 -x, --one-file-system 不要跨越文件系统边界
25 -B, --block-size=SIZE 检验算法使用的块尺寸，默认是700字节
26 -e, --rsh=COMMAND 指定使用rsh、ssh方式进行数据同步
27 --rsync-path=PATH 指定远程服务器上的rsync命令所在路径信息
28 -C, --cvs-exclude 使用和CVS一样的方法自动忽略文件，用来排除那些不希望传输的文件
29 --existing 仅仅更新那些已经存在于DST的文件，而不备份那些新创建的文件
30 --delete 删除那些DST中SRC没有的文件
31 --delete-excluded 同样删除接收端那些被该选项指定排除的文件
32 --delete-after 传输结束以后再删除
33 --ignore-errors 及时出现IO错误也进行删除
34 --max-delete=NUM 最多删除NUM个文件
35 --partial 保留那些因故没有完全传输的文件，以是加快随后的再次传输
36 --force 强制删除目录，即使不为空
37 --numeric-ids 不将数字的用户和组ID匹配为用户名和组名
38 --timeout=TIME IP超时时间，单位为秒
39 -I, --ignore-times 不跳过那些有同样的时间和长度的文件
40 --size-only 当决定是否要备份文件时，仅仅察看文件大小而不考虑文件时间
41 --modify-window=NUM 决定文件是否时间相同时使用的时间戳窗口，默认为0
42 -T --temp-dir=DIR 在DIR中创建临时文件
43 --compare-dest=DIR 同样比较DIR中的文件来决定是否需要备份
44 -P 等同于 --partial
45 --progress 显示备份过程
46 -z, --compress 对备份的文件在传输时进行压缩处理
47 --exclude=PATTERN 指定排除不需要传输的文件模式
48 --include=PATTERN 指定不排除而需要传输的文件模式
49 --exclude-from=FILE 排除FILE中指定模式的文件
50 --include-from=FILE 不排除FILE指定模式匹配的文件
51 --version 打印版本信息
52 --address 绑定到特定的地址
53 --config=FILE 指定其他的配置文件，不使用默认的rsyncd.conf文件
54 --port=PORT 指定其他的rsync服务端口
55 --blocking-io 对远程shell使用阻塞IO
56 -stats 给出某些文件的传输状态
57 --progress 在传输时现实传输过程
58 --log-format=formAT 指定日志文件格式
59 --password-file=FILE 从FILE中得到密码
60 --bwlimit=KBPS 限制I/O带宽，KBytes per second
61 -h, --help 显示帮助信息

rsync认证方式：

rsync有两种常用的认证方式，一种是rsync-daemon方式，另外一种是ssh方式。

在平时使用过程，我们使用最多的是rsync-daemon方式。

注意：在使用rsync时，服务器和客户端都必须安装rsync程序。

rsync在rsync-daemon认证方式下，默认监听TCP的873端口。

rsync-daemon认证方式是rsync的主要认证方式，这个也是我们经常使用的认证方式。
并且也只有在此种模式下，rsync才可以把密码写入到一个文件中。同步时使用--password-file=密码文件参数认证。

注意：创建的密码文件权限需为600，密码直接写入即可。

注意：
rsync-daemon认证方式，需要服务器和客户端都安装rsync服务
并且只需要rsync服务器端启动rsync，同时配置rsync配置文件。
客户端启动不启动rsync服务，都不影响同步的正常进行。

rsync服务端配置：

编辑rsync.conf文件，不存在则创建

注意：编辑完以后文件权限改为600

vim /etc/rsync.conf
#ubuntu2204的配置文件名为rsyncd.conf
#ubuntu2204在/usr/share/doc/rsync/examples/rsyncd.conf 有一份配置文件，可将其拷贝至/etc修改
vim /etc/rsyncd.conf

#全局值
uid = rsync                         #指定rsync进程以什么用户身份在后台运行（必须是系统用户）
gid = rsync

port = 873                          #指定端口，默认873
fake super = yes                    #无需让rsync以root身份运行，允许接收文件的完整属性
use chroot = no                     #是否将用户锁定在家目录中
max connections = 100               #最大连接数
timeout = 100                       #超时时间
list = false                        #不允许查看模块信息
use chroot = no                     #禁锢推送的数据至某个目录, 不允许跳出该目录
pid file = /var/lock/rsync.pid      #指定rsync进程的pid文件的路径和名称
lock file = /var/lock/rsync.lock
log file = /var/log/rsync.log
ignore errors                       #忽略错误

[mod1]                              #模块名称
comment = commit                    #模块注释信息
path = /rsync/web1                  #备份目录位置
read only = false                   #对备份数据可读写
hosts allow = 10.0.0.0/8            #服务器端地址或可访问该模块的地址
auth users = vuser1                 #用户跟系统用户没有任何关系，多个用户使用空格隔开
secrets file = /rsync/rsync.passwd  #用户密码文件，格式： user:passwd  一个用户占一行
list = false

[mod2]
path = /rsync/web2
read only = false
hosts allow = 10.0.0.0/8
auth users = vuser2
secrets file = /rsync/rsync.passwd
list = false