Wazuh-Architektur und Deployment mit Docker Compose
Leitfaden für das modulare Deployment von Wazuh 4.9 in Docker-Containern, Zuweisung komplexer alphanumerischer Anmeldedaten und Sicherheits-Port-Routing-Map.
Dieser Leitfaden beschreibt das standardmäßige technische Verfahren für die Bereitstellung von Wazuh 4.9 in einer Docker-Umgebung mit einem einzigen Knoten (single-node). Dieser Modul behandelt die Ressourcenplanung, die Vorbereitung der Host-Umgebung, die Strukturierung der Datei docker-compose.yml und die Architektur der Sicherheitsnetzwerk-Routing.
1. Planung von Anmeldeinformationen und Härtung
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Um Parsing-Fehler während der Container-Initialisierung durch die Docker-Engine zu vermeiden (wie z. B. die fehlerhafte Interpretation von Sonderzeichen wie $ oder * in YAML-Dateien) und um die Sicherheitsrichtlinien von Wazuh strikt einzuhalten, wurde eine Matrix aus hoch-entropischen alphanumerischen Anmeldedaten für die Hauptdienste definiert:
| Komponente / Dienst | Identität / Benutzer | Fiktives Beispielpasswort | Integrationshinweise |
|---|---|---|---|
| Wazuh-Schnittstelle (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Hauptzugangskonto für die Webverwaltung. |
| Wazuh-interne API | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Es ist zwingend erforderlich, mit einem Punkt . zu enden, um der Symbolrichtlinie zu entsprechen. |
| Kommunikationsdienst | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Konto, das für die interne Kommunikation zwischen Knoten verwendet wird. |
2. Bereitstellung der Umgebung auf dem Host (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»Das vollständige Deployment wird unter dem Host-Verzeichnis konsolidiert: /opt/wazuh-stack/single-node.
A. Klonen des offiziellen Repository-Zweigs
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh benötigt SSL/TLS-Zertifikate, um die Kommunikation zwischen seinen drei Hauptcontainern (Indexer, Manager und Dashboard) Ende-zu-Ende zu verschlüsseln. Greifen Sie auf Ihre Host-Konsole zu und klonen Sie die exakte zertifizierte Version (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. Generierung der Zertifizierungsstelle und TLS-Zertifikate
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»Initialisieren Sie den temporären Generator-Container, um die Public-Key-Infrastruktur (PKI) und die digitalen Signaturen der Dienste automatisch bereitzustellen:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Produktions-Docker-Compose-Datei
Sección titulada «3. Archivo Docker Compose de Producción»Diese Datei enthält die endgültige Deklaration der Dienste, optimierte Kernel-Speichergrenzen und die anfänglichen statischen Anmeldeinformationen der Umgebung.
Dateipfad: /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. Port-Routing-Map (Sicherheitsnetzwerk)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»Um den Analysten des Blue Teams eine korrekte Konfiguration der Perimeter-Filterregeln (wie pfSense-Firewalls oder Host-Richtlinien) zu ermöglichen, wird die technische Funktion der gemappten Ports wie folgt erläutert:
A. Container: wazuh.manager (Analyse-Zentrale)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»1514(TCP/UDP) - Agents: Kritischer Kommunikationsport. Remote-Collector-Agents senden hier ihre entschlüsselten Logs und Metadaten in Echtzeit.1515(TCP) - Authd: Port des Agent-Registrierungsdienstes. Er wird ausschließlich beim Pairing eines neuen Knotens verwendet, um den symmetrischen Verschlüsselungsschlüssel zu generieren und zu übertragen.514(UDP) - Syslog: Optionaler Dienst zur Sammlung von Netzwerk-Logs von Geräten, die keine nativen Agenten unterstützen (wie Router, pfSense-Firewalls und Switches).55000(TCP) - REST-API: Steuerungsschnittstelle des Managers. Sie wird vom Dashboard verwendet, um interne Verwaltungsanfragen zu verarbeiten.
B. Container: wazuh.indexer (Speicherung)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»9200(TCP) - OpenSearch API: Lese-/Schreibport der Indexierungsdatenbank. Filebeat speist die Alarme hier ein, und das Dashboard ruft sie ab, um sie in den Diagrammen anzuzeigen.
C. Container: wazuh.dashboard (Webkonsole)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»443 ➔ 5601(TCP) - HTTPS-Portal: Der interne Dienst nutzt den Port5601, wird jedoch in Docker auf den Standardport 443 (HTTPS) auf dem Host gemappt, um einen sauberen und direkten Zugriff über den Browser ohne die Angabe ungewöhnlicher Ports zu ermöglichen.
5. Container-Initialisierung
Sección titulada «5. Inicialización de Contenedores»Sobald die Datei docker-compose.yml strukturiert ist, wird die Infrastruktur im Hintergrund hochgefahren:
sudo docker compose up -dSicherheitswarnung
Auch wenn die Container in der Docker-Engine korrekt initialisiert werden, wird die Suite weder funktionsfähig noch sicher sein, bis die im folgenden Dokument detaillierten verschlüsselten Hashes generiert und injiziert wurden.

