ssh.net连接失败主因是网络或认证问题:检查ssh服务、防火墙、ip端口;认证需匹配服务端配置,密钥须openssh格式且无密码;.net6+需手动启用旧算法;runcommand适用于非交互命令,sftp需独立连接并注意路径与原子性;务必用using或dispose释放资源。
SSH.NET 连接远程主机失败的常见原因
连接直接抛出 SocketException 或超时,大概率不是代码写错,而是底层网络或认证环节卡住了。先确认:目标主机是否开启 SSH 服务(默认端口 22)、防火墙是否放行、IP 和端口是否填对——这些比查 SshClient 构造函数参数更优先。
认证方式必须匹配服务端配置:PasswordConnectionInfo 适用于密码登录;若用密钥,PrivateKeys 列表里传入的 RsaKey 或 PrivateKeyFile 必须是 OpenSSH 格式(PEM),且私钥不能有密码保护(否则要额外处理 KeyPassword)。
容易踩的坑:
-
SshClient构造时不传ConnectionInfo,而用无参构造后手动赋值,会导致连接时忽略认证信息 - 使用
PrivateKeyFile时路径写错或文件被占用,异常信息里可能只显示“Authentication failed”,实际是读取私钥失败 - .NET 6+ 默认禁用不安全的 SSH 协议算法(如 ssh-rsa),若服务端只支持老算法,需显式启用:
connectionInfo.Encryptions.Add("aes256-cbc"); connectionInfo.KeyExchangeAlgorithms.Add("diffie-hellman-group1-sha1");(不推荐,仅临时绕过)
执行单条远程命令:用 RunCommand 还是 CreateShellStream
RunCommand 是最简方式,适合执行非交互式命令(如 ls -l /tmp、systemctl status nginx)。它自动处理 stdin/stdout/stderr 流,并返回 SshCommand 对象,其中 Result 是标准输出内容,ExitStatus 是退出码。
但注意:RunCommand 启动的是非登录 shell,不会加载用户 profile,PATH 可能不全。如果命令依赖别名、自定义环境变量或需要 cd 到特定目录,得显式写全路径或组合成一行:
var cmd = client.RunCommand("cd /var/log && tail -n 10 app.log");
Console.WriteLine(cmd.Result);
需要交互式会话(比如运行 sudo 并等待密码提示、启动 vim 等)就不能用 RunCommand,得用 CreateShellStream + 手动读写流,复杂度陡增,一般应避免。