命令行与文本处理 / 系统课时

怎样通过 SSH 执行远程命令

怎样通过 SSH 执行远程命令

自动化脚本经常需要在多台服务器上检查状态、执行维护命令并判断是否成功。SSH 不只提供交互式登录,也能直接运行远程命令;关键是区分远端标准输出、标准错误和 SSH 自身的退出状态。

学习目标

  • 使用 ssh user@host 'command' 执行远程命令
  • 在本地分别获取远端标准输出、标准错误和退出状态
  • 区分远程命令失败与 SSH 连接或认证失败

SSH 命令的执行链路

本地 Shell 先启动 ssh 客户端,SSH 建立加密连接并认证,然后把指定命令交给远端 Shell 执行。远端命令产生的标准输出和标准错误会沿连接返回本地,ssh 进程最终以远端命令的状态码退出;如果连接或认证本身失败,OpenSSH 通常使用 255。

SSH 远程命令的输入输出与退出状态链路

远程命令放在单引号中,可以避免本地 Shell 先展开其中的 $(...)、$VAR 等表达式。例如 $(hostname) 应该由远端 Shell 求值,而不是在本机提前替换。

获取标准输出和退出状态

下面的完整脚本把标准输出和标准错误分别写入临时文件,并保存 ssh 的退出状态。示例中的远端命令最后执行 exit 7,用于验证状态码是否能原样传回本地。

bash
#!/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
bash remote-check.sh "ops@<HOST>"

预期输出

text
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 链路失败”分开,后续重试、告警和并发控制才不会把不同故障混在一起。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样通过 SSH 执行远程命令

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通