如何在单个 SSH 会话中执行多个命令-Golang-PHP中文网

如何在单个 SSH 会话中执行多个命令

本文详解如何在 Go 的 golang.org/x/crypto/ssh 包中，通过拼接命令字符串的方式，在同一个 SSH 会话中顺序执行多条 Shell 命令，规避 session.Run() 仅允许调用一次的限制。

本文详解如何在 go 的 `golang.org/x/crypto/ssh` 包中，通过拼接命令字符串的方式，在同一个 ssh 会话中顺序执行多条 shell 命令，规避 `session.run()` 仅允许调用一次的限制。

在使用 Go 的 SSH 客户端（golang.org/x/crypto/ssh）时，一个常见误区是试图对同一 *ssh.Session 多次调用 session.Run()。然而，正如源码注释明确指出的：一个 Session 仅允许调用一次 Run、Start、Shell、Output 或 CombinedOutput。重复调用将导致未定义行为或静默失败（实际表现为后续 Run 返回非零退出码或连接异常）。

正确的做法不是创建多个 Session（这会建立多个 TCP 连接，开销大且无法共享登录态），而是将多条命令合并为一条 Shell 命令字符串，在单次 Run 中交由远程 Shell 解释执行。最常用、最可靠的方式是使用分号 ; 连接命令：

commands := []string{
    "docker login -u $USER -p $PASS registry.example.com",
    "docker ps -a",
    "echo 'All commands completed successfully'",
}
command := strings.Join(commands, "; ")

// 注意：必须重置 output 缓冲区（否则会累积历史输出）
output.Reset()
session.Stdout = &output

if err := session.Run(command); err != nil {
    panic("Failed to execute command sequence: " + err.Error())
}
fmt.Println("Output:\n" + output.String())

⚠️ 关键注意事项：

错误处理需谨慎：; 是无条件分隔符——即使前一条命令失败（如 docker login 凭据错误），后续命令仍会执行。若需“失败即中断”，应改用 &&：
```
command := strings.Join(commands, " && ") // 任一命令失败则终止链式执行
```
环境变量与 Shell 特性：session.Run() 默认调用 /bin/sh -c，不加载用户 shell 配置（如 .bashrc）。若需 Bash 特性（如数组、函数），显式指定解释器：
```
command := "bash -c '" + strings.Join(commands, " && ") + "'"
```
安全提醒：避免直接拼接用户输入！若命令含动态参数（如镜像名、标签），务必使用 shellescape.Quote()（来自 mitchellh/go-homedir 或自实现）进行转义，防止 Shell 注入。
输出隔离：每次 Run 前建议调用 output.Reset()，避免上一次执行结果残留；如需区分各命令输出，可在命令中嵌入分隔标识：
```
commands = []string{
    "echo '=== LOGIN ==='; docker login ...",
    "echo '=== PS OUTPUT ==='; docker ps",
}
```