[root@backup ~]# cat /etc/rsyncd.conf #rsync_config---start uid = rsync #用户远端的命令使用rsync访问共享目录 gid = rsync #用户组 use chroot = no #安全相关 max connections = 200 #最大连接数 timeout = 300 #超时时间 pid file = /var/run/rsyncd.pid #进程对应的进程id lock file = /var/run/rsync.lock #锁文件 log file = /var/log/rsyncd.log #日志文件 [backup] #模块名称 path = /backup #服务器提供访问的目录 ignore errors #忽略错误 read only = false #可写 list = false #不能列表 hosts allow = 192.168.10.0/24 #允许IP访问 hosts deny = 0.0.0.0/32 #禁止IP访问 auth users = rsync #虚拟用户 secrets file=/etc/rsync.password #虚拟账户用户和密码 [logbackup] #模块名称 path = /logbackup #服务器提供访问的目录 ignore errors #忽略错误 read only = false #可写 list = false #不能列表 hosts allow = 192.168.10.0/24 #允许IP访问 hosts deny = 0.0.0.0/32 #禁止IP访问 auth users = rsync #虚拟用户 secrets file=/etc/rsync.password #虚拟账户用户和密码 #rsync_config---end [root@backup ~]#
全局参数
在文件中[module]之前的所有参数都是全局参数，当然也可以在全局参数部分定义模块参数，这时候该参数的值就是所有模块的默认值。
port
- 指定后台程序使用的端口号，默认为873。
motd file
- "motd file"参数用来指定一个消息文件
- 当客户连接服务器时该文件的内容显示给客户
- 默认是没有motd文件的
log file
- 指定rsync的日志文件，而不将日志发送给syslog
- 比如可指定为“/var/log/rsyncd.log”
pid file
- 指定rsync的pid文件
- 通常指定为“/var/run/rsyncd.pid”
syslog facility
- 指定rsync发送日志消息给syslog时的消息级别
- 常见的消息级别是：uth, authpriv, cron, daemon, ftp, kern, lpr, mail, news, security, sys-log, user, uucp, local0, local1, local2, local3, local4, local5, local6和local7
- 默认值是daemon。
模块参数
- 主要是定义服务器哪个目录要被同步
- 其格式必须为“[module]”形式，这个名字就是在rsync 客户端看到的名字
- 而服务器真正同步的数据是通过 path 来指定的
- 我们可以根据自己的需要，来指定多个模块
comment
- 给模块指定一个描述
- 该描述连同模块名在客户连接得到模块列表时显示给客户
- 默认没有描述定义。
path
- 指定该模块的供备份的目录树路径
- 该参数是必须指定的
use chroot
- 如果"use chroot"指定为true，那么rsync在传输文件以前首先chroot到path参数所指定的目录下。
- 这样做的原因是实现额外的安全防护，但是缺 点是需要以root权限，并且不能备份指向外部的符号连接所指向的目录文件
- 默认情况下chroot值为true
uid
- 该选项指定当该模块传输文件时守护进程应该具有的uid
- 配合gid选项使用可以确定哪些可以访问怎么样的文件权限
- 默认值是"nobody"
gid
- 该选项指定当该模块传输文件时守护进程应该具有的gid
- 默认值为"nobody"
max connections
- 指定该模块的最大并发连接数量以保护服务器，超过限制的连接请求将被告知随后再试
- 默认值是0，也就是没有限制
list
- 该选项设定当客户请求可以使用的模块列表时，该模块是否应该被列出
- 如果设置该选项为false，可以创建隐藏的模块
- 默认值是true
read only
- 该选项设定是否允许客户上载文件
- 如果为true那么任何上载请求都会失败
- 如果为false并且服务器目录读写权限允许那么上载是允许的
- 默认值为true。
exclude
- 用来指定多个由空格隔开的多个文件或目录(相对路径)，并将其添加到exclude列表中
- 这等同于在客户端命令中使用--exclude来指定模式，一个 模块只能指定一个exclude选项
- 但是需要注意的一点是该选项有一定的安全性问题，客户很有可能绕过exclude列表
- 如果希望确保特定的文件不能 被访问，那就最好结合uid/gid选项一起使用
exclude from
- 指定一个包含exclude模式的定义的文件名
- 服务器从该文件中读取exclude列表定义
include
- 用来指定不排除符合要求的文件或目录
- 这等同于在客户端命令中使用--include来指定模式
- 结合include和exclude可以定义复杂的exclude/include规则
include from
- 指定一个包含include模式的定义的文件名
- 服务器从该文件中读取include列表定义
auth users
- 该选项指定由空格或逗号分隔的用户名列表，只有这些用户才允许连接该模块
- 这里的用户和系统用户没有任何关系
- 如果"auth users"被设置，那么客户端发出对该模块的连接请求以后会被rsync请求challenged进行验证身份这里使用的 challenge/response认证协议
- 用户的名和密码以明文方式存放在"secrets file"选项指定的文件中
- 默认情况下无需密码就可以连接模块(也就是匿名方式)
secrets file
- 该选项指定一个包含定义用户名:密码对的文件
- 只有在"auth users"被定义时，该文件才有作用
- 文件每行包含一个username:passwd对
- 一般来说密码最好不要超过8个字符
- 没有默认的 secures file名，需要限式指定一个(例如：/etc/rsyncd.passwd)
- 注意：该文件的权限一定要是600，否则客户端将不能连接服务器
strict modes
- 该选项指定是否监测密码文件的权限
- 如果该选项值为true那么密码文件只能被rsync服务器运行身份的用户访问，其他任何用户不可以访问该文件
- 默认值为true
hosts allow
- 该选项指定哪些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错误导致的严重问题
ignore nonreadable
- 指定rysnc服务器完全忽略那些用户没有访问权限的文件
- 这对于在需要备份的目录中，有些文件是不应该被备份者得到的
lock file
- 指定支持max connections参数的锁文件
- 默认值是/var/run/rsyncd.lock
transfer logging
- 使rsync服务器使用ftp格式的文件来记录下载和上载操作在自己单独的日志中
log format
- 通过该选项用户在使用transfer logging可以自己定制日志文件的字段
- 其格式是一个包含格式定义符的字符串，格式定义符如下所示：
- %h 远程主机名
- %a 远程IP地址
- %l 文件长度字符数
- %p 该次rsync会话的进程id
- %o 操作类型："send"或"recv"
- %f 文件名
- %P 模块路径
- %m 模块名
- %t 当前时间
- %u 认证的用户名(匿名时是null)
- %b 实际传输的字节数
- %c 当发送文件时，该字段记录该文件的校验码
- 默认log格式为："%o %h [%a] %m (%u) %f %l"
- 一般来说,在每行的头上会添加"%t [%p] "
- 在源代码中同时发布有一个叫rsyncstats的perl脚本程序来统计这种格式的日志文件
timeout
- 通过该选项可以覆盖客户指定的IP超时时间
- 通过该选项可以确保rsync服务器不会永远等待一个崩溃的客户端
- 超时单位为秒钟，0表示没有超时定义，这也是默认值
- 对于匿名rsync服务器来说，一个理想的数字是600
refuse options
- 通过该选项可以定义一些不允许客户对该模块使用的命令参数列表
- 这里必须使用命令全名，而不能是简称
- 但发生拒绝某个命令的情况时服务器将报告错误信息然后退出
- 如果要防止使用压缩，应该是："dont compress = *"
dont compress
- 用来指定那些不进行压缩处理再传输的文件
- 默认值是*.gz *.tgz *.zip *.z *.rpm *.deb *.iso *.bz2 *.tbz