适用范围与准备

适用于你有权限读取的服务器已使用自定义 SSH 端口,而 rsync 仍连接默认端口或报连接被拒。示例面向安装 rsync 和 OpenSSH 的终端,只从远端拉取到新建本地测试目录。

先区分原因

USER@HOST:/path 使用远程 shell;HOST::module 和 rsync:// 通常连接 rsync daemon。rsync 的 --port 不负责改变 SSH 端口,后者应由 ssh -p 或明确的 SSH 别名配置控制。

按顺序操作

  1. 先检查原命令中是单冒号还是双冒号,以及管理员提供的是 SSH 路径还是 daemon 模块名。两者账号和权限也可能不同。
  2. 记录本机 rsync --version 与 ssh -V。确认远端安装了 rsync,且账户可读取目标目录;SSH 能登录不代表远端 rsync 可执行。
  3. 创建一个空的本地测试目录,将下方 HOST、USER、远端路径和 2222 替换为核实过的值。命令保留 --dry-run,不加入 --delete。
  4. 检查输出中的文件清单与错误阶段。主机指纹变化应核实;rsync: command not found 是远端程序问题,不应通过改代理解决。
  5. 确认路径与授权后才移除 --dry-run 执行拉取。示例源路径末尾的 / 表示复制目录里的内容,检查目标目录,避免套用到现有生产目录。
只作演练;仍会建立 SSH 连接并读取远端目录
rsync -av --dry-run -e "ssh -p 2222" USER@HOST:/REMOTE/DIR/ ./rsync-check/
地址形式本篇判断
HOST:/path远程 shell;SSH 端口交给 ssh
HOST::module 或 rsync://核对 daemon 模式,不直接照抄 SSH 命令

怎样确认有效

演练列出了预期文件且没有连接错误,只证明能列出和协商。实际拉取后还要检查文件数、内容或提供方校验值;dry-run 不是文件交付成功。

无效时恢复与下一步

本篇不修改 SSH 或 rsync 全局设置。失败时保留旧目录和源文件,只检查新测试目录;不要为了重试加删除参数或关闭防火墙。daemon 经远程 shell 启动属于另一种部署方式,应由维护者确认。