为什么使用rsync配合sshpass与跳板机传输文件不生效

你遇到的报错是三个叠加的命令结构错误导致的：

• 参数边界识别错误：原命令把本该属于rsync参数的目标主机名，错误包裹进了-e选项的单引号内部，导致rsync把SSH连接返回的握手协议字符串（也就是SSH-2.0-OpenSSH_xxx这行）误识别为本地Shell要执行的命令，触发“command not found”报错。
• 代理转发逻辑缺失：跳板机侧的SSH连接没有配置TCP流量转发参数，连接建立后直接进入交互Shell，会把SSH版本横幅直接返回给前端程序，进一步加剧了参数解析混乱。
• 多层引号嵌套错误：-e选项内部的ProxyCommand值没有和外层引号做正确的层级隔离，导致Shell解析时提前截断了代理命令的执行边界。

按照rsync的参数规则、SSH代理转发要求调整后的完整命令如下：

rsync -azv -e 'sshpass -p 目标主机登录密码 ssh -o "StrictHostKeyChecking=no" -o "ProxyCommand=sshpass -p 跳板机登录密码 ssh -o StrictHostKeyChecking=no -W %h:%p 跳板机用户名@跳板机地址"' 目标主机用户名@目标主机地址:远程同步文件路径 本地保存路径

• 拆分-e选项的边界：-e后面的单引号只包裹自定义的SSH连接模板，不能把最终要连接的目标主机名、远程路径写进这个引号内部；SSH连接时会自动通过模板里的%h:%p占位符，把目标主机地址、连接端口传递给跳板机做透明转发，不需要手动硬编码。
• 补充跳板机转发参数：跳板机侧的SSH命令必须加上-W %h:%p参数，这个参数的作用是把跳板机变成一个透明的TCP转发通道，不会让连接直接进入交互Shell，从根源上避免握手字符串被误当成命令执行。
• 关闭主机key交互检查：加上StrictHostKeyChecking=no参数，避免首次连接时弹出的host key确认提示中断非交互流程，和sshpass的无密码非交互执行逻辑匹配。

如果嵌套引号总是容易写错边界，可以把SSH代理配置写到本地用户的~/.ssh/config文件中，减少命令行的嵌套复杂度：

# 配置目标主机的代理规则
Host 自定义目标主机别名
  HostName 目标主机实际IP/域名
  User 目标主机登录用户名
  ProxyCommand sshpass -p 跳板机登录密码 ssh 跳板机用户名@跳板机地址 -W %h:%p

配置完成后，rsync命令可以简化为：

rsync -azv -e 'sshpass -p 目标主机密码 ssh' 自定义目标主机别名:远程同步路径 本地保存路径

完全不会出现引号嵌套导致的解析错误。

注意：rsync的参数顺序要和同步方向匹配：

• 从远程拉文件到本地：rsync [选项] 远程主机:远程路径 本地路径
• 从本地推文件到远程：rsync [选项] 本地路径 远程主机:远程路径
  原命令的路径顺序大概率存在反向写反的问题，可以根据实际需求调整。

内容的提问来源于stack exchange，提问作者ykalisoonus