Linux 与服务器运维 / 系统课时

通过 SSH 批量执行远程任务

通过 SSH 批量执行远程任务

批量 SSH 最容易出错的不是循环,而是“哪一层 Shell 在展开变量和通配符”。本课用主机清单、连接参数数组和引用 heredoc,把远程脚本原样交给远端 Bash,并为每台主机保留独立退出码。

学习目标

  • 能从主机清单逐台执行 SSH,并统一管理连接参数。
  • 能避免 $变量、*、命令替换在本地提前展开。
  • 能区分远端命令失败与 SSH 连接失败,并汇总批处理退出状态。

先认清两层 Shell

执行 ssh host 'command' 时,命令通常至少经过本地 Shell 和远端 Shell 两层解析。复杂命令里一旦混入 $()、$VAR、通配符或多层引号,本地提前展开就可能把错误内容送到远端。

SSH 批量执行中的本地与远端展开边界

对于批量任务,较稳妥的做法是让本地只负责“选主机和建立连接”,把真正要执行的脚本通过标准输入交给远端 bash -s。这样可以明显减少嵌套引号。

准备主机清单

建立 hosts.txt,每行写一个 SSH 目标,可以直接包含用户名。空行和以 # 开头的注释会在脚本里忽略。

text
ops@10.0.0.11
ops@10.0.0.12
# ops@10.0.0.13

主机密钥认证和可信主机指纹应提前配置好,批处理脚本不要依赖交互式密码输入。示例使用 BatchMode=yes,认证不可用时会直接失败而不是卡住等待输入。

用引用 heredoc 发送远端脚本

下面脚本可直接保存为 batch-ssh.sh。<<'REMOTE' 中的分隔符被单引号保护,因此 heredoc 内容不会在本地展开;$(hostname) 和 awk 中的 $5 都由远端 Bash 处理。

bash
#!/usr/bin/env bash
set -u

hosts_file="${1:-hosts.txt}"
overall=0

ssh_opts=(
  -o BatchMode=yes
  -o ConnectTimeout=5
  -o ServerAliveInterval=15
  -o StrictHostKeyChecking=yes
)

while IFS= read -r host || [[ -n "$host" ]]; do
  [[ -z "$host" || "$host" == \#* ]] && continue

  if ssh "${ssh_opts[@]}" "$host" 'bash -s' <<'REMOTE'
set -euo pipefail

printf 'host=%s\n' "$(hostname)"
df -P / | awk 'NR == 2 { print "root_use=" $5 }'
REMOTE
  then
    printf '[OK] %s\n' "$host"
  else
    rc=$?
    printf '[FAIL] %s rc=%d\n' "$host" "$rc" >&2
    overall=1
  fi
done < "$hosts_file"

exit "$overall"

预期结果

text
脚本保存后不会自动连接主机;运行时会逐台执行远端脚本,并以 0 表示全部成功、1 表示至少一台失败。

为脚本增加执行权限后传入主机清单。

bash
chmod +x batch-ssh.sh
./batch-ssh.sh hosts.txt

预期输出

text
host=<HOSTNAME_1>
root_use=<PERCENT_1>
[OK] ops@10.0.0.11
host=<HOSTNAME_2>
root_use=<PERCENT_2>
[OK] ops@10.0.0.12

主机名和磁盘占用率是动态值。只要所有主机任务都成功,脚本最终退出码为 0;任意一台失败,最终退出码为 1,便于被 CI、发布平台或上层运维脚本判断。

正确处理退出码

SSH 正常建立连接后,会把远端命令的退出状态返回给本地;如果 SSH 自身发生连接、认证或协议级失败,常见退出码是 255。因此批量脚本应记录“哪台主机失败”和具体 rc,不要用一个总错误覆盖所有节点。

如果远端脚本主动 exit 23,本地该次 ssh 通常也会得到 23;如果目标端口不可达,则更可能得到 255。实际排查时先根据返回码判断是“远端任务失败”还是“根本没连上”。

避免最常见的展开错误

不要把包含大量双引号、命令替换和 awk 变量的远端命令直接拼成一个本地字符串。尤其是 "$VAR"、$(command) 和 *,只要引用层级写错,就可能在本地先展开,导致不同主机收到不同于预期的文本。

引用 heredoc 的核心价值是明确边界:主机名和 SSH 参数在本地决定,远端脚本保持原样传输,到目标机后才展开。配合逐主机退出码、可信主机校验与非交互认证,批量 SSH 才能从“一次性循环”升级为可复用的自动化执行单元。

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

目录与阅读设置

阅读设置

17

记录一个想法

通过 SSH 批量执行远程任务

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

登录哪都通