Обзор развертывания Wazuh на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие параметры и настройки:
-
Операционная система: Ubuntu (рекомендуется).
-
Права доступа: Права
rootдля выполнения установки пакетов и управления Docker. -
Порты:
-
Внутренний порт приложения:
8080. -
Внешний порт (HTTPS):
443.
FQDN итоговой панели на домене hostkey.in¶
Для доступа к интерфейсу используется следующий шаблон домена:
| Параметр | Значение |
|---|---|
| Префикс | wazuh |
| Домен | hostkey.in |
| Полный шаблон | wazuh{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные директории, используемые в системе:
-
/opt/wazuh— рабочая директория установки приложения, где хранятся установочные скрипты и конфигурационные файлы. -
/root/nginx— директория для управления контейнером обратного прокси. -
/data/nginx/user_conf.d— директория с конфигурационными файлами Nginx.
Процесс установки приложения¶
Установка выполняется в несколько этапов с использованием официального установочного скрипта:
-
Подготовка окружения: Обновление системных пакетов через
apt, создание рабочей директории/opt/wazuhи загрузка установочного скриптаwazuh-install.sh. -
Конфигурация: Создание файла
config.ymlс описанием узлов (indexer, server, dashboard) и генерация необходимых файлов конфигурации. -
Развертывание компонентов:
-
Установка компонента Wazuh Indexer.
-
Запуск кластера.
-
Установка сервера Wazuh.
-
Установка панели управления (Wazuh Dashboard) на порт
8080.
Права доступа и безопасность¶
-
Для защиты данных используется ограничение прав на файл с паролями:
/opt/wazuh/passwordимеет права0600. -
После завершения установки репозиторий Wazuh в системе отключается для предотвращения случайных обновлений через пакетный менеджер.
-
Конфигурационные файлы приложения имеют строгие ограничения прав доступа (
0600).
Базы данных¶
В качестве хранилища данных используется компонент Wazuh Indexer, который разворачивается как часть основного кластера Wazuh. Данные индексируются и хранятся внутри инфраструктуры компонентов Wazuh.
Контейнеры Docker и их запуск¶
Для обеспечения работы веб-интерфейса через защищенное соединение используется следующий контейнер:
| Имя образа | Порты | Тома (volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | host mode | - nginx_secrets:/etc/letsencrypt- /data/nginx/user_conf.d:/etc/nginx/user_conf.d | CERTBOT_EMAIL=hkadm@hostkey.com | unless-stopped |
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Генерация конфигурации: Выполняется команда
./wazuh-install.sh --generate-config-filesдля подготовки среды. -
Извлечение учетных данных: Скрипт автоматически извлекает пароль администратора (
admin) из сгенерированных файлов и сохраняет его в/opt/wazuh/password. -
Настройка проксирования: В конфигурационные файлы Nginx автоматически добавляется директива
proxy_pass, направляющая трафик на внутренний порт приложенияhttps://wazuh{Server_ID_from_Invapi}.hostkey.in:8080.
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо использовать официальный установочный скрипт, выполнив соответствующие команды обновления компонентов через него.
Расположение конфигурационных файлов и данных¶
-
/opt/wazuh/config.yml— основной файл конфигурации узлов. -
/data/nginx/user_conf.d/wazuh{Server_ID_from_Invapi}.hostkey.in.conf— настройки проксирования Nginx.
Доступные порты для подключения¶
-
443(HTTPS) — внешний доступ к панели управления через домен. -
8080(HTTP/HTTPS) — внутренний доступ к интерфейсу Dashboard. -
9200— порт взаимодействия с Indexer (внутренний).
Запуск, остановка приложения¶
Управление компонентами осуществляется через установочный скрипт в директории /opt/wazuh. Контейнер Nginx управляется стандартными командами Docker Compose из директории /root/nginx:
-
docker compose up -d— запуск прокси-сервера. -
docker compose down— остановка прокси-сервера.