Arquitetura de Wazuh e Implantação com Docker Compose
Guia de implantação modular do Wazuh 4.9 em containers Docker, atribuição de credenciais alfanuméricas complexas e mapa de roteamento de portas de segurança.
Este guia detalha o procedimento técnico padrão para a implantação do Wazuh 4.9 em um ambiente Dockerizado de nó único (single-node). Este módulo aborda o planejamento de recursos, a preparação do ambiente do host, a estruturação do arquivo docker-compose.yml e a arquitetura de roteamento de rede de segurança.
1. Planejamento de Credenciais e Fortalecimento
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Para evitar erros de parsing durante a inicialização dos containers pelo motor Docker (como a interpretação incorreta de caracteres especiais como $ ou * em arquivos YAML) e cumprir estritamente as diretivas de segurança do Wazuh, foi definida uma matriz de credenciais alfanuméricas de alta entropia para os serviços principais:
| Componente / Serviço | Identidade / Usuário | Senha Fictícia de Exemplo | Notas de Integração |
|---|---|---|---|
| Interface do Wazuh (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Conta de acesso principal de administração web. |
| API Interna de Wazuh | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Obrigatório terminar em ponto . para cumprir a diretiva de símbolos. |
| Serviço de Comunicação | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Conta utilizada para a comunicação interna entre nós. |
2. Provisionamento do Ambiente no Host (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»O despliegue completo se consolidará sob o diretório do host: /opt/wazuh-stack/single-node
A. Clonar a Branch do Repositório Oficial
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh requiere certificados SSL/TLS
# 1. Crear el directorio y clonar el repositorio oficial de desplieguesudo mkdir -p /opt/wazuh-stacksudo chown -R $USER:$USER /opt/wazuh-stackgit clone https://github.com/wazuh/wazuh-docker.git -b v4.9.0 /opt/wazuh-stack
# 2. Posicionarse en el directorio del nodo únicocd /opt/wazuh-stack/single-nodeB. Geração da Autoridade de Certificação e Certificados TLS
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»Inicialize o contêiner temporário gerador para provisionar automaticamente a infraestrutura de chaves públicas (PKI) e as assinaturas digitais dos serviços:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Arquivo Docker Compose de Produção
Sección titulada «3. Archivo Docker Compose de Producción»Este arquivo contém a declaração final de serviços, limites de memória de kernel otimizados e as credenciais estáticas iniciais do ambiente.
Ruta do arquivo: /opt/wazuh-stack/single-node/docker-compose.yml
# Wazuh App Copyright (C) 2017, Wazuh Inc. (License GPLv2)services: wazuh.manager: image: wazuh/wazuh-manager:4.9.0 hostname: wazuh.manager restart: always ports: - "1514:1514" - "1515:1515" - "514:514/udp" - "55000:55000" ulimits: memlock: soft: -1 hard: -1 nofile: soft: 655360 hard: 655360 environment: - INDEXER_URL=https://wazuh.indexer:9200 - INDEXER_USERNAME=admin - INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1 - FILEBEAT_SSL_VERIFICATION_MODE=full - SSL_CERTIFICATE_AUTHORITIES=/etc/ssl/root-ca.pem - SSL_CERTIFICATE=/etc/ssl/filebeat.pem - SSL_KEY=/etc/ssl/filebeat.key - API_USERNAME=wazuh-wui - API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9. - TZ=Europe/Madrid volumes: - wazuh_api_configuration:/var/ossec/api/configuration - wazuh_etc:/var/ossec/etc - wazuh_logs:/var/ossec/logs - wazuh_queue:/var/ossec/queue - wazuh_var_multigroups:/var/ossec/var/multigroups - wazuh_integrations:/var/ossec/integrations - wazuh_active_response:/var/ossec/active-response/bin - wazuh_agentless:/var/ossec/agentless - wazuh_wodles:/var/ossec/wodles - filebeat_etc:/etc/filebeat - filebeat_var:/var/lib/filebeat - ./config/wazuh_indexer_ssl_certs/root-ca-manager.pem:/etc/ssl/root-ca.pem - ./config/wazuh_indexer_ssl_certs/wazuh.manager.pem:/etc/ssl/filebeat.pem - ./config/wazuh_indexer_ssl_certs/wazuh.manager-key.pem:/etc/ssl/filebeat.key - ./config/wazuh_cluster/wazuh_manager.conf:/wazuh-config-mount/etc/ossec.conf
wazuh.indexer: image: wazuh/wazuh-indexer:4.9.0 hostname: wazuh.indexer restart: always ports: - "9200:9200" environment: - "OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g" - TZ=Europe/Madrid ulimits: memlock: soft: -1 hard: -1 nofile: soft: 65536 hard: 65536 volumes: - wazuh-indexer-data:/var/lib/wazuh-indexer - ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-indexer/certs/root-ca.pem - ./config/wazuh_indexer_ssl_certs/wazuh.indexer-key.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.key - ./config/wazuh_indexer_ssl_certs/wazuh.indexer.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.pem - ./config/wazuh_indexer_ssl_certs/admin.pem:/usr/share/wazuh-indexer/certs/admin.pem - ./config/wazuh_indexer_ssl_certs/admin-key.pem:/usr/share/wazuh-indexer/certs/admin-key.pem - ./config/wazuh_indexer/wazuh.indexer.yml:/usr/share/wazuh-indexer/opensearch.yml - ./config/wazuh_indexer/internal_users.yml:/usr/share/wazuh-indexer/opensearch-security/internal_users.yml
wazuh.dashboard: image: wazuh/wazuh-dashboard:4.9.0 hostname: wazuh.dashboard restart: always ports: - "443:5601" environment: - INDEXER_USERNAME=admin - INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1 - WAZUH_API_URL=https://wazuh.manager - DASHBOARD_USERNAME=kibanaserver - DASHBOARD_PASSWORD=yQ3wV8xR9pK2mN6tT5sR4vC1 - API_USERNAME=wazuh-wui - API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9. - TZ=Europe/Madrid volumes: - ./config/wazuh_indexer_ssl_certs/wazuh.dashboard.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard.pem - ./config/wazuh_indexer_ssl_certs/wazuh.dashboard-key.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard-key.pem - ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-dashboard/certs/root-ca.pem - ./config/wazuh_dashboard/opensearch_dashboards.yml:/usr/share/wazuh-dashboard/config/opensearch_dashboards.yml - ./config/wazuh_dashboard/wazuh.yml:/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml - wazuh-dashboard-config:/usr/share/wazuh-dashboard/data/wazuh/config - wazuh-dashboard-custom:/usr/share/wazuh-dashboard/plugins/wazuh/public/assets/custom depends_on: - wazuh.indexer links: - wazuh.indexer:wazuh.indexer - wazuh.manager:wazuh.manager
networks: default: name: wazuh_local
volumes: wazuh_api_configuration: wazuh_etc: wazuh_logs: wazuh_queue: wazuh_var_multigroups: wazuh_integrations: wazuh_active_response: wazuh_agentless: wazuh_wodles: filebeat_etc: filebeat_var: wazuh-indexer-data: wazuh-dashboard-config: wazuh-dashboard-custom:4. Mapa de Roteamento de Portas (Rede de Segurança)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»Para permitir que os analistas do Blue Team configurem corretamente as regras de filtrado perimetral (tais como firewalls pfSense ou políticas do host), se detalha a função técnica dos puertos mapeados:
A. Contenedor: wazuh.manager (Cerebro de Análisis)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»- 1514 (TCP/UDP) - Agentes: Puerto de comunicação crítico. Os agentes recopiladores remotos enviam por aqui seus logs descifrados e metadados em tempo real.
- 1515 (TCP) - Authd: Puerto do serviço de registro de agentes. É utilizado exclusivamente ao emparejar um novo nodo para gerar e transmitir a chave de cifrado simétrico simétrica.
- 514 (UDP) - Syslog: Servicio opcional
- 55000 (TCP) - API REST: Interfaz de controle do Manager. É consumida pelo Dashboard para processar consultas de administração interna.
B. Contenedor: wazuh.indexer (Almacenamiento)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»- 9200 (TCP) - OpenSearch API: Puerto de lectura/escritura da base de dados de indexação. Filebeat introduz as alertas aqui e o Dashboard as recupera para mostrar as em gráficos.
C. Contenedor: wazuh.dashboard (Consola Web)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»- 443 ➔ 5601 (TCP) - Portal HTTPS: O serviço interno utiliza o puerto 5601, mas é mapeado em Docker para o porto estándar 443 (HTTPS) no anfitrião para permitir acessos limpos e diretos do navegador sem especificar portos atípicos.
5. Inicialização de Contêineres
Sección titulada «5. Inicialización de Contenedores»Uma vez estruturado o arquivo docker-compose.yml, levante a infraestrutura em segundo plano:
sudo docker compose up -dAviso de Segurança
Ainda que os contenedores inicialicem corretamente no motor de Docker, a suite não será funcional nem segura até que se gerem e injetem os hashes encriptados detalhados no seguinte documento.

