Go实现SSH交互式会话：跨平台问题与官方包方案问询

一、修复Windows下exec.Command找不到ssh的问题 #

• 先确认OpenSSH客户端是否安装：Windows家庭版默认不带，打开「设置-应用-可选功能」，搜索并安装「OpenSSH客户端」。
• 验证ssh.exe路径：默认安装后路径是C:\Windows\System32\OpenSSH\ssh.exe，手动打开该路径确认文件存在。
• 环境变量生效问题：即使添加了PATH，当前运行Go程序的终端/IDE不会自动刷新环境变量，必须重启终端或IDE才能加载新的PATH。
• 跨平台兼容的代码写法：如果不想依赖PATH，可以通过runtime.GOOS判断系统，指定绝对路径：

package main

import (
    "os"
    "os/exec"
    "runtime"
)

func main() {
    var sshCmd string
    args := []string{"user@host"} // 替换成你的SSH参数

    switch runtime.GOOS {
    case "windows":
        sshCmd = "C:\\Windows\\System32\\OpenSSH\\ssh.exe"
    default:
        sshCmd = "ssh"
    }

    cmd := exec.Command(sshCmd, args...)
    cmd.Stdin = os.Stdin
    cmd.Stdout = os.Stdout
    cmd.Stderr = os.Stderr

    if err := cmd.Run(); err != nil {
        panic(err)
    }
}

二、用golang.org/x/crypto/ssh实现交互式终端 #

直接调用系统ssh不够优雅，用官方crypto/ssh包可以完全自主实现，不依赖系统ssh命令，跨平台更可靠。核心是建立SSH连接后，将本地终端与远程伪终端绑定，处理输入输出和窗口大小变化。

完整示例代码 #

package main

import (
    "fmt"
    "os"
    "os/signal"
    "syscall"

    "golang.org/x/crypto/ssh"
    "golang.org/x/term"
)

func main() {
    // 1. 配置SSH客户端
    config := &ssh.ClientConfig{
        User: "your-username", // 替换成远程用户名
        Auth: []ssh.AuthMethod{
            ssh.Password("your-password"), // 改用密钥认证：ssh.PublicKeys(私钥对象)
        },
        HostKeyCallback: ssh.InsecureIgnoreHostKey(), // 生产环境需替换为合法的主机密钥验证逻辑
    }

    // 2. 建立SSH连接
    client, err := ssh.Dial("tcp", "remote-host:22", config) // 替换成远程主机IP:端口
    if err != nil {
        fmt.Printf("连接失败: %v\n", err)
        os.Exit(1)
    }
    defer client.Close()

    // 3. 创建SSH会话
    session, err := client.NewSession()
    if err != nil {
        fmt.Printf("创建会话失败: %v\n", err)
        os.Exit(1)
    }
    defer session.Close()

    // 4. 保存本地终端原始状态，退出时恢复
    oldState, err := term.MakeRaw(int(os.Stdin.Fd()))
    if err != nil {
        fmt.Printf("设置终端原始模式失败: %v\n", err)
        os.Exit(1)
    }
    defer term.Restore(int(os.Stdin.Fd()), oldState)

    // 绑定本地终端输入输出到会话
    session.Stdout = os.Stdout
    session.Stderr = os.Stderr
    session.Stdin = os.Stdin

    // 5. 请求远程伪终端，设置初始终端大小
    termWidth, termHeight, err := term.GetSize(int(os.Stdin.Fd()))
    if err != nil {
        fmt.Printf("获取终端大小失败: %v\n", err)
        os.Exit(1)
    }
    modes := ssh.TerminalModes{
        ssh.ECHO:          1,     // 开启输入回显
        ssh.TTY_OP_ISPEED: 14400, // 输入波特率
        ssh.TTY_OP_OSPEED: 14400, // 输出波特率
    }
    if err := session.RequestPty("xterm-256color", termHeight, termWidth, modes); err != nil {
        fmt.Printf("请求伪终端失败: %v\n", err)
        os.Exit(1)
    }

    // 6. 监听终端窗口大小变化，同步到远程
    sigCh := make(chan os.Signal, 1)
    signal.Notify(sigCh, syscall.SIGWINCH)
    go func() {
        for range sigCh {
            w, h, _ := term.GetSize(int(os.Stdin.Fd()))
            session.WindowChange(h, w)
        }
    }()
    syscall.Kill(syscall.Getpid(), syscall.SIGWINCH) // 初始触发一次窗口大小同步

    // 7. 启动远程交互式Shell
    if err := session.Shell(); err != nil {
        fmt.Printf("启动Shell失败: %v\n", err)
        os.Exit(1)
    }

    // 等待会话结束
    session.Wait()
}

关键说明 #

• 密钥认证替换：如果使用密钥登录，可通过ssh.ParsePrivateKey读取本地私钥文件，将返回的密钥对象传入ssh.PublicKeys()作为AuthMethod。
• 主机密钥验证：生产环境禁止使用ssh.InsecureIgnoreHostKey()，应实现自定义HostKeyCallback逻辑，验证远程主机公钥的合法性，防范中间人攻击。
• 终端类型：xterm-256color是通用的终端类型，适配绝大多数远程环境。

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