命令行与文本处理 / 系统课时
批量 SSH 操作如何避免失控
批量 SSH 操作如何避免失控
批量 SSH 的危险不在于命令本身,而在于同一错误会被同时放大到多台服务器。本节把主机校验、dry-run、连接超时和并发上限放进同一执行链,让批处理在真正连接服务器前就能拦截明显风险。
学习目标
- 在执行 SSH 前校验主机列表,避免异常目标进入批处理
- 使用 dry-run、超时和并发限制控制批量操作的影响范围
- 区分连接失败、远程命令失败与超时,保留可追踪的退出状态
批量执行为什么容易失控
单机 SSH 失败通常只影响一次操作,批量脚本却会把同一个配置错误扩散到整个主机集。例如主机清单混入测试节点、网络故障导致连接长期阻塞,或者一次启动数百个 SSH 进程,都可能让原本简单的命令变成事故。
比较稳妥的执行顺序是:先读取并校验主机,再显示将要执行的操作;只有明确关闭 dry-run 后才建立连接,并且每个连接都受总超时和并发上限约束。

把安全边界写进脚本
下面的示例只允许访问 .internal 域名,默认开启 dry-run。真实执行时使用 BatchMode=yes 禁止等待交互式密码,ConnectTimeout 限制建连时间,GNU timeout 再限制单台主机的整个 SSH 调用时间。并发数通过 xargs -P 固定,而不是为所有主机无限制地启动后台进程。
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 连接。
[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,就是为了让未知或发生变化的主机密钥直接失败,而不是静默接受。
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 把所有失败吞掉。批量脚本真正安全的关键,是让错误尽早停止、真实操作默认关闭,并且让一次执行能够影响的服务器数量始终存在明确上限。