超全整理！rsync 常见错误大汇总及超实用解决方法

在日常服务器运维工作中，rsync 作为一款高效的文件同步工具，被我们频繁应用于服务器间的文件同步任务。然而，在 rsync 的配置与使用环节，时常会遭遇各类棘手问题。这些问题的排查与解决，主要依赖于对客户端反馈的错误信息进行深入细致的分析。通过剖析客户端返回的错误，我们能够精准定位问题根源，进而采取针对性措施，确保 rsync 文件同步工作得以顺利开展，保障服务器数据同步的准确性与高效性。

我们通常通过查看错误日志来排查问题，相关日志主要记录于 rsyncd.log 文件或 .err 文件中，用户可使用文本编辑器（如记事本）打开这些文件进行查看。

需特别注意的是，在 Windows 操作系统环境下，要为 SvcwRsync 用户授予对同步目录的完全管理权限。通常情况下，完成此权限设置后，系统即可正常运行。若在前期未进行权限配置，且同步目录中已存在大量文件，为快速解决问题，建议将 SvcwRsync 用户设置为管理员账户。不过，此操作会带来一定的安全风险，因此，从安全角度考虑，最好对该用户的登录权限进行限制。

sync 使用时的常见问题

• 错误 1：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 服务，一般开启服务即可。 或者开启了防火墙指定的端口 873 无法访问或者机房拦截源 ip。
• 错误 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]
• 解决：服务器端配置文件 rsyncd.conf 中添加lock file = rsyncd.lock即可解决。
• 错误 4：@ERROR: invalid uid nobody
rsync error: error starting client-server protocol (code 5) at main.c(1506) [Receiver=3.0.2]
• 解决：在 rsyncd.conf 文件中添加下面两行即可解决问题
  • UID = 0
GID = 0
• 错误 5：@ERROR: auth failed on module test2
rsync error: error starting client-server protocol (code 5) at main.c(1296) [receiver=3.0.2]
• 解决：服务端没有指定正确的 secrets file，请在 [test2]配置段添加如下配置行：
  • auth users = coldstar #同步使用的帐号
  • secrets file = rsyncd.secrets #密码文件
• 错误 6：password file must not be other-accessible
• 解决：客户端的 pass 文件要求权限为 600, chmod 600 /etc/rsync.pass 即可。
• 错误 7：rsync: chdir /cygdrive/c/work failed
: No such file or directory (2)
• 解决：服务器端同步文件夹路径或名称写错了，检查 path。

rsyncserver 服务启动时报错“rsyncserver 服务启动后又停止了

在服务器运维过程中，有时会遇到部分服务自动停止的情况，特别是当这些服务在一段时间内没有任务可执行时，就容易出现此类状况。例如，“性能日志和警报”服务，在无相关任务时便可能自动停止运行。而Rsync 服务也可能会受到类似情况的影响，出现异常停止。

当遇到Rsync 服务停止的问题时，这里有一个有效的解决方法：首先，需要找到 RsyncServer 服务的安装目录，将该目录下的rsyncd.pid 文件进行删除操作。完成文件删除后，再重新启动RsyncServer 服务，这样服务通常就能恢复正常运行。这种问题一般是由于服务器异常关机所导致的，异常关机可能破坏了服务运行所需的某些文件或状态，进而引发服务停止。

另外，还有一种更为便捷的方式可以确保Rsync 服务自动开启。通过设置计划任务，定时执行特定的bat 脚本，就能实现 Rsync 服务的自动启动，无需手动干预，大大提高了运维效率。

@echo off
for /f "usebackq" %%i in (`"tasklist|find /c "cygrunsrv.exe""`) do (
	set chkstat=%%i
)
if %chkstat% == 0 (
del "e:\Program Files (x86)\ICW\rsyncd.pid" /f
	net start RsyncServer
	echo ================ >> rsync%date:~0,10%.log
	echo %date% %time% check rsync service stop >> rsync%date:~0,10%.log
	echo restart rsync service! >> rsync%date:~0,10%.log
	echo ================ >> rsync%date:~0,10%.log
)

如果日志文件过大会导致同步慢等问题，大家可以用下面的批处理

原理就是先判断服务器是不是正常运行，运行的时候停止服务，然后将日志与 pid 文件删除，再重新启动即可，一般几天一次就可以了。

@echo off
for /f "usebackq" %%i in (`"tasklist|find /c "cygrunsrv.exe""`) do (
	set chkstat=%%i
)
if %chkstat% == 1 (
net stop RsyncServer
del "D:\Program Files (x86)\ICW\rsyncd.pid" /f
del "D:\Program Files (x86)\ICW\rsyncd.log" /f
net start RsyncServer	
	echo ================ >> rsync%date:~0,10%.log
	echo %date% %time% check rsync service stop >> rsync%date:~0,10%.log
	echo restart rsync service! >> rsync%date:~0,10%.log
	echo ================ >> rsync%date:~0,10%.log
)

错误列表

问题一

@ERROR: chroot failed
rsync error: error starting client-server protocol (code 5) at main.c(1522) [receiver=3.0.3]

原因：服务器端的目录不存在或无权限，创建目录并修正权限可解决问题。

问题二

@ERROR: auth failed on module tee
rsync error: error starting client-server protocol (code 5) at main.c(1522) [receiver=3.0.3]

原因：服务器端该模块（tee）需要验证用户名密码，但客户端没有提供正确的用户名密码，认证失败。
提供正确的用户名密码解决此问题。

问题三

@ERROR: Unknown module ‘tee_nonexists’
rsync error: error starting client-server protocol (code 5) at main.c(1522) [receiver=3.0.3]

原因：服务器不存在指定模块。提供正确的模块名或在服务器端修改成你要的模块以解决问题。

问题 1：

在 client 上遇到问题：
rsync -auzv --progress --password-file=/etc/rsync.pas root@192.168.133.128::backup /home/
rsync: could not open password file "/etc/rsync.pas": No such file or directory (2)
Password:
@ERROR: auth failed on module backup
rsync error: error starting client-server protocol (code 5) at main.c(1506) [Receiver=3.0.7]

遇到这个问题：client 端没有设置/etc/rsync.pas这个文件，而在使用 rsync 命令的时候，加了这个参数--
password-file=/etc/rsync.pas

问题 2：

rsync -auzv --progress --password-file=/etc/rsync.pas root@192.168.133.128::backup /home/
@ERROR: auth failed on module backup
rsync error: error starting client-server protocol (code 5) at main.c(1506) [Receiver=3.0.7]

遇到这个问题：client 端已经设置/etc/rsync.pas 这个文件，里面也设置了密码 111111，和服务器一致，但是
服务器段设置有错误，服务器端应该设置/etc/rsync.pas ，里面内容 root:111111 ,这里登陆名不可缺少

问题 3：

rsync -auzv --progress --password-file=/etc/rsync.pas root@192.168.133.128::backup /home/
@ERROR: chdir failed
rsync error: error starting client-server protocol (code 5) at main.c(1506) [Receiver=3.0.7]

遇到这个问题，是因为服务器端的/home/backup 其中 backup 这个目录并没有设置，所以提示：chdir failed

问题 4：

rsync: write failed on "/home/backup2010/wensong": No space left on device (28)
rsync error: error in file IO (code 11) at receiver.c(302) [receiver=3.0.7]
rsync: connection unexpectedly closed (2721 bytes received so far) [generator]
rsync error: error in rsync protocol data stream (code 12) at io.c(601) [generator=3.0.7]

磁盘空间不够，所以无法操作。

可以通过 df /home/backup2010 来查看可用空间和已用空间

问题 5：网络收集问题

1、权限问题

类似如下的提示：rsync: opendir "/kexue" (in dtsChannel) failed: Permission denied (13)注意查看同步的目录权限是否为 755

2、time out

rsync: failed to connect to 203.100.192.66: Connection timed out (110)
rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.5]

检查服务器的端口 netstat –tunlp，远程 telnet 测试。
可能因为客户端或者服务端的防火墙开启 导致无法通信，可以设置规则放行 rsync（873 端口） 或者直接关闭防火墙。

还有一种在同步过程中可能会提示没有权限 （将同步目录加上 SvcwRsync 全部权限即可，更简单的方法就是将 SvcwRsync 设为管理员即可）

3、服务未启动

rsync: failed to connect to 10.10.10.170: Connection refused (111)
rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.5]

启动服务：rsync --daemon --config=/etc/rsyncd.conf

4、磁盘空间满

rsync: recv_generator: mkdir "/teacherclubBackup/rsync……" failed: No space left on device (28)
*** Skipping any contents from this failed directory ***

5、Ctrl+C 或者大量文件

rsync error: received SIGINT, SIGTERM, or SIGHUP (code 20) at rsync.c(544) [receiver=3.0.5]
rsync error: received SIGINT, SIGTERM, or SIGHUP (code 20) at rsync.c(544) [generator=3.0.5]

说明：导致此问题多半是服务端服务没有被正常启动，到服务器上去查查服务是否有启动，然后查看下 /var/run/rsync.pid 文件是否存在，最干脆的方法是杀死已经启动了服务，然后再次启动服务或者让脚本加入系统启动服务级别然后 shutdown -r now 服务器

6、xnetid 启动

rsync: read error: Connection reset by peer (104)
rsync error: error in rsync protocol data stream (code 12) at io.c(759) [receiver=3.0.5]

查看 rsync 日志：

rsync: unable to open configuration file "/etc/rsyncd.conf": No such file or directory

xnetid 查找的配置文件位置默认是/etc 下，根据具体情况创建软链接。例如：

ln -s /etc/rsyncd/rsyncd.conf /etc/rsyncd.conf

或者更改指定默认的配置文件路径，在/etc/xinetd.d/rsync 配置文件中。

Rsync configure

配置一：ignore errors

说明：这个选项最好加上，否则再很多 crontab 的时候往往发生错误你也未可知，因为你不可能天天去看每时每刻去看 log，不加上这个出现错误的几率相对会很高，因为任何大点的项目和系统，磁盘 IO 都是一个瓶颈

Rsync error：

错误一：

@ERROR: auth failed on module xxxxx
rsync: connection unexpectedly closed (90 bytes read so far)
rsync error: error in rsync protocol data stream (code 12) at io.c(150)

说明：这是因为密码设置错了，无法登入成功，检查一下 rsync.pwd，看客服是否匹配。还有服务器端没启动 rsync 服务也会出现这种情况。

错误二：

password file must not be other-accessible
continuing without password file

Password:

说明：这是因为 rsyncd.pwd rsyncd.sec 的权限不对，应该设置为 600。如：chmod 600 rsyncd.pwd

错误三：

@ERROR: chroot failed
rsync: connection unexpectedly closed (75 bytes read so far)
rsync error: error in rsync protocol data stream (code 12) at io.c(150)

说明：这是因为你在 rsync.conf 中设置的 path 路径不存在，要新建目录才能开启同步

错误四：

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]

说明：防火墙问题导致，这个最好先彻底关闭防火墙，排错的基本法就是这样，无论是 S 还是 C，还有 ignore errors 选项问题也会导致

错误五：

@ERROR: access denied to www from unknown (192.168.1.123)
rsync: connection unexpectedly closed (0 bytes received so far) [receiver]
rsync error: error in rsync protocol data stream (code 12) at io.c(359)

说明：此问题很明显，是配置选项 host allow 的问题，初学者喜欢一个允许段做成一个配置，然后模块又是同一个，致使导致

错误六：

rsync error: received SIGINT, SIGTERM, or SIGHUP (code 20) at rsync.c(244) [generator=2.6.9]
rsync error: received SIGUSR1 (code 19) at main.c(1182) [receiver=2.6.9]

说明：导致此问题多半是服务端服务没有被正常启动，到服务器上去查查服务是否有启动，然后查看下 /var/run/rsync.pid 文件是否存在，最干脆的方法是杀死已经启动了服务，然后再次启动服务或者让脚本加入系统启动服务级别然后 shutdown -r now 服务器

错误七：

rsync: read error: Connection reset by peer (104)
rsync error: error in rsync protocol data stream (code 12) at io.c(604) [sender=2.6.9]

说明：原数据目录里没有数据存在

rsync 错误与解决方法整理补充篇

由于我们经常使用 rsync 进行服务器文件的同步工作，但在配置过程中，会出现很多问题，下面的错误基本上都是通过客户端返回的错误进行分析。

另外查找错误过程中也学到了一个查看错误的方法-查看系统日志，我们操作的每步都会在日志上有说明，有时候报错看不懂，日志上都写的清清楚楚。

命令：cat /var/log/messages

问题一：

@ERROR: auth failed on module bachup
rsync error: error starting client-server protocol (code 5) at main.c(1522) [receiver=3.0.3]

原因：服务器端该模块（backup）需要验证用户名密码，但客户端没有提供正确的用户名密码，认证失败。  提供正确的用户名密码解决此问题。
这个问题比较蠢，如果可能你和我一样明明在模块里写了密码文件，怎么都不通，这个时候我劝你先检查一下所写模块中是不是和下图一样。比如，某处多了个 s。

问题二：110 错误 -time out

rsync: failed to connect to 203.100.192.66: Connection timed out (110)
rsync error: error in socket IO (code 10) at clientserver.c(124) [receiver=3.0.8]

原因：

检查服务器的端口 netstat –tunlp，远程 telnet 测试。 可能因为客户端或者服务端的防火墙开启 导致无法通信，可以设置规则放行 rsync（873 端口） 或者直接关闭防火墙或者 ip 安全策略(机房的防火漆可能拦截了，可以找机房)。
在这里博主是重启过服务器，然后就报 110 了，直接开启 rsync 服务就行。

命令：service rsyncd start

问题三：113 错误 -防火墙

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]

原因：防火墙问题导致，这个很简单，关闭防火墙就可以。不过博主还是被困在这里几个小时，因为 linux 防火墙分两种：

-iptable 和-firewall

认识到这个问题首先查看系统的防火墙种类，查看防火墙状态即可

service iptable status
firewall-cmd --state

确定防火墙种类后再按对应方法将防火墙关闭即可。

问题四：1516 错误

@ERROR: auth failed on module backup
rsync error: error starting client-server protocol (code 5) at main.c(1516) [Receiver=3.0.9]

解决：这个问题错误差别很大，可查看系统日志查看错误，再搜索解决方法。

注意：一般这种情况都建立在可以连通的基础。去服务端查看系统日志，可以查看相关错误。

命令：

cat /var/log/massages

cat /var/log/rsyncd.log

结语

掌握 rsync 常见错误的精准解决方案，是提升数据同步效率与稳定性的关键。从模块配置错误、密码认证失败到权限不足、磁盘空间告急，每类问题都需结合日志分析与系统环境进行针对性排查。持续优化与迭代，让 rsync 成为数据管理的得力助手，驱动业务高效增长。

以上关于超全整理！rsync 常见错误大汇总及超实用解决方法的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。