Rsync 服务与配置文档
2013-04-12 by dongnan
举个栗子
某项目rsync配置文档：
# cat /etc/rsyncd.conf
# 全局配置
log file = /var/log/rsyncd.log #日志文件
pid file = /var/run/rsyncd.pid #pid文件
lock file = /var/run/rsync.lock #支持max connections参数的锁文件
max connections = 100 #客户端最大连接数为100
use chroot = no #不使用chroot !!
uid = dongnan #服务器端传输文件时，要发哪个用户和用户组来执行；
gid = dongnan ###默认是nobody 用户和用户组
ignore errors #忽略一些无关的IO错误
list = no #不允许列文件
#address = 10.0.100.71 #监听的ip地址与端口号
#port = 873
motd file = /etc/rsyncd/rsyncd.motd #定义服务器信息，用户登录时会看到这个信息
# 模块配置
[htdocs] #模块名称
path = /data/htdocs/ #指定目录
comment = htdocs #注释
read only = yes #只读
auth users = dongnan #基于用户认证，如果没有这行则是匿名，多个用户用","分隔
secrets file = /etc/rsyncd.secrets #保存用户密码，格式如下 cat /etc/rsyncd.secrets
### dongnan:654321
[iso]
path = /data/iso/
comment = iso
read only = no #可写
hosts allow = 10.0.100.0/24 #基于IP地址认证，多个IP地址用空格" "分隔
注意： rsyncd.secrets 文件需要设置为600权限，命令如下：
chmod 600 /etc/rsyncd.secrets
测试
启动rsync服务：
rsync --daemon
rsync协议与端口：
grep -iE '^rsync' /etc/services
rsync 873/tcp # rsync
rsync 873/udp # rsync
推送数据到Rsync服务器端：
rsync -avzP perl 192.168.57.71::data/
rsync server for 10.0.100.0/24 or 192.168.57.0/24
#...省略
sent 82 bytes received 16 bytes 196.00 bytes/sec
total size is 368 speedup is 3.76
rsync 常用命令
语法：
rsync -av --progress <src-dir> <dst-dir>
服务器端同步到本地：
rsync -avz --progress user@10.0.0.2::test/ /u01/sphinx/
本地同步到服务器：
rsync -av --progress /data/yia_upload user@10.0.0.207::test/
同步时删除目标多余文件：
rsync -avz --progress --delete root@xen:/data/ /mnt/isolinux/
rsync 排除规则
示例1
如果想排除某个路径，直接添加--exclude 参数：
--exclude="proc"
--exclude="sources"
注意，这个路径必须是一个相对路径，不能是绝对路径。
示例2
将/home/test1中包含mysql开头的文件同步到/data/test1中，其他的文件忽略掉：
rsync -av --include=mysql* --exclude=* /home/test1/ /data/test1
注意，先用include参数，再用exclude参数。
示例3
只同步指定的文件类型，使用--exclude-from参数，指定一个规则文件：
--exclude-from="exclude.txt"
然后在 exclude.txt中填入过滤规则：
# "-"和后面的名字之间有一个空格
# 文件
- *abc*
# 目录
- DocumentRoot/upload/
- .git
- _LOG
- _LOCAL
- _TEMPLATE_C
注意，-表示排除，如果想排除多个文件，那么可以继续添加一行，最后一行最好留一个空行。
rsync 设置读写
rsync某目录，指定IP可以读写，其它IP只能读。
一个目录对应两个模块，一个模块读写，另一个模块只读。
配置文件
log file = /var/log/rsyncd.log
pid file = /var/run/rsyncd.pid
lock file = /var/run/rsync.lock
max connections = 100
use chroot = no
uid = nobody
gid = nobody
list = no
[app]
path = /data/app/
comment = app
read only = yes
hosts allow = 172.27.233.0/24
[pre]
path = /data/app/
comment = app
read only = no
hosts allow = 172.27.233.42
测试
IP为172.27.233.42：
rsync -avP install.log rsync://172.27.233.41/pre/
sending incremental file list
sent 32 bytes received 8 bytes 80.00 bytes/sec
total size is 9723 speedup is 243.07
rsync -avP rsync://172.27.233.41/pre/
receiving incremental file list
drwxr-xr-x 4096 2014/05/19 14:47:30 .
-rw-r--r-- 9723 2013/11/29 19:45:57 install.log
其它的IP：
rsync -avP rsync://172.27.233.41/pre/
@ERROR: Unknown module 'pre'
rsync error: error starting client-server protocol (code 5) at main.c(1503) [receiver=3.0.6]
rsync -avP rsync://172.27.233.41/app/
receiving incremental file list
drwxr-xr-x 4096 2014/05/19 17:07:22 .
-rw-r--r-- 9723 2013/11/29 19:45:57 install.log
命令参数
Rsync 参数选项说明：
-v, --verbose 详细模式输出
-q, --quiet 精简输出模式
-c, --checksum 打开校验开关，强制对文件传输进行校验
-a, --archive 归档模式，表示以递归方式传输文件，并保持所有文件属性，等于-rlptgoD
-r, --recursive 对子目录以递归模式处理
-R, --relative 使用相对路径信息
-b, --backup 创建备份，也就是对于目的已经存在有同样的文件名时，将老的文件重新命名为~filename。
--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的shell程序
--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 显示帮助信息
小结
rsync模块配置灵活，基于IP地址认证或者基于用户认证，可以根据实际需求配置。
参考
- http://os.51cto.com/art/201006/203217.htm
- http://www.ibm.com/developerworks/cn/linux/l-cn-chroot/