Documentation
9 SSH检查
概述
SSH 检查以无代理监控的形式执行。SSH 检查不需要 Zabbix 代理。
要执行 SSH 检查，Zabbix 服务器必须首先配置 SSH2支持 (libssh 或 libssh2)。另请参阅：要求。
从 RHEL 8 开始，仅支持 libssh。对于其他发行版，建议使用 libssh 而不是 libssh2。
配置
密码验证
SSH 检查提供两种验证方法 - 用户/密码对和基于密钥文件。
如果您不打算使用密钥，则无需进行其他配置，除了将 libssh 或 libssh2 链接到 Zabbix（如果您从源代码构建）之外。
密钥文件身份验证
要对 SSH 项目使用基于密钥的身份验证，需要对服务器配置进行某些更改。
以“root”身份打开 Zabbix 服务器配置文件 (zabbix_server.conf) 并查找以下行：
取消注释并设置公钥和私钥所在文件夹的完整路径：
保存文件并重新启动 Zabbix 服务器。
此处的路径 /home/zabbix 是 zabbix 用户帐户的主目录，而 .ssh 是默认的目录，其中的公钥和私钥将由主目录中的 ssh-keygen 命令生成。
通常，不同操作系统发行版的 Zabbix 服务器安装包会在其他地方创建 zabbix 用户帐户，其主目录为 /var/lib/zabbix（对于系统帐户而言）。
在生成密钥之前，您可以将主目录重新分配到 /home/zabbix，以便它与上面提到的 SSHKeyLocation Zabbix 服务器配置参数相对应。
如果已根据 安装部分 手动添加了 zabbix 帐户，则可以跳过以下步骤。在这种情况下，zabbix 帐户的主目录很可能已经是/home/zabbix。
要更改 zabbix 用户帐户的主目录，必须停止所有正在使用它的工作进程：
要更改主目录位置并尝试移动它（如果存在），应执行以下命令：
也可能主目录在旧位置不存在，因此应在新位置创建它。一个安全的尝试是：
为了确保一切安全，可以执行其他命令来设置主目录的权限：
现在可以重新启动先前停止的进程：
现在，可以使用以下命令执行生成公钥和私钥的步骤（为了更好的可读性，命令提示符被注释掉）：
sudo -u zabbix ssh-keygen -t rsa
# 生成公钥/私钥 rsa 密钥对。
# 输入要保存密钥的文件 (/home/zabbix/.ssh/id_rsa):
/home/zabbix/.ssh/id_rsa
# 输入密码（空表示无密码）：
<留空>
# 再次输入相同的密码：
<留空>
# 您的身份已保存在 /home/zabbix/.ssh/id_rsa 中。
# 您的公钥已保存在 /home/zabbix/.ssh/id_rsa.pub 中。
# 密钥指纹为：
# 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0
# 密钥的随机图像为：
# +--[ RSA 2048]----+
# | |
# | . |
# | o |
# | . o |
# |+ . S |
# |.+ o = |
# |E . * = |
# |=o . ..* . |
# |... oo.o+ |
# +-----------------+公钥和私钥（id_rsa.pub 和 id_rsa）已默认在 /home/zabbix/.ssh 目录中生成，该目录对应于 Zabbix 服务器 SSHKeyLocation 配置参数。
ssh-keygen 工具和 SSH 服务器可能支持除“rsa”之外的密钥类型，但 Zabbix 使用的 libssh2 可能不支持这些密钥类型。
Shell 配置表
对于每个将由 SSH 检查监控的主机，此步骤仅应执行一次。
通过使用以下命令，可以在远程主机 10.10.10.10 上安装 公钥 文件，以便可以使用 root 帐户执行 SSH 检查（为了更好的可读性，命令提示符被注释掉）：
sudo -u zabbix ssh-copy-id [email protected]
# 无法确定主机 '10.10.10.10 (10.10.10.10)' 的真实性。
# RSA 密钥指纹为 38:ba:f2:a4:b5:d9:8f:52:00:09:f7:1f:75:cc:0b:46。
# 您确定要继续连接吗（是/否）？
是
# 警告：已将“10.10.10.10”（RSA）永久添加到已知主机列表中。
# [email protected] 的密码：
<输入 root 密码>
# 现在尝试使用“ssh '[email protected]'”登录机器，
# 并检查以确保只添加了您想要的密钥。现在可以使用默认私钥（/home/zabbix/.ssh/id_rsa）检查 zabbix 用户帐户的 SSH 登录：
sudo -u zabbix ssh [email protected]如果登录成功，则 shell 中的配置部分已完成，可以关闭远程 SSH 会话。
监控项配置
实际要执行的命令必须放在项目配置中的 执行脚本字段中。通过将多个命令放在新行上，可以一个接一个地执行它们。在这种情况下，返回的值也将被格式化为多行。
所有必填输入字段都标有红色星号。
需要 SSH 项目特定信息的字段是：
| 参数 | 描述 | 注释 |
|---|---|---|
| 类型 | 在此处选择SSH 代理。 | |
| 密钥 | 格式为 ssh.run[unique short description,<ip>,<port>,<encoding>,<ssh options>] | unique short description 的唯一（每个主机）项目密钥是必需的，并且每个主机的每个 SSH 项目都应该是唯一的。 默认端口为 22，而不是此项目分配到的接口中指定的端口。 ssh 选项 允许以 key1=value1;key2=value2,value3 格式传递其他 SSH 选项。一个密钥的多个值可以用逗号分隔传递（在这种情况下，参数必须是 quote）；多个选项密钥可以用分号分隔传递。支持的选项键和值取决于 SSH 库。请注意，不支持使用“+”号来附加密码设置和使用“！”来禁用特定密码设置（如 GnuTLS 和 OpenSSL 中）。 示例： => ssh.run[KexAlgorithms,127.0.0.1,,,Ciphers=aes128-ctr]=> ssh.run[KexAlgorithms,,,,"KexAlgorithms=diffie-hellman-group1-sha1;HostkeyAlgorithms=ssh-rsa,ssh-dss,ecdh-sha2-nistp256"] |
| 身份验证方法 | “密码”或“公钥”之一。 | |
| 用户名 | 用于在远程主机上进行身份验证的用户名（最多 255 个字符）。必填。 | |
| 公钥文件 | 如果身份验证方法为“公钥”，则为公钥的文件名。必填。 | 示例：id_rsa.pub - 由命令 ssh-keygen 生成的默认公钥文件名。 |
| 私钥文件 | 如果身份验证方法为“公钥”，则为私钥的文件名。必填。 | 示例：id_rsa - 默认私钥文件名。 |
| 密码或 密钥密码 |
用于身份验证的密码（最多 255 个字符）或 密码如果用于私钥。 |
如果未使用密码，请将密钥密码字段留空。 另请参阅有关密码用法的已知问题。 |
| 执行的脚本 | 使用 SSH 远程会话执行的 shell 命令。 | 执行的 shell 命令的返回值限制为 16MB（包括被截断的尾随空格）；数据库限制 同样适用。 请注意，libssh2 库可能会将可执行脚本截断为 ~32kB。 示例： date +%s service mysql-server status ps auxww | grep httpd | wc -l |