使用Node.js自动化Bash交互时遇到SSH伪终端分配问题

问题本质 #

SSH这类工具会检查输入是否来自终端（TTY）：

• 未分配终端时，会抛出Pseudo-terminal will not be allocated because stdin is not a terminal提示；
• 用-t -t强制分配终端，SSH会直接把输出绑定到父进程的终端，绕过Node的stdout管道，导致无法通过代码捕获输出。

分场景解决方案 #

1. 非交互式执行（仅跑命令，无需输入） #

如果只是远程执行固定命令，不需要交互式输入（比如密码、交互式命令行），直接给SSH加-T参数禁用终端分配即可：

const { spawn } = require('child_process');

// 示例：远程执行ls命令
const ssh = spawn('ssh', ['-T', 'your-user@remote-host', 'ls -l']);

ssh.stdout.pipe(process.stdout);
ssh.stderr.pipe(process.stderr);

ssh.on('exit', (code) => {
  console.log(`SSH退出码：${code}`);
});

这样既不会出现终端提示，输出也会正常通过stdout/stderr管道传递给Node进程。

2. 交互式场景（需要输入密码、操作远程终端） #

如果必须进行交互式操作，就得给SSH分配伪终端（PTY），同时接管终端的输入输出，避免输出直接跳转到系统终端。用Node内置的tty模块就能实现，不需要额外第三方包：

const { spawn } = require('child_process');
const tty = require('tty');

// 创建PTY主从设备
const pty = tty.openpty();
const { slaveName, fd: masterFd } = pty;

// 启动SSH，绑定stdio到PTY从设备
const ssh = spawn('ssh', ['your-user@remote-host'], {
  stdio: [`fd:${pty.slaveFd}`, `fd:${pty.slaveFd}`, `fd:${pty.slaveFd}`],
  // 传递TERM环境变量，让SSH识别终端类型
  env: { ...process.env, TERM: process.env.TERM || 'xterm' }
});

// 将PTY主设备的输出转到Node的stdout
const masterStream = new tty.ReadStream(masterFd);
masterStream.pipe(process.stdout);

// 将Node的stdin输入转到PTY主设备（支持交互式输入）
process.stdin.pipe(new tty.WriteStream(masterFd));

// 处理SSH退出事件
ssh.on('exit', (code) => {
  console.log(`SSH退出，码：${code}`);
  process.exit(code);
});

原理是：通过openpty创建一对伪终端主从设备，SSH的输入输出绑定到从设备，Node进程通过主设备与SSH交互。这样既满足SSH对终端的要求，输出也会经过Node的管道，不会直接跳过stdout。

为什么-t -t会直接打印终端？ #

-t -t强制SSH分配PTY，但此时SSH会直接将PTY连接到父进程（Node进程）的终端设备，输出绕过了Node的stdout管道，直接写入系统终端，所以无法通过ssh.stdout捕获输出。而用tty.openpty的方式，我们手动接管了PTY的主设备，输出会先流向Node进程，再由你决定如何处理。

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