调试rsync跨平台拉取文件时的协议数据流错误

我明白你现在遇到的rsync跨平台同步问题有多头疼——明明两边都装了rsync，命令看起来也没问题，却跳出了协议数据流错误。咱们一步一步来排查，从最基础的环节开始：

• 先确认SSH连通性是否正常：rsync是依托SSH传输的，所以先单独测试SSH能不能连上服务器。运行命令：

  ssh -p [port] [user]@[ip]
  

  如果连SSH都无法登录，那问题根源不在rsync本身，得先排查：端口号/用户名/IP是否输入错误、服务器防火墙是否开放了目标端口、Windows本地防火墙是否放行SSH相关流量。

• 指定服务器端rsync的绝对路径：有些Linux服务器的rsync可能不在普通用户的默认PATH里，或者Windows端rsync无法自动识别服务器端的rsync位置。可以用--rsync-path参数指定服务器端rsync的绝对路径（比如服务器上rsync在/usr/bin/rsync），修改后的命令：

  rsync -avn -e "ssh -p [port]" --rsync-path=/usr/bin/rsync [user]@[ip]:~/public_html/ ./
  

• 简化参数排查版本兼容问题：虽然rsync跨版本通常兼容，但-a参数包含的权限、所有者相关选项（比如-o/-g）可能在Windows和Linux的权限模型冲突下出错。先换成更基础的参数组合试试：

  rsync -rvn -e "ssh -p [port]" [user]@[ip]:~/public_html/ ./
  

  如果这个命令能正常运行，再逐步加回-a里的参数，找到冲突的选项。

• 开启详细调试日志：给rsync加上-vvv参数，输出最详细的传输日志，能帮你定位到具体是哪个环节断开了连接：

  rsync -avnvvv -e "ssh -p [port]" [user]@[ip]:~/public_html/ ./
  

  从日志里重点看连接建立、目录读取阶段的输出，找有没有明确的错误提示。

• 检查本地目录权限：Windows的目录权限限制可能比Linux严格，比如你当前运行命令的目录如果是Program Files这类系统目录，普通用户可能没有写入权限。可以先切换到桌面这类权限宽松的目录，再重新运行rsync命令测试。

• 测试单个文件同步：先不要同步整个public_html目录，试试同步一个小文件，比如：

  rsync -avn -e "ssh -p [port]" [user]@[ip]:~/public_html/test.txt ./
  

  如果单个文件同步正常，说明目录里可能存在特殊文件（比如符号链接、设备文件、超大文件）导致rsync出错，这时候可以用--exclude参数排除这类文件，比如--exclude="*.lnk"或者--exclude="/dev/"。

备注：内容来源于stack exchange，提问作者Gerico