linux rsync配置文件参数详解

一、全局参数

在[moudle]之前的参数都是全局参数，也可以在全局参数下定义部分模块参数，这时该参数的值就是所有模块的默认值。

port：指定后台程序使用的端口号，默认是873

logfile:指定rsync的日志文件，而不把日志发送给syslog

pidfile:指定rsync的pid文件，通常指定为/var/run/rsyncd.pid

motdfile：用来指定一个消息文件，当客户连接服务器时，将该文件内容显示给客户，默认是没有该文件的

二、模块参数

主要定义服务器哪个目录需要被同步。其格式必须为[moudle]形式，这个名字是在rsync客户端看到的名字，而服务器真正同步的数据是通过path来指定的，我们可以通过根据自己的需要，来指定多个模块，模块中可以定义以下参数：

comment：给模块指定一个描述，该描述连同模块名在客户连接得到模块列表时显示给客户，默认是没有描述定义

path:指定该模块的供备份的目录树路径，该参数是必须指定的

use
chroot：如果“usechroot”指定为true，那么rsync在传输文件以前首先chroot到path参数所指定的目录下。这样做的原因是实现额外的安全防护，但是缺点是需要root权限，并且不能备份指向外部的符号连接所指向的目录文件，默认情况下chroot的值为true

uid：该选项指定当该模块传输文件时守护进程应该具有的uid，配合gid选项使用可以确定哪些可以访问怎么样的文件权限，默认值是“nobody”

gid：该选项指定当该模块传输文件时守护进程应该具有的gid，默认值是“nobody”

maxconnections：指定该模块的最大并发连接数量以保护服务器，超过限制的连接请求被告知随后再试。默认值是0，也就是没有限制。

list：该选项设定当客户请求可以使用的模块列表时，该模块是否应该被列出。如果该选项设置为false，可以创建隐藏的模块，默认值为true。

readonly：该选项设定是否允许客户上载文件，如果为true那么所有的上载请求都会失败，如果为false并且服务器目录读写权限允许那么上载是允许的，默认值为true。

exclude:用来指定多个空格隔开的多个文件或目录（相对路径），并将其添加到exclude列表中，这等同于在客户端的命令中使用-exclude来指定模式，一个模块只能指定一个exclude选项，但是需要注意的一点是该选项有一定的安全性问题，客户很有可能绕过exclude列表，如果希望保持特定的文件不能被访问，那就最好结合uid/gid一起使用。

excludefrom：指定一个包含exclude模式的定义的文件名，服务器从该文件中读取exclude列表定义

include：用来指定不排除符合要求的文件或目录，这等同于在客户端命令中使用-include来指定模式，结合include和exclude可以定义复杂的exclude/include规则

includefrom：指定一个包含include模式的定义的文件名，服务器从该文件中读取include列表定义。

authusers：该选项指定由空格或逗号分隔的用户列表，只有这些用户才允许连接该模块，这里的用户和系统用户没有任何关系，如果“authusers”被设置，那么客户端发出对该模块的连接请求以后会被rsync请求challenged进行验证身份，这里使用的challenge/response认证协议，用户的名和密码以明文方式存放在“secretfile”选项指定的文件中，默认情况下无需密码就可以连接模块，也就是匿名模式

secretsfile：该选项指定一个包含定义用户名：密码对的文件，只有在“authusers”被定义的时候，该文件才有作用，文件每行包含一个username:passwd对。一般来说密码最好不要超过8个字符。没有默认的securesfile名，需要限式指定一个(例如：/etc/rsyncd.passwd)。注意：该文件的权限一定要是600，否则客户端将不能连接服务器。

stickmodes：该选项指定是否监测密码文件的权限，如果该选项值为true，那么密码文件只能被rsync服务器运行身份的用户访问，其他任何用户不能访问该文件，默认值为true

hostsallow： 该选项指定哪些IP的客户允许连接该模块。客户模式定义可以是以下形式：

　　　　单个IP地址，例如：192.167.0.1

　　　　整个网段，例如：192.168.0.0/24，也可以是192.168.0.0/255.255.255.0

　多个IP或网段需要用空格隔开，“*”则表示所有，默认是允许所有主机连接。

hosts deny：指定不允许连接rsync服务器的机器，可以使用hosts allow的定义方式来进行定义。默认是没有hosts deny定义。

ignore errors：指定rsyncd在判断是否运行传输时的删除操作时忽略server上的IO错误，一般来说rsync在出现IO错误时将将跳过–delete操作，以防止因为暂时的资源不足或其它IO错误导致的严重问题。

ignorenonreadable：指定rsync服务器完全忽略那些用户没有访问权限的文件，这对于在需要备份的目录中有些文件所不应该被备份者得到的情况下是有意义的

lock file 指定支持maxconnections参数的锁文件，默认值是/var/run/rsyncd.lock。

transfer logging使rsync服务器使用ftp格式的文件来记录下载和上载操作在自己单独的日志中。

timeout通过该选项可以覆盖客户指定的IP超时时间。通过该选项可以确保rsync服务器不会永远等待一个崩溃的客户端。超时单位为秒钟，0表示没有超时定义，这也是默认值。对于匿名rsync服务器来说，一个理想的数字是600。

refuse options通过该选项可以定义一些不允许客户对该模块使用的命令参数列表。这里必须使用命令全名，而不能是简称。但发生拒绝某个命令的情况时服务器将报告错误信息然后退出。如果要防止使用压缩，应该是：”dont compress = *” 。

dont compress用来指定那些不进行压缩处理再传输的文件，默认值是*.gz *.tgz *.zip *.z *.rpm *.deb *.iso*.bz2 *.tbz