适用范围与准备

适用于 OpenSSH scp 客户端升级后,同一 SSH 主机仍能登录,但文件传输报 subsystem request failed、远端路径错误或通配符行为变化。OpenSSH 9.0 起 scp 默认改用 SFTP;这不是 FTP 的被动端口问题。

先区分原因

能建立 SSH 会话只证明相应登录路径可用,不保证服务器提供 SFTP 子系统。旧 SCP 通过远端 shell 处理路径和通配符,新默认 SFTP 的路径处理不同;因此原先为远端 shell 添加的多层引号或 ~其他用户 路径可能不再适用。

按顺序操作

  1. 在实际发起传输的终端运行 ssh -V,核对 scp 与 ssh 是否来自同一安装。记录报错阶段;服务商可能回移功能,版本号是线索,实际请求的子系统和错误更直接。
  2. 使用下面 sftp 命令连接本人有权限的测试主机,只执行 pwd、ls 与 bye。若登录后请求子系统即失败,向管理员确认 SFTP 是否配置或是否被账户策略限制;不去修改 FTP 的数据端口。
  3. 先用无通配符、已确认的绝对路径下载一个小型非敏感文件到新目录。SFTP 受限账户看到的根目录可能不同于普通 shell;示例 /exports/sample.txt 必须换成该会话实际可见的路径。
  4. 默认模式能传输而旧脚本失败时,逐项移除为旧远端 shell 特意添加的二次转义,检查路径与通配符。不要直接对批量上传脚本做全局替换,先在单文件副本验证。
  5. 只有管理员确认目标不支持 SFTP、且确需短期兼容旧 SCP 时,才评估 scp -O。它不会修复账号权限或主机密钥错误,并重新引入远端 shell 的解析要求;不作为每次报错都添加的默认选项。
macOS/Linux,或已安装 OpenSSH 的 Windows。ops 与主机、路径都是占位;下载在本批专用空目录执行。
ssh -V
sftp -o User=ops ssh.example.com
scp -o User=ops ssh.example.com:/exports/sample.txt ./sample.txt
现象优先确认
subsystem request failed服务器是否提供并允许 SFTP
No such fileSFTP 可见路径及权限
只有带通配符的脚本失败模式变化与路径解析
Permission denied(登录阶段)SSH 认证,另按 SSH 排障

怎样确认有效

同一账号、路径与客户端模式完成指定文件传输,并以可信的源文件摘要或内容核对结果。scp 返回成功只说明传输命令完成,不能证明下载的是你想要的那个同名文件。

无效时恢复与下一步

撤回本次脚本路径改动或临时 -O,并保留原可用版本。由管理员修复 SFTP 支持后优先回到默认模式,不关闭主机指纹校验,不把服务器改成允许所有账户无限制 shell。