[comment]: # aside:5

[comment]: # ({1f370d7c-8ac5649a})
# 注册新模块

本节介绍如何向 Zabbix 前端添加新模块。

[comment]: # ({/1f370d7c-8ac5649a})

[comment]: # ({344a327f-cfc878a8})
## 先决条件

继续操作之前，请确保：

- 模块位于 Zabbix 前端安装的 *modules* 目录中（例如，*zabbix/ui/modules*）。
- 模块至少有一个基本版本的 [manifest.json](/devel/modules/file_structure/manifest) 文件。
- 您可以访问 Zabbix 中的管理菜单部分（需要超级管理员用户角色类型）。

:::notetip
前端不会安装和识别不兼容的模块。
:::

[comment]: # ({/344a327f-cfc878a8})

[comment]: # ({7edeb17f-65ec7200})
## 添加模块

打开 *Administration→General→Modules* 页面并点击 *Scan directory*。

![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)

在列表中找到你的模块并将其激活。

要激活模块，请点击 *Disabled* 超链接 - 模块状态将变为 *Enabled*。

点击模块名称可查看有关该模块的更多信息，例如作者、版本或简短描述（如果在 manifest 中定义）。

[comment]: # ({/7edeb17f-65ec7200})

[comment]: # ({2ef587f7-b30bf9b8})
## 小组件预览

小组件模块一旦添加后，将立即显示在仪表板小组件列表中。

您可以打开一个仪表板，切换到编辑模式，并像往常一样将该小组件添加到仪表板中。

当您对小组件进行一些更改后，请刷新仪表板，以查看该小组件在最新更新后的显示效果。

[comment]: # ({/2ef587f7-b30bf9b8})