windows下安装和配置rsync(cwRsync)
第一步我们先安装服务端:
下载完西西提供的整合包,里面有一个服务器的安装程序和一个绿色的客户端
我们先双击 cwRsyncServer_4.1.0_Installer.exe 来安装
到这一步的时候,他会提示您帮你新建一个用于同步的 Rsync的系统账号,当然你也可以自定义用户名和密码。
安装完成后rsync会加载以服务的方式来运行。
在 windows的服务中我们可以看到一个 RsyncServer 的服务,安装后他默认是停止的您可以手动启动,最好把启动类型设为 自动 这样下次如果服务器重启这个软件也会自动启动了。
我们现在来说一下如何配置服务器文件。 在您的安装目录下可以找到一个 rsyncd.conf 的配置文件,这个文件和linux下面一样,您也可以在开始菜单中找到这个文件的链接
我们先来配置一下:
use chroot = false
strict modes = false
lock file = rsyncd.lock
hosts allow = 192.168.1.21
max connections = 5port = 28950
gid = 0
uid = 0
log file = /cygdrive/f/RsyncLog/rsyncd.log# Module definitions
# Remember cygwin naming conventions : c:/work becomes /cygdrive/c/work
[cr173com]
path = /cygdrive/d/cr173/
secrets file = /cygdrive/e/Setting/Rsync/rsync_db.PS
read only = no
list = no
transfer logging = yes
以上配置只允许192.168.1.21 访问,这里按需修改。 如果需要添加多个IP 单个IP地址,例如:192.167.1.1 整个网段,例如:192.168.1.0/24,也可以是192.168.1.0/255.255.255.0
多个IP或网段需要用空格隔开,“*”则表示所有,默认是允许所有主机连接。
strict modes = false 不验证用户密码,
pid = 0,uid = 0 指定匿名访问。
auth users 指访问data_backup的用户名
secrets file data_backup用户名对应的密码文件。
path:指定同步的文件目录
use chroot:如果"use chroot"指定为true,那么rsync在传输文件以前首先chroot到path参数所指定的目 录下。这样做的原因是实现额外的安全防护,但是缺点是需要以roots权限,并且不能备份指向外部的符号连接所指向的目录文件。默认情况下chroot值为true。
numeric ids
munge symlinks
charset
max connections:指定该模块的最大并发连接数量以保护服务器,超过限制的连接请求将被告知随后再试。默认值是0,也就是没有限制。
log file:指定rsync的日志文件
syslog facility:是否使用系统日志工具。可以有如下选项:
auth, authpriv, cron, daemon, ftp, kern, lpr, mail, news, security, syslog, user, uucp, local0, local1, local2, local3, local4, local5, local6 and local7. The default is daemon.
max verbosity
lock file:指定支持max connections参数的锁文件
read only:该选项设定是否允许客户上载文件。如果为true那么任何上载请求都会失败,如果为false并且服务器目录读写权限允许那么上载是允许的。默认值为true。
write only:该选项设定是否允许客户下载文件。如果为true那么任何下载请求都会失败,如果为false并且服务器目录读写权限允许那么下载是允许的。默认值为true。
list:该选项设定当客户请求可以使用的模块列表时,该模块是否应该被列出。如果设置该选项为false,可以创建隐藏的模块。默认值是true。
uid:指定传送数据的帐号,仅仅用于指定模块。默认是:-2 ,即Nobody 帐号.
gid:指定传送数据的帐号组,仅仅用于指定模块。默认是:-2 ,即Nobody 组.
fake super
filter
exclude:用来指定多个由空格隔开的多个文件或目录(相对路径),并将其添加到exclude列表中。这等同于在客户端命令中使用--exclude来指定模式,一个模块只能指定一个exclude选项。但是需要注意的一点是该选项有一定的安全性问题,客户很有可能绕过exclude列表,如果希望确保特定的文件不能被访问,那就最好结合uid/gid选项一起使用。
include:用来指定不排除符合要求的文件或目录。这等同于在客户端命令中使用--include来指定模式,结合include和exclude可以定义复杂的exclude/include规则。
exclude from:指定一个包含exclude模式的定义的文件名,服务器从该文件中读取exclude列表定义。
include from:指定一个包含include模式的定义的文件名,服务器从该文件中读取include列表定义。
incoming chmod:
outgoing chmod
auth users:设置连接指定模块的授权用户名。
secrets file:密码认证文件,格式为:username:password
strict modes:该选项指定是否监测密码文件的权限,如果该选项值为true那么密码文件只能被rsync服务器运行身份的用户访问,其他任何用户不可以访问该文件。默认值为true。
hosts allow:该选项指定哪些IP的客户允许连接该模块。客户模式定义可以是以下形式:
单个IP地址,例如:192.167.1.1
整个网段,例如:192.168.1.0/24,也可以是192.168.1.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服务器完全忽略那些用户没有访问权限的文件。这对于在需要备份的目录中有些文件是不应该被备份者得到的情况是有意义的。
transfer logging:使rsync服务器使用ftp格式的文件来记录下载和上载操作在自己单独的日志中。
log format:通过该选项用户在使用transfer logging可以自己定制日志文件的字段。
#The single-character escapes that are understood are as follows:
#%a the remote IP address
#%b the number of bytes actually transferred
#%B the permission bits of the file (e.g. rwxrwxrwt)
#%c the total size of the block checksums received for the basis file (only when sending)
#%f the filename (long form on sender; no trailing "/")
#%G the gid of the file (decimal) or "DEFAULT"
#%h the remote host name
#%i an itemized list of what is being updated
#%l the length of the file in bytes
#%L the string " -> SYMLINK", " => HARDLINK", or "" (where SYMLINK or HARDLINK is a filename)
#%m the module name
#%M the last-modified time of the file
#%n the filename (short form; trailing "/" on dir)
#%o the operation, which is "send", "recv", or "del." (the latter includes the trailing period)
#%p the process ID of this rsync session
#%P the module path
#%t the current date time
#%u the authenticated username or an empty string
#%U the uid of the file (decimal)
#For a list of what the characters mean that are output by "%i", see the --itemize-changes option in the rsync manpage.
timeout:该选项可以覆盖客户指定的IP超时时间。通过该选项可以确保rsync服务器不会永远等待一个崩溃的客户端。超时单位为秒钟,0表示没有超时定义,这也是默认值。对于匿名rsync服务器来说,一个理想的数字是600。
refuse options:通过该选项可以定义一些不允许客户对该模块使用的命令参数列表。这里必须使用命令全名,而不能是简称。但发生拒绝某个命令的情况时服务器将报告错误信息然后退出。如果要防止使用压缩,应该是:"dont compress = *"。
dont compress:指定那些不进行压缩处理再传输的文件,默认值是*.gz *.tgz *.zip *.z *.rpm *.deb *.iso *.bz2 *.tbz
以上为rsync 官方的关于rsync配置文件中的所有配置选项。中文是我自己翻译解释的,有些选项还没翻译解释,主要是因为还没有完全理解透彻官方的英文解释。
root:root
admin:12345
用户名:密码,一行一个,有的系统不支持长密码,另个密码文件的权限对其它用户组是不可读的,设置错了可能不工作。在Windows下,密码文件的访问权限一定要设置正确,不然用户验证的时候通不过。应将密码文件E:/Setting/Rsync/rsync_db.ps的权限加入Rsycn服务运行服务的用户名 cwRsyncServer 的读取权限 及 设置其为该文件为所有者。
4. 在服务管理器中,找到服务 RsyncServer 服务,并启动服务。
5. 如果开启了防火墙,则防火墙R规则中要添加Tcp端口 28950 允许通信。
6. 服务验证,打开dos命令框,输入telnet 192.168.1.20 28950 (如果没有安装telnet服务端与客户端,请在控制面板->添加删除程序->打开关闭windows功能中找到Telnet客户端和服务端,勾选进行安装)。如果telnet能成功连接,出现@RSYNCD: 30.0 等类似文字,则说明服务启动正常。
1. 安装Rsync客户端程序,直至安装完成。西西提供的是绿色版本;
2. 测试服务器Rsync的连通性。在Rsync客户端所在计算机telnet Rsync服务端所在计算的相应地址和端口
telnet 192.168.1.20 28950
出现@RSYNCD: 30.0 等类似文字,则说明客户端连接服务端正常。
3. 打开Dos命令窗口,进到Rsync客户端安装目录的bin目录下,如:C:/Program Files/cwRsync/bin/。输入以下命令,开始进行同步:
rsync --port=28950 -vzrtopg --progress --delete 192.168.1.20::data_backup /cygwin/f/dataBackup --password-file=/cygdrive/e/Setting/Rsync/rsync_db.ps
--port=28950 # 端口-vzrtopg --progress # 显示同步过程详细信息--delete # 从客户端目录中删除与服务端目录中不同的数据,保证两边数据完全一致/cygwin/f/dataBackup # Window下目录F:/dataBackupdata_backup # 服务端配置文件rsyncd.conf文件中定义的模块名称192.168.1.20 # Rsync服务端IP地址
设置该命令文件的用户需要添加密码文件的读取权限及加其为文件所有者。如下:
官方的英文解释:
-v, --verbose 详细模式输出
-q, --quiet 精简输出模式
-c, --checksum 打开校验开关,强制对文件传输进行校验
-a, --archive 归档模式,表示以递归方式传输文件,并保持所有文件属性,等于-rlptgoD
-r, --recursive 对子目录以递归模式处理
-R, --relative 使用相对路径信息
-b, --backup 创建备份,也就是对于目的已经存在有同样的文件名时,将老的文件重新命名为~filename。可以使用--suffix选项来指定不同的备份文件前缀。
--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、ssh方式进行数据同步
--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 显示帮助信息
新建命令执行文件C:/Program Files/cwRsync/bin/SyncDB_NoAuth.cmd。将以下命令保存到该文件中:
rsync --port=28950 -vzrtopg --progress --delete 192.168.1.20::data_backup /cygwin/f/dataBackup --password-file=/cygdrive/e/Setting/Rsync/rsync_db.ps
windows xp/Server 2003 : 开始->设置->控制面板->任务计划->打开添加任务计划->下一步
windows 7/Server 2008 : 开始-> 控制面板 -> 管理工具 -> 任务计划
@ERROR: invalid uid nobody
rsync error: error starting client-
解决办法:在rsyncd.conf文件中添加下面两行即可解决问题
uid = 0
gid = 0
错误1: rsync: read error: Connection reset by peer (104)
rsync error: error in rsync protocol data stream (code 12) at io.c(794) [receive r=3.0.2]
解决:很大可能是服务器端没有开启 rsync 服务。开启服务。
错误2:@ERROR: chdir failed
rsync error: error starting client-server protocol (code 5) at main.c(1495) [receiver=3.0.2]
解决:服务器端同步目录没有权限,cwrsync默认用户是Svcwrsync。为同步目录添加用户Svcwrsync权限。
错误3:@ERROR: failed to open lock file
rsync error: error starting client-server protocol (code 5) at main.c(1495) [receiver=3.0.2]
解决:配置文件 rsync.conf中添加 lock file = rsyncd.lock 即可解决。
错误4: rsync: could not open password file "/cygwin/e/Setting/Rsync/rsync_db.pwd": No such file or directory (2)
解决:密码文件的目录一定要存在,而且要用POSIX风格的写法:/cygdrive/e/Setting/Rsync/rsync_db.pwd
错误5:@ERROR: auth failed on module data_backup rsync error: error starting client-server protocol (code 5) at main.c(1506) [Receiver=3.0.7]
解决:密码错误,输入正确的密码即可。用户名和密码如果都正确,可能是远程rsync服务器的帐户密码文件的权限必须为600。
错误6: password file must not be other-accessible
解决:这是因为rsyncd.pwd rsyncd.sec的权限不对,应该设置为600。如:chmod 600 rsyncd.pwd, Windows下应将密码文件的所有者改成程序运行的用户。
错误7:@ERROR: invalid uid nobody . rsync error: error starting client-server protocol (code 5) at main.c(1506) [Receiver=3.0.7]
解决:在rsyncd.conf文件中添加下面两行即可
uid = 0
gid = 0
问题8: @ERROR: chroot failed
rsync error: error starting client-server protocol (code 5) at main.c(1522) [receiver=3.0.3]
原因:服务器端的目录不存在或无权限。创建目录并修正权限可解决问题。
问题9:@ERROR: Unknown module ‘tee_nonexists’
rsync error: error starting client-server protocol (code 5) at main.c(1522) [receiver=3.0.3]
原因:服务器不存在指定模块。提供正确的模块名或在服务器端修改成你要的模块以解决问题。
问题10:rsync: failed to connect to 218.107.243.2: No route to host (113)
rsync error: error in socket IO (code 10) at clientserver.c(104) [receiver=2.6.9]
原因:对方没开机、防火墙阻挡、通过的网络上有防火墙阻挡,都有可能。关闭防火墙,其实就是把tcp udp的873或者指定的rsync端口打开。
问题11:rsync error: error starting client-server protocol (code 5) at main.c(1524) [Receiver=3.0.7]
原因:/etc/rsyncd.conf配置文件内容有错误。请正确核对配置文件。
问题12:rsync: chown "" failed: Invalid argument (22)
原因:权限无法复制。去掉同步权限的参数即可。(这种情况多见于Linux向Windows的时候)
问题13:@ERROR: daemon security issue -- contact admin
rsync error: error starting client-server protocol (code 5) at main.c(1530) [sender=3.0.6]
原因:同步的目录里面有软连接文件,需要服务器端的/etc/rsyncd.conf打开use chroot = yes。掠过软连接文件。
问题14:rsync: read error: Connection reset by peer (104)
rsync error: error in rsync protocol data stream (code 12) at io.c(794) [receiver=3.0.2]
解决:很大可能是服务器端没有开启 rsync 服务,开启服务。