Linux 与服务器运维 / 知识点

SSH 配置与排障手册

手册条目

通过 SSH 非交互执行单条命令、脚本或流水线任务。

执行远程命令

用于在不进入交互式终端的情况下,让远端主机执行单条命令、短脚本或流水线步骤。重点是控制认证方式、超时、引用边界和退出状态,使任务在终端与 CI 中都能得到可判断的结果。

命令定位

ssh 在目标主机完成认证后,会把主机名后面的内容交给远端 shell 执行;标准输出和标准错误返回本地,ssh 的退出状态通常等于远端命令的退出状态。连接或认证失败时通常返回 255。

基本语法

bash
ssh [SSH_OPTIONS] [USER@]HOST 'REMOTE_COMMAND'

远端命令优先使用单引号包住,避免本地 shell 提前展开 $变量、通配符和命令替换。需要本地展开的值应先校验,再通过标准输入或受控脚本传递,不要直接拼接到命令字符串。

高频用法

执行单条命令并读取退出状态

bash
ssh -o BatchMode=yes -o ConnectTimeout=5 ops@server.example.com \
  'printf "host=%s\n" "$(hostname)"; systemctl is-active nginx'
printf 'exit=%s\n' "$?"

预期输出

text
host=<HOSTNAME>
active
exit=0

<HOSTNAME> 由远端实际主机名决定。若 nginx 未运行,第二行可能是 inactive,退出状态也会变为非零;脚本应据此停止后续发布或触发告警。

通过标准输入执行短脚本

bash
ssh -T ops@server.example.com 'bash -s -- /tmp' <<'REMOTE'
set -euo pipefail
target=$1
printf 'target=%s\n' "$target"
test -d "$target"
printf 'status=ok\n'
REMOTE

预期输出

text
target=/tmp
status=ok

-T 明确禁止分配伪终端,适合 CI、管道和脚本输入。这里文档结束标记使用引号,脚本中的 $1 会在远端展开,不会被本地 shell 改写。

常用参数

参数 什么时候用
-T 非交互命令、脚本输入或二进制流,避免伪终端改写数据
-t 远端程序明确要求 TTY 时使用;自动化中应谨慎
-o BatchMode=yes 禁止密码和口令交互,认证失败立即退出
-o ConnectTimeout=5 限制 TCP 建连和 SSH 握手等待时间
-o ServerAliveInterval=30 长任务中定期探测连接,配合 ServerAliveCountMax 使用
-J bastion 通过跳板机连接目标主机

风险与边界

把未经校验的用户输入、文件名或分支名直接拼进远端命令,会触发命令注入,可能删除文件或泄露凭据。安全做法是固定远端命令,只通过标准输入传递数据,或调用预先部署且会校验参数的脚本。

远端 sudo 若需要密码或 TTY,任务会挂起或报错;盲目加 -t 还可能破坏管道输出。自动化应使用权限最小化的 sudo -n 规则,并让失败立即返回,而不是在流水线中等待输入。

非交互 shell 通常不会加载登录配置,PATH、代理和语言环境可能与手工登录不同。关键命令使用绝对路径,或显式执行受控的 bash -lc;不要依赖个人 .bashrc 中的别名和交互逻辑。

排障清单

先运行 ssh -vvv USER@HOST 'true' 区分 DNS、网络、主机密钥和认证问题;再检查 echo $?。出现 command not found 时核对远端 PATH,出现长时间无输出时增加连接超时和保活参数,并确认远端命令是否在等待标准输入。

目录与阅读设置

记录一个想法

SSH 配置与排障手册

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

登录哪都通