命令行与文本处理 / 系统课时
怎样通过 SSH 执行远程命令
怎样通过 SSH 执行远程命令
自动化脚本经常需要在多台服务器上检查状态、执行维护命令并判断是否成功。SSH 不只提供交互式登录,也能直接运行远程命令;关键是区分远端标准输出、标准错误和 SSH 自身的退出状态。
学习目标
- 使用
ssh user@host 'command'执行远程命令 - 在本地分别获取远端标准输出、标准错误和退出状态
- 区分远程命令失败与 SSH 连接或认证失败
SSH 命令的执行链路
本地 Shell 先启动 ssh 客户端,SSH 建立加密连接并认证,然后把指定命令交给远端 Shell 执行。远端命令产生的标准输出和标准错误会沿连接返回本地,ssh 进程最终以远端命令的状态码退出;如果连接或认证本身失败,OpenSSH 通常使用 255。

远程命令放在单引号中,可以避免本地 Shell 先展开其中的 $(...)、$VAR 等表达式。例如 $(hostname) 应该由远端 Shell 求值,而不是在本机提前替换。
获取标准输出和退出状态
下面的完整脚本把标准输出和标准错误分别写入临时文件,并保存 ssh 的退出状态。示例中的远端命令最后执行 exit 7,用于验证状态码是否能原样传回本地。
#!/usr/bin/env bash
set -u
if (( $# != 1 )); then
printf '用法: %s user@host\n' "$0" >&2
exit 64
fi
target="$1"
remote_cmd='printf "remote-host=%s\n" "$(hostname)"; printf "work=ok\n"; exit 7'
stdout_file="$(mktemp)"
stderr_file="$(mktemp)"
trap 'rm -f "$stdout_file" "$stderr_file"' EXIT
ssh -o BatchMode=yes "$target" "$remote_cmd" >"$stdout_file" 2>"$stderr_file"
status=$?
printf 'stdout:\n'
cat "$stdout_file"
printf 'stderr:\n'
cat "$stderr_file"
printf 'ssh-exit=%d\n' "$status"把 <HOST> 替换为已配置密钥认证且主机密钥已确认的服务器地址,再执行:
bash remote-check.sh "ops@<HOST>"预期输出
stdout:
remote-host=<HOST>
work=ok
stderr:
ssh-exit=7远端实际主机名可能与连接地址不同,因此 remote-host= 后的值以服务器 hostname 输出为准。这里的 ssh-exit=7 说明远端命令的退出状态已经传回本地。
区分远端失败和 SSH 失败
当远端命令成功启动后,ssh 通常返回该命令自己的退出码,所以脚本可以把非 0 状态继续交给上层流程处理。若 DNS、网络、主机密钥校验或认证失败,OpenSSH 通常返回 255,并把原因写到标准错误。
BatchMode=yes 适合自动化,因为它禁止交互式密码或确认提示;这也意味着密钥认证和 known_hosts 必须事先准备好。不要为了省事在自动化中关闭主机密钥校验,否则会失去 SSH 对服务器身份的校验能力。
远程命令的引用边界
固定命令最适合直接写在单引号中,让变量和命令替换在远端发生。需要把本地动态值传给远端时,不要简单拼接未经校验的用户输入,否则可能形成命令注入;复杂参数更适合通过脚本参数、标准输入或预先部署的远端脚本传递。
在批量服务器任务中,可靠做法是同时记录目标主机、标准输出、标准错误和退出码。只有把“命令执行失败”和“SSH 链路失败”分开,后续重试、告警和并发控制才不会把不同故障混在一起。