Go实现SSH交互式会话：控制键与方向键异常问题排查

我帮你分析下你遇到的问题：控制键（Ctrl+C、Ctrl-R）失效、方向键输出^[[A^[[D这类转义序列，根源主要在两个地方：终端模式配置不完整，以及本地SIGINT信号没有转发给远程SSH会话。单独测试第三方包正常是因为官方示例默认包含了这些关键逻辑，而你的代码简化后遗漏了。下面给你一步步修复：

1. 补充完整的终端模式参数 #

你当前只设置了ssh.ECHO: 1，这远远不够——缺少的参数会让终端无法正确识别控制字符、无法将信号转发给远程。替换成下面的完整配置：

modes := ssh.TerminalModes{
    ssh.ECHO:          1,          // 开启回显
    ssh.TTY_OP_ISPEED: 14400,      // 输入波特率
    ssh.TTY_OP_OSPEED: 14400,      // 输出波特率
    ssh.IGNPAR:        1,          // 忽略奇偶校验错误
    ssh.INPCK:         0,          // 禁用输入奇偶校验
    ssh.ISTRIP:        0,          // 保留字符第8位
    ssh.INLCR:         0,          // 不把输入的NL转成CR
    ssh.IGNCR:         0,          // 不忽略输入的CR
    ssh.ICRNL:         1,          // 把输入的CR转成NL
    ssh.IXON:          1,          // 开启输出流控制
    ssh.IXOFF:         1,          // 开启输入流控制
    ssh.IUTF8:         1,          // 支持UTF-8字符
    ssh.ECHOK:         1,          // 回显kill命令字符
    ssh.ECHOE:         1,          // 回显删除字符
    ssh.ECHOKE:        1,          // 按规范回显kill字符
    ssh.ICANON:        1,          // 开启规范模式（处理控制字符）
    ssh.ISIG:          1,          // 允许远程处理信号（比如Ctrl+C）
    ssh.CS8:           1,          // 使用8位字符集
}

这个配置会让本地终端和远程终端的行为对齐，解决方向键输出转义序列的问题。

2. 转发SIGINT信号到远程会话 #

现在按下Ctrl+C直接终止Go脚本，是因为Go进程默认捕获了SIGINT，没有把这个信号传递给远程会话。添加下面的逻辑，把Ctrl+C对应的ASCII码（0x03）发送给远程：

// 在session.Shell()之前添加：
sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, syscall.SIGINT)
go func() {
    <-sigChan
    // 发送Ctrl+C对应的控制字符到远程
    session.Stdin.Write([]byte{0x03})
}()

这样按下Ctrl+C时，会终止远程的命令而不是本地Go程序。

3. 修正窗口大小同步的顺序问题 #

你的termSize函数把宽度放在了前面，但SSH的window-change请求要求高度在前，宽度在后，修正这个顺序：

func termSize(fd uintptr) []byte {
    size := make([]byte, 16)
    winsize, err := term.GetWinsize(fd)
    if err != nil {
        // 默认值：高度24，宽度80
        binary.BigEndian.PutUint32(size, uint32(24))
        binary.BigEndian.PutUint32(size[4:], uint32(80))
        return size
    }
    // SSH窗口变更的参数顺序是 高度 -> 宽度
    binary.BigEndian.PutUint32(size, uint32(winsize.Height))
    binary.BigEndian.PutUint32(size[4:], uint32(winsize.Width))
    return size
}

这个修复能确保窗口大小变更时，远程终端正确同步尺寸，避免排版错乱。

整合后的完整代码 #

把以上修改整合到你的代码中，最终版本如下：

import (
    "os"
    "syscall"
    "os/signal"
    "encoding/binary"
    "github.com/nanobox-io/golang-ssh"
    "golang.org/x/term"
)

func Start(hostName string) {
    var (
        termWidth, termHeight = 80, 24
    )
    jumpAddr := "..."
    hostAddr := "..."
    jumpConfig := ssh.ClientConfig{
        // 你的jump服务器配置（用户名、认证等）
    }
    hostConfig := ssh.ClientConfig{
        // 目标服务器配置
    }
    jumpConn, err := ssh.Dial("tcp", jumpAddr+":22", &jumpConfig)
    ifpanic(err)
    hostConn, err := jumpConn.Dial("tcp", hostAddr+":22")
    ifpanic(err)
    hostSSHConn, chans, reqs, err := ssh.NewClientConn(hostConn, hostName+":22", &hostConfig)
    ifpanic(err)
    hostClient := ssh.NewClient(hostSSHConn, chans, reqs)
    session, err := hostClient.NewSession()
    ifpanic(err)
    defer session.Close()

    session.Stdout = os.Stdout
    session.Stderr = os.Stderr
    session.Stdin = os.Stdin

    // 完整的终端模式配置
    modes := ssh.TerminalModes{
        ssh.ECHO:          1,
        ssh.TTY_OP_ISPEED: 14400,
        ssh.TTY_OP_OSPEED: 14400,
        ssh.IGNPAR:        1,
        ssh.INPCK:         0,
        ssh.ISTRIP:        0,
        ssh.INLCR:         0,
        ssh.IGNCR:         0,
        ssh.ICRNL:         1,
        ssh.IXON:          1,
        ssh.IXOFF:         1,
        ssh.IUTF8:         1,
        ssh.ECHOK:         1,
        ssh.ECHOE:         1,
        ssh.ECHOKE:        1,
        ssh.ICANON:        1,
        ssh.ISIG:          1,
        ssh.CS8:           1,
    }

    fd := os.Stdin.Fd()
    oldState, err := term.MakeRaw(fd)
    ifpanic(err)
    defer ifpanic(term.RestoreTerminal(fd, oldState))

    winsize, err := term.GetWinsize(fd)
    if err == nil {
        termWidth = int(winsize.Width)
        termHeight = int(winsize.Height)
    }

    if err := session.RequestPty("xterm", termHeight, termWidth, modes); err != nil {
        panic(err)
    }

    // 捕获SIGINT并转发给远程会话
    sigChan := make(chan os.Signal, 1)
    signal.Notify(sigChan, syscall.SIGINT)
    go func() {
        <-sigChan
        session.Stdin.Write([]byte{0x03})
    }()

    if err := session.Shell(); err != nil {
        panic(err)
    }

    go monWinCh(session, os.Stdout.Fd())

    if err := session.Wait(); err != nil {
        panic(err)
    }
}

func ifpanic(err error) {
    if err != nil {
        panic(err)
    }
}

func monWinCh(session *ssh.Session, fd uintptr) {
    sigs := make(chan os.Signal, 1)
    signal.Notify(sigs, syscall.SIGWINCH)
    defer signal.Stop(sigs)
    for range sigs {
        if _, err := session.SendRequest("window-change", false, termSize(fd)); err != nil {
            panic(err)
        }
    }
}

func termSize(fd uintptr) []byte {
    size := make([]byte, 16)
    winsize, err := term.GetWinsize(fd)
    if err != nil {
        binary.BigEndian.PutUint32(size, uint32(24))
        binary.BigEndian.PutUint32(size[4:], uint32(80))
        return size
    }
    // SSH窗口变更请求的顺序是高度在前，宽度在后
    binary.BigEndian.PutUint32(size, uint32(winsize.Height))
    binary.BigEndian.PutUint32(size[4:], uint32(winsize.Width))
    return size
}

这些修改应该能解决你遇到的所有问题：控制键正常工作、方向键不再输出乱码，同时保留隧道功能。

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