windows rsync 服务器端客户端下载安装配置详解，推，拉

我就是我 2022-04-12 08:51 1840阅读 0赞

Rsync是一款不错的文件免费同步软件，可以镜像保存整个目录树和文件系统，同时保持原来文件的权限、时间、软硬链接。第一次同步时 rsync 会复制全部内容，下次只传输修改过的文件部分。传输数据过程中可以实行压缩及解压缩操作，减少带宽流量。支持scp、ssh及直接socket方式连接,支持匿名传输。支持Linux,Window平台。

官网：[http://rsync.samba.org/][http_rsync.samba.org]  
Linux版下载：[http://rsync.samba.org/download.html][http_rsync.samba.org_download.html]  
Windows版下载：[https://www.itefix.net/cwrsync][https_www.itefix.net_cwrsync]

新版的收费了，附件提供4.0.5的下载，貌似新版的才有64位的

服务器端：cwRsyncServer\_4.0.5\_Installe.zip

客户端：cwRsync\_4.0.5\_Installer.zip

安装完后的文档

服务器端：ICW\\doc\\\*.html

客户端：cwRsync\\doc\\\*.html

**同步方式**

拉：客户端从服务器端把文件拉过来

推：客户端把文件推送到服务器端

推荐采用推的方式，以便以后实现准实时同步

**环境：**

服务器端

Windows Server 2008 R2 x64

192.168.1.82

防火墙需打开端口 873（默认）

客户端

Windows Server 2008 R2 x64

192.168.1.81

**一、服务器端安装**

1.下一步  
![format_png][]

2.同意  
![format_png 1][]

3.默认路径就可以  
![format_png 2][]

4.默认用户就可以，

他会建一个SvcCWRSYNC的用户，请允许

这也可以指定其他的操作系统用户及密码，没必要  
![format_png 3][]

5.关闭  
![format_png 4][]

6.他建的用户  
![format_png 5][]

7.建的服务，请配置成自动，并且启动  
![format_png 6][]

**二、客户端安装**

1.下一步  
![format_png 7][]

2.同意  
![format_png 8][]

3.下一步  
![format_png 9][]

4.默认路径就可以  
![format_png 10][]

5.关闭  
![format_png 11][]

**三、服务器端配置**

默认配置rsyncd.conf

use chroot = false
    strict modes = false
    hosts allow = *
    log file = rsyncd.log
    
    # Module definitions
    # Remember cygwin naming conventions : c:\work becomes /cygwin/c/work
    #
    [test]
    path = /cygdrive/c/work
    read only = false
    transfer logging = yes

修改后

use chroot = false
    strict modes = false
    hosts allow = 192.168.1.81
    log file = rsyncd.log
    #用户
    uid = 0
    #用户组
    gid = 0
    #端口
    port = 873
    
    # Module definitions
    # Remember cygwin naming conventions : c:\work becomes /cygwin/c/work
    #
    [test] #模块名
    path = /cygdrive/d/rsyncTest
    read only = false
    transfer logging = yes
    #不配置以下两项，不用用户名密码就可以同步
    auth users = rsyncuser
    secrets file = /cygdrive/c/etc/rsyncd.secrets

加入uid，pid，port，

path，要同步的目录

注意，要把/cygwin 改为 **/cygdrive**

/cygdrive/d/rsyncTest D盘下的rsyncTest目录，在这个文件夹下建个测试文件 测试.txt

这个目录要给SvcCWRSYNC用户配置权限，除完全控制和特殊权限外的所有权限

也可通过 菜单--cwRsyncServer--02. Prep a Dir for Upload 设置目录权限

rsyncd.secrets格式 用户名:密码

rsyncuser:rsyncpass

**rsyncd.conf配置详解**

1、全局参数  
在文件中\[module\]之前的所有参数都是全局参数，当然也可以在全局参数部分定义模块参数，这时候该参数的值就是所有模块的默认值。  
   
port  
指定后台程序使用的端口号，默认为873。  
   
motd file  
“motd file”参数用来指定一个消息文件，当客户连接服务器时该文件的内容显示给客户，默认是没有motd文件的。  
   
log file  
“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。  
   
2、模块参数  
主要是定义服务器哪个目录要被同步。其格式必须为“\[module\]”形式，这个名字就是在rsync 客户端看到的名字，其实有点象Samba服务器提供的共享名。而服务器真正同步的数据是通过 path 来指定的。我们可以根据自己的需要，来指定多个模块，模块中可以定义以下参数：  
   
comment  
给模块指定一个描述，该描述连同模块名在客户连接得到模块列表时显示给客户。默认没有描述定义。  
   
path  
指定该模块的供备份的目录树路径，该参数是必须指定的。  
   
use chroot  
如果”use chroot”指定为true，那么rsync在传输文件以前首先chroot到path参数所指定的目录下。这样做的原因是实现额外的安全防护，但是缺 点是需要以roots权限，并且不能备份指向外部的符号连接所指向的目录文件。默认情况下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

**四、客户端配置**

加环境变量

path = C:\\Program Files (x86)\\cwRsync\\bin

**五、客户端测试**

测试端口

telnet 192.168.1.82 873

测试成功  
![format_png 12][]

**拉：**

不用用户名密码的

rsync -vzrtopg --progress --delete 192.168.1.82::test /cygdrive/d/rsyncBackup

用用户名密码的

rsync -vzrtopg --progress --delete **rsyncuser@**192.168.1.82::test /cygdrive/d/rsyncBackup --password-file=/cygdrive/c/etc/rsyncd.secrets

（--password-file也可以写前边）

rsyncd.secrets密码文件，名字随便起，格式，**只写密码**

rsyncpass

设置密码访问权限chown.exe可从服务器端拷贝过来  
chmod -c 600 /cygdrive/c/etc/rsyncd.secrets  
chown administrator /cygdrive/c/etc/rsyncd.secrets  
  服务器端不设也可以

**推：**

rsync -vzrtopg --progress --delete /cygdrive/d/rsyncBackup/ 192.168.1.82::test

rsync -vzrtopg --progress --delete /cygdrive/d/rsyncBackup/ **rsyncuser@**192.168.1.82::test --password-file=/cygdrive/c/etc/rsyncd.secrets

参数说明

\--progress 显示备份过程

\--delete 删除那些DST中SRC没有的文件

成功后输出的消息：

receiving incremental file list  
./  
测试.txt  
           4 100%    3.91kB/s    0:00:00 (xfer\#1, to-check=0/2)

sent 48 bytes  received 128 bytes  117.33 bytes/sec  
total size is 4  speedup is 0.02

**Rsync命令详解**

Rsync的命令格式可以为以下六种：  
   
　　rsync \[OPTION\]... SRC DEST  
　　rsync \[OPTION\]... SRC \[USER@\]HOST:DEST  
　　rsync \[OPTION\]... \[USER@\]HOST:SRC DEST  
　　rsync \[OPTION\]... \[USER@\]HOST::SRC DEST  
　　rsync \[OPTION\]... SRC \[USER@\]HOST::DEST  
　　rsync \[OPTION\]... rsync://\[USER@\]HOST\[:PORT\]/SRC \[DEST\]  
　　对应于以上六种命令格式，rsync有六种不同的工作模式：  
   
　　1)拷贝本地文件。当SRC和DES路径信息都不包含有单个冒号”:“分隔符时就启动这种工作模式。如：rsync -a /data /backup  
   
　　2)使用一个远程shell程序(如rsh、ssh)来实现将本地机器的内容拷贝到远程机器。当DST路径地址包含单个冒号”:“分隔符时启动 该模式。如：rsync -avz \*.c foo:src  
   
　　3)使用一个远程shell程序(如rsh、ssh)来实现将远程机器的内容拷贝到本地机器。当SRC地址路径包含单个冒号”:“分隔符时启动 该模式。如：rsync -avz foo:src/bar /data  
   
　　4)从远程rsync服务器中拷贝文件到本地机。当SRC路径信息包含”::“分隔符时启动该模式。如：rsync -av root@172.16.78.192::www /databack  
   
　　5)从本地机器拷贝文件到远程rsync服务器中。当DST路径信息包含”::“分隔符时启动该模式。如：rsync -av /databack root@172.16.78.192::www  
   
　　6)列远程机的文件列表。这类似于rsync传输，不过只要在命令中省略掉本地机信息即可。如：rsync -v rsync://172.16.78.192/www  
   
rsync参数的具体解释如下：  
   
\-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 显示帮助信息

**六、部分错误的解决办法**

1.'rsync' 不是内部或外部命令，也不是可运行的程序或批处理文件。  
加环境变量  
path = C:\\Program Files (x86)\\cwRsync\\bin

2.rsync: failed to connect to 192.168.1.82: Connection timed out (116)  
rsync error: error in socket IO (code 10) at clientserver.c(122) \[Receiver=3.0.7\]  
网络通畅，服务器端允许访问端口 873

3.@ERROR: invalid uid nobody  
rsync error: error starting client-server protocol (code 5) at main.c(1506) \[Receiver=3.0.7\]  
指定uid gid  
uid = 0  
gid = 0

4.@ERROR: chdir failed  
rsync error: error starting client-server protocol (code 5) at main.c(1506) \[Receiver=3.0.7\]  
path目录配置的正确，得存在  
解决：服务器端同步目录没有权限，cwrsync默认用户是Svcwrsync。为同步目录添加用户Svcwrsync权限。  
也可以通过 菜单--cwRsyncServer--02. Prep a Dir for Upload 配置目录权限  
除完全控制和特殊权限外的所有权限

5.@ERROR: auth failed on module test  
rsync error: error starting client-server protocol (code 5) at main.c(1506) \[Receiver=3.0.7\]  
客户端设置  
a.在命令上要指定好用户名  
b.密码文件只写密码  
rsyncd.secrets文件  
rsyncpass  
c.用户名密码都要正确

6.Unexpected local arg: /cygdrive/d/rsyncBackup  
If arg is a remote file/dir, prefix it with a colon (:).  
rsync error: syntax or usage error (code 1) at main.c(1218) \[Receiver=3.0.7\]  
不一定是这个路径有问题，可能是--password-file路径中有空格，服务器端没问题，客户端好像不行

7.password file must be owned by root when running as root  
continuing without password file  
Password:  
设置密码访问权限chown.exe可从服务器端拷贝过来  
chmod -c 600 /cygdrive/c/etc/rsyncd.secrets  
chown administrator /cygdrive/c/etc/rsyncd.secrets  
  服务器端不设也可以

**rsync配置命令详解**

[http://www.2cto.com/os/201306/221760.html][http_www.2cto.com_os_201306_221760.html]

Rsync命令参数详解

[http://www.jb51.net/article/34869.htm][http_www.jb51.net_article_34869.htm]

参考：

在Windows中配置Rsync同步

[http://www.cnblogs.com/janas/p/3321087.html][http_www.cnblogs.com_janas_p_3321087.html]

rsync在windows下的安装和配置

[http://www.pc6.com/infoview/Article\_65452.html][http_www.pc6.com_infoview_Article_65452.html]

[http_rsync.samba.org]: http://rsync.samba.org/
[http_rsync.samba.org_download.html]: http://rsync.samba.org/download.html
[https_www.itefix.net_cwrsync]: https://www.itefix.net/cwrsync
[format_png]: /images/20220412/38c387887a714c4e8878ae19fa715aed.png
[format_png 1]: /images/20220412/5eb53b21065549fa9256bf1bd4bc9086.png
[format_png 2]: /images/20220412/8db5523cdeac49d59daa573481fa0ec6.png
[format_png 3]: /images/20220412/c3a131980d9f46aebbf12c551a71c8e8.png
[format_png 4]: /images/20220412/9f8666ade66e45fead4b76c3a8f301a5.png
[format_png 5]: /images/20220412/1da1595ba77d4bac9d2206510c9a1f35.png
[format_png 6]: /images/20220412/91312e44bc534cfa8c5a20d9a986e59a.png
[format_png 7]: /images/20220412/85a8dcaf0f4542cda5f912c4d2e9931e.png
[format_png 8]: /images/20220412/d0d50f140f064e1086acab6ecb1b28ab.png
[format_png 9]: /images/20220412/7b4351b80be8422581a25b67e28f6651.png
[format_png 10]: /images/20220412/aac86a71c6214983ac9657782c35dadc.png
[format_png 11]: /images/20220412/54b8c17cafc645dab20028b643d6f3b9.png
[format_png 12]: /images/20220412/1ca4aaff0e254da4bea7ceb1c761c940.png
[http_www.2cto.com_os_201306_221760.html]: http://www.2cto.com/os/201306/221760.html
[http_www.jb51.net_article_34869.htm]: http://www.jb51.net/article/34869.htm
[http_www.cnblogs.com_janas_p_3321087.html]: http://www.cnblogs.com/janas/p/3321087.html
[http_www.pc6.com_infoview_Article_65452.html]: http://www.pc6.com/infoview/Article_65452.html