[comment]: # ({94469ada-ed2f6c13})
# 2 Модули веб-интерфейса

[comment]: # ({/94469ada-ed2f6c13})

[comment]: # ({8c4f6bda-1060eddf})
#### Обзор

Можно улучшить функциональность веб-интерфейса Zabbix, добавив сторонние модули или разработав свои собственные модули без необходимости изменения исходного кода Zabbix.

Обратите внимание, что код модуля будет работать с теми же привилегиями, что и исходный код Zabbix. Это означает, что:

-   сторонние модули могут быть вредоносными. Вы должны доверять модулям, которые вы устанавливаете;
-   ошибки в коде стороннего модуля могут привести к сбою веб-интерфейса. Если это произойдёт, просто удалите код модуля из веб-интерфейса. Как только вы перезагрузите веб-интерфейс Zabbix, вы увидите уведомление о том, что некоторые модули отсутствуют. Перейдите к [Администрированию модулей](/manual/web_interface/frontend_sections/administration/general#модули) (в разделе *Администрирование* → *Общие* → *Модули* (*Administration* → *General* → *Modules*)) и нажмите *Сканировать директорию (Scan directory)*, чтобы удалить несуществующие модули из базы данных. 

[comment]: # ({/8c4f6bda-1060eddf})

[comment]: # ({5e6af176-cffdc09c})
#### Установка

Всегда читайте руководство по установке для конкретного модуля. Рекомендуется устанавливать новые модули по одному, чтобы легче выявлять сбои.

Перед установкой модуля:

-   Убедитесь, что вы загрузили модуль из надежного источника.
    Установка вредоносного кода может привести к последствиям, таким как потеря данных
-   Разные версии одного и того же модуля (с одним и тем же ID) можно устанавливать параллельно, но одновременно может быть включена только одна версия

Шаги по установке модуля:

-   Распакуйте модуль в отдельную папку внутри папки `modules` веб-интерфейса Zabbix
-   Убедитесь, что папка модуля содержит как минимум файл manifest.json
-   Перейдите в [Администрирование модулей](/manual/web_interface/frontend_sections/administration/general#modules)
    и нажмите кнопку *Сканировать каталог*
-   Новый модуль появится в списке вместе со своей версией, автором,
    описанием и статусом
-   Включите модуль, нажав на его статус

Устранение неполадок:

|Проблема|Решение|
|-------|--------|
|*Модуль не появился в списке*|Если ваш модуль не появился в списке, убедитесь, что manifest.json существует в modules/your-module/. Если его нет, возможно, вы распаковали модуль не в тот каталог. Если файл есть, модуль может быть несовместим с вашей версией Zabbix. Также проверьте, что пользователь веб-сервера имеет как минимум права на чтение и поиск (`r-x`) для папки модуля и всех подкаталогов, а также права на чтение (`r--`) для всех файлов внутри.|
|*Веб-интерфейс аварийно завершил работу*|Код модуля несовместим с текущей версией Zabbix или конфигурацией сервера. Удалите файлы модуля и перезагрузите веб-интерфейс. Вы увидите уведомление о том, что некоторые модули отсутствуют. Перейдите в [Администрирование модулей](/manual/web_interface/frontend_sections/administration/general#modules) и снова нажмите *Сканировать каталог*, чтобы удалить несуществующие модули из базы данных.|
|*Появляется сообщение об ошибке с одинаковыми namespace, ID или actions*|Новый модуль попытался зарегистрировать namespace, ID или actions, которые уже зарегистрированы другими включенными модулями. Перед включением нового модуля отключите конфликтующий модуль, указанный в сообщении об ошибке.|
|*Появляются технические сообщения об ошибках*|Сообщите об ошибках разработчику модуля.|

[comment]: # ({/5e6af176-cffdc09c})

[comment]: # ({5ca56638-26c922c0})
#### Разработка модулей

Информацию о разработке пользовательских модулей смотрите в [Центре разработчиков \[en\]](/devel/modules).

[comment]: # ({/5ca56638-26c922c0})