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

批量 SSH 操作如何避免失控

批量 SSH 操作如何避免失控

批量 SSH 的危险不在于命令本身,而在于同一错误会被同时放大到多台服务器。本节把主机校验、dry-run、连接超时和并发上限放进同一执行链,让批处理在真正连接服务器前就能拦截明显风险。

学习目标

  • 在执行 SSH 前校验主机列表,避免异常目标进入批处理
  • 使用 dry-run、超时和并发限制控制批量操作的影响范围
  • 区分连接失败、远程命令失败与超时,保留可追踪的退出状态

批量执行为什么容易失控

单机 SSH 失败通常只影响一次操作,批量脚本却会把同一个配置错误扩散到整个主机集。例如主机清单混入测试节点、网络故障导致连接长期阻塞,或者一次启动数百个 SSH 进程,都可能让原本简单的命令变成事故。

比较稳妥的执行顺序是:先读取并校验主机,再显示将要执行的操作;只有明确关闭 dry-run 后才建立连接,并且每个连接都受总超时和并发上限约束。

批量 SSH 安全执行流程

把安全边界写进脚本

下面的示例只允许访问 .internal 域名,默认开启 dry-run。真实执行时使用 BatchMode=yes 禁止等待交互式密码,ConnectTimeout 限制建连时间,GNU timeout 再限制单台主机的整个 SSH 调用时间。并发数通过 xargs -P 固定,而不是为所有主机无限制地启动后台进程。

bash
cat > batch-ssh.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

HOST_FILE=${1:?usage: batch-ssh.sh HOST_FILE REMOTE_CMD}
REMOTE_CMD=${2:?usage: batch-ssh.sh HOST_FILE REMOTE_CMD}
MAX_PARALLEL=${MAX_PARALLEL:-4}
CONNECT_TIMEOUT=${CONNECT_TIMEOUT:-5}
TOTAL_TIMEOUT=${TOTAL_TIMEOUT:-15}
DRY_RUN=${DRY_RUN:-1}

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

  # 先限制字符集合,再限制允许访问的域,避免异常目标进入执行阶段。
  if [[ ! "$host" =~ ^[A-Za-z0-9.-]+$ || "$host" != *.internal ]]; then
    printf 'invalid host: %s\n' "$host" >&2
    exit 2
  fi
  hosts+=("$host")
done < "$HOST_FILE"

run_one() {
  local host=$1
  if (( DRY_RUN )); then
    printf '[DRY-RUN] host=%s command=%q\n' "$host" "$REMOTE_CMD"
    return 0
  fi

  # timeout 控制整个调用,ConnectTimeout 只控制 SSH 建连阶段。
  if timeout "${TOTAL_TIMEOUT}s" ssh \
    -o BatchMode=yes \
    -o ConnectTimeout="$CONNECT_TIMEOUT" \
    -o StrictHostKeyChecking=yes \
    "$host" "$REMOTE_CMD"; then
    printf '[OK] %s\n' "$host"
  else
    rc=$?
    printf '[FAIL] host=%s rc=%d\n' "$host" "$rc" >&2
    return "$rc"
  fi
}

export REMOTE_CMD CONNECT_TIMEOUT TOTAL_TIMEOUT DRY_RUN
export -f run_one
printf '%s\0' "${hosts[@]}" | xargs -0 -r -n1 -P "$MAX_PARALLEL" bash -c 'run_one "$1"' _
EOF

cat > hosts.txt <<'EOF'
app01.internal
app02.internal
EOF

chmod +x batch-ssh.sh
DRY_RUN=1 MAX_PARALLEL=2 ./batch-ssh.sh hosts.txt 'uname -n'

预期输出如下;并发执行时两行先后顺序可能不同,但 dry-run 不会建立任何 SSH 连接。

text
[DRY-RUN] host=app01.internal command=uname\ -n
[DRY-RUN] host=app02.internal command=uname\ -n

真正执行前再做一次确认

确认 dry-run 中的主机数量、目标域和远程命令都正确后,才将 DRY_RUN 改为 0。生产环境还应提前把服务器主机密钥写入 known_hosts,示例保留 StrictHostKeyChecking=yes,就是为了让未知或发生变化的主机密钥直接失败,而不是静默接受。

bash
DRY_RUN=0 MAX_PARALLEL=4 ./batch-ssh.sh hosts.txt 'uname -n'

预期结果是每台可连接主机先输出远程 uname -n 的结果,再出现对应的 [OK];连接失败、主机密钥不匹配、远程命令返回非零状态或达到 <TIME> 秒总超时的主机会出现 [FAIL] host=<HOST> rc=<ID>。主机名、退出码和完成顺序会随实际环境变化。

失败时先判断是哪一层

连接阶段超时通常说明地址、路由、防火墙或 SSH 服务不可达;SSH 已连接但远程命令返回非零状态,则应检查远程命令自身。若大量任务同时失败,不要立刻提高并发数或延长超时,应先缩小到一台已知服务器复现。

timeout 返回的状态也属于脚本需要保留的证据,因此不要用 || true 把所有失败吞掉。批量脚本真正安全的关键,是让错误尽早停止、真实操作默认关闭,并且让一次执行能够影响的服务器数量始终存在明确上限。

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

目录与阅读设置

阅读设置

17

记录一个想法

批量 SSH 操作如何避免失控

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

登录哪都通