Arquitectura de Wazuh y Despliegue con Docker Compose
Guía de despliegue modular de Wazuh 4.9 en contenedores Docker, asignación de credenciales alfanuméricas complejas y mapa de enrutamiento de puertos de seguridad.
Esta guía detalla el procedimiento técnico estándar para el despliegue de Wazuh 4.9 en un entorno Dockerizado de nodo único (single-node). Este módulo aborda la planificación de recursos, la preparación del entorno del host, la estructuración del archivo docker-compose.yml y la arquitectura de enrutamiento de red de seguridad.
1. Planificación de Credenciales y Endurecimiento
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Para evitar errores de parseo durante la inicialización de los contenedores por el motor de Docker (como la interpretación incorrecta de caracteres especiales como $ o * en los archivos YAML) y cumplir estrictamente las directivas de seguridad de Wazuh, se ha definido una matriz de credenciales alfanuméricas de alta entropía para los servicios principales:
| Componente / Servicio | Identidad / Usuario | Contraseña Ficticia de Ejemplo | Notas de Integración |
|---|---|---|---|
| Interfaz de Wazuh (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Cuenta de acceso principal de administración web. |
| API Interna de Wazuh | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Obligatorio terminar en punto . para cumplir la directiva de símbolos. |
| Servicio de Comunicación | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Cuenta utilizada para la comunicación interna entre nodos. |
2. Aprovisionamiento del Entorno en el Host (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»El despliegue completo se consolidará bajo el directorio del host: /opt/wazuh-stack/single-node.
A. Clonar la Rama del Repositorio Oficial
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh requiere certificados SSL/TLS para cifrar de extremo a extremo las comunicaciones entre sus tres contenedores principales (Indexer, Manager y Dashboard). Accede a tu consola del host y clona la versión exacta certificada (v4.9.0):
# 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. Generación de la Autoridad de Certificación y Certificados TLS
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»Inicializa el contenedor temporal generador para aprovisionar automáticamente la infraestructura de claves públicas (PKI) y las firmas digitales de los servicios:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Archivo Docker Compose de Producción
Sección titulada «3. Archivo Docker Compose de Producción»Este archivo contiene la declaración final de servicios, límites de memoria de kernel optimizados y las credenciales estáticas iniciales del entorno.
Ruta del archivo: /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 Enrutamiento de Puertos (Red de Seguridad)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»Para permitir que los analistas del Blue Team configuren correctamente las reglas de filtrado perimetral (tales como firewalls pfSense o políticas del host), se detalla la función técnica de los 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 comunicación crítico. Los agentes recopiladores remotos envían por aquí sus logs descifrados y metadatos en tiempo real.1515(TCP) - Authd: Puerto del servicio de registro de agentes. Se utiliza exclusivamente al emparejar un nuevo nodo para generar y transmitir la clave de cifrado simétrico simétrica.514(UDP) - Syslog: Servicio opcional para la recolección de logs de red de dispositivos que no soportan agentes nativos (como routers, firewalls pfSense y switches).55000(TCP) - API REST: Interfaz de control del Manager. Es consumida por el Dashboard para procesar consultas de administración interna.
B. Contenedor: wazuh.indexer (Almacenamiento)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»9200(TCP) - OpenSearch API: Puerto de lectura/escritura de la base de datos de indexación. Filebeat introduce las alertas aquí y el Dashboard las recupera para mostrarlas en los gráficos.
C. Contenedor: wazuh.dashboard (Consola Web)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»443 ➔ 5601(TCP) - Portal HTTPS: El servicio interno utiliza el puerto5601, pero se mapea en Docker al puerto estándar 443 (HTTPS) en el anfitrión para permitir accesos limpios y directos desde el navegador sin especificar puertos atípicos.
5. Inicialización de Contenedores
Sección titulada «5. Inicialización de Contenedores»Una vez estructurado el archivo docker-compose.yml, levanta la infraestructura en segundo plano:
sudo docker compose up -dAdvertencia de Seguridad
Aunque los contenedores inicialicen correctamente en el motor de Docker, la suite no será funcional ni segura hasta que se generen e inyecten los hashes encriptados detallados en el siguiente documento.

