SSH 检查以无代理监控的形式执行。SSH 检查不需要 Zabbix agent。
要执行 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 可能不支持这些密钥类型。
对于每个将由 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 |