3 前端模块

概述

可以通过添加第三方模块或开发自己的模块来增强 Zabbix 前端功能，而无需更改 Zabbix 的源代码。

请注意，模块代码将以与 Zabbix 源代码相同的权限运行。这意味着：

  • 第三方模块可能会造成危害。您必须信任您正在安装的模块；
  • 第三方模块代码中的错误可能会导致前端崩溃。如果发生这种情况，只需从前端删除模块代码即可。重新加载 Zabbix 前端后，您会看到一条提示，提示某些模块缺失。转到模块管理（在Administration → General → Modules），然后再次单击扫描目录以从数据库中删除不存在的模块。

安装

请务必阅读特定模块的安装手册。建议逐个安装新模块，以便更容易发现故障。

在安装模块之前：

  • 确保您是从可信来源下载该模块的。安装有害代码可能会导致诸如数据丢失等后果
  • 同一模块的不同版本（相同 ID）可以并行安装，但一次只能启用一个版本

安装模块的步骤：

  • 在 Zabbix 前端 的 modules 文件夹中，为您的模块创建其独立文件夹并解压模块内容
  • 确保您的模块文件夹中至少包含 manifest.json 文件
  • 前往模块管理，然后点击 扫描目录 按钮
  • 新模块将显示在列表中，同时显示其版本、作者、描述和状态
  • 点击模块状态以启用模块

故障排查：

问题 解决方案
模块未出现在列表中 如果您的模块未出现在列表中，请确认 modules/your-module/ 中存在 manifest.json 文件。如果不存在，您可能将模块解压到了错误的目录中。如果存在，则该模块可能与您的 Zabbix 版本不兼容。另外，请检查 Web 服务器用户对模块文件夹及其所有子目录至少具有读取和搜索权限（r-x），并对其中所有文件具有读取权限（r--）。
前端崩溃 该模块代码与当前 Zabbix 版本或服务器配置不兼容。请删除模块文件并重新加载前端。您将看到某些模块缺失的提示。前往模块管理，再次点击 扫描目录，以从数据库中移除不存在的模块。
出现关于相同命名空间、ID 或操作的错误消息 新模块尝试注册已被其他已启用模块注册的命名空间、ID 或操作。请先禁用冲突的模块（错误消息中会提及），然后再启用新模块。
出现技术性错误消息 请将错误报告给该模块的开发者。

开发模块

有关开发自定义模块的信息，请参阅开发者中心。