跳转至

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/

欢迎关注微信公众号: 运维录

Back to top