Arquitectura de Wazuh i Desplegament amb Docker Compose
Guia de desplegament modular de Wazuh 4.9 en contenedors Docker, assignació de credencials alfanumèriques complexes i mapa d'enrutament de ports de seguretat.
Esta guía detalla el procedimiento técnico estándar para el despliegue de Wazuh 4.9 en un entorno Dockerizado de nodo único. 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.
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 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 | Compte utilitzada per a la comunicació interna entre nodes. |
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.
Clonar la Rama del Repositorio Oficial
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh requere certificats SSL/TLS per cifrar de punta a punta les comunicacions entre els seus tres contenidors principals (Indexer, Manager i Dashboard). Accedeix a la teva consola de l'host i clona la versió 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-nodeGeneració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 generatorArchivo Docker Compose de Producción
Sección titulada «3. Archivo Docker Compose de Producción»Aquest arxiu conté la declaració final de serveis, límits de memòria de kernel optimitzats i les credencials estàtiques inicials de l'entorn.
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: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.
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étrica.
514(UDP) - Syslog: Servei opcional per a la recollida de logs de xarxa de dispositius que no suporten agents natius (com routers, firewalls pfSense i switches).- 55000 (TCP) - API REST: Interfaz de control del Manager. Es consumida por el Dashboard para procesar consultas de administración interna.
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.
Contenedor: wazuh.dashboard (Consola Web)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»443 ➔ 5601(TCP) - Portal HTTPS: El servei intern utilitza el port5601, però es mapeja a Docker al port estàndard 443 (HTTPS) de l'host per permetre accessos nets i directes des del navegador sense especificar ports atípics.
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.

