Tutoriales de VPS
Wazuh SIEM en VPS (2026): Docker, agentes, HTTPS y recuperación
Despliegue Wazuh de un nodo en Ubuntu con Docker y Caddy. Restrinja API, cambie credenciales, conecte agentes Linux compatibles, pruebe FIM y prepare copias y actualización segura.

Al administrar varios servidores web, bases de datos, bastiones y equipos de empleados, CPU y disponibilidad dejan preguntas esenciales sin responder. ¿Quién intenta acceder repetidamente por SSH? ¿Se han modificado archivos del sistema? ¿Qué equipo utiliza un paquete vulnerable? ¿Puede relacionarse una alerta grave con una máquina y hora concretas?
Wazuh es una plataforma SIEM/XDR de código abierto para eventos de seguridad, integridad de archivos, detección de vulnerabilidades, evaluación de configuración, análisis de registros y respuesta activa. Este tutorial completo utiliza Wazuh 4.14.7, Ubuntu 24.04, Docker Compose de un nodo y Caddy: despliegue central, puertos restringidos, HTTPS, agentes Linux, pruebas de alertas, copias y actualización. El contexto de versiones procede de la revisión original de septiembre de 2026. La descripción de Wazuh 5.0 como preliminar corresponde a esa fecha; compruebe publicaciones y avisos de seguridad actuales antes de elegir una versión de producción.
Las herramientas responden a preguntas diferentes y pueden complementarse:
| Herramienta | Pregunta principal | Datos habituales | Uso adecuado |
|---|---|---|---|
| Wazuh | ¿El equipo está atacado, alterado o en riesgo? | Registros de seguridad, cambios, vulnerabilidades, configuración | SIEM, XDR, cumplimiento y seguridad de endpoints |
| Zabbix | ¿Servidores y servicios funcionan bien? | CPU, RAM, disco, puertos, SNMP | Disponibilidad y capacidad de infraestructura |
| Sentry | ¿Por qué falla la aplicación y qué publicación lo causó? | Excepciones, trazas, pila, releases | Errores y rendimiento de aplicaciones |
Para capacidad y estado de dispositivos, consulte Zabbix; para excepciones de código, Sentry propio. Una combinación puede utilizar Zabbix para salud del sistema, Sentry para fallos de aplicación y Wazuh para eventos de seguridad.
El mínimo oficial Docker de un nodo es 4 núcleos CPU, 8 GB RAM y 50 GB de disco. Es un límite para pequeñas instalaciones, no una garantía de capacidad. Influyen volumen de registros, agentes, retención de índices y reglas.
| Alcance | Recursos iniciales sugeridos | Observaciones |
|---|---|---|
| Prueba, 1–5 agentes | 4 vCPU, 8 GB RAM, 80 GB NVMe | Limitar registros y comprobar todo el flujo |
| Producción pequeña, 5–30 agentes | 8 vCPU, 16 GB RAM, 200 GB NVMe | Margen para crecimiento y actualizaciones |
| Más agentes o muchos registros | Medir primero; considerar varios nodos | El número de agentes no basta |
La arquitectura original lleva HTTPS del navegador a Caddy y al Dashboard local. Los componentes usan la red interna, y los agentes llegan a puertos de eventos y registro del Manager:
浏览器 -> Caddy :443 -> Wazuh Dashboard :5601(仅本机)
|
+-> Wazuh Indexer(内部网络)
+-> Wazuh Manager(内部网络)
Linux Agent -> Wazuh Manager :1514(事件)
Linux Agent -> Wazuh Manager :1515(注册)
Mantenga API Manager 55000/TCP, API Indexer 9200/TCP y acceso directo al Dashboard fuera de Internet. Abra 514/UDP solo para Syslog deliberadamente configurado. Priorice WireGuard, Tailscale o red privada. Si necesita acceso público de agentes, limite 1514/1515 a sus IP de salida en el proveedor y compruebe también el filtrado de tráfico reenviado por Docker.
Apunte un dominio como wazuh.example.com a la VPS. No añada AAAA sin IPv6 funcional. Instale los requisitos Ubuntu:
sudo apt update
sudo apt full-upgrade -y
sudo apt install -y git curl ca-certificates caddy
docker --version
docker compose version
Docker Engine y Compose deben estar instalados previamente. Si faltan, use el repositorio oficial de Ubuntu de Docker. La cuenta de despliegue debe poder ejecutar Docker: utilice sudo de forma coherente o conceda deliberadamente acceso, equivalente a privilegios root. Instale python3 para revisar la configuración estructurada y netcat-openbsd en agentes para pruebas de conexión. Consulte la lista de Compose en producción para rotación, salud, límites y reversión.
Indexer usa OpenSearch y necesita un límite persistente de mapas de memoria:
sudo sysctl -w vm.max_map_count=262144
printf 'vm.max_map_count=262144\n' | sudo tee /etc/sysctl.d/99-wazuh.conf
sudo sysctl --system
sysctl vm.max_map_count
El resultado debe ser vm.max_map_count = 262144. Un límite bajo suele impedir iniciar Indexer o provoca cierres repetidos.
Use una etiqueta publicada, no la rama cambiante:
sudo git clone https://github.com/wazuh/wazuh-docker.git \
-b v4.14.7 /opt/wazuh-docker
sudo chown -R "$USER":"$USER" /opt/wazuh-docker
cd /opt/wazuh-docker/single-node
git describe --tags --exact-match
Espere v4.14.7. El Compose inicia Manager, Indexer y Dashboard, con configuración, registros, colas e índices en volúmenes nombrados. Revise correcciones de seguridad antes de usar esta versión histórica en una instalación nueva.
Genere los certificados internos:
cd /opt/wazuh-docker/single-node
docker compose -f generate-indexer-certs.yml run --rm generator
find config/wazuh_indexer_ssl_certs -maxdepth 1 -type f -print
Compruebe que existen certificados y claves requeridas. No publique claves privadas; dé a cada componente acceso suficiente sin permisos generales.
La configuración oficial publica Dashboard, Indexer, API Manager y Syslog. Copie el archivo para producción y aplique las transformaciones originales:
cd /opt/wazuh-docker/single-node
cp docker-compose.yml docker-compose.production.yml
sed -i 's/"9200:9200"/"127.0.0.1:9200:9200"/' docker-compose.production.yml
sed -i 's/55000:55000/127.0.0.1:55000:55000/' docker-compose.production.yml
sed -i 's/514:514\/udp/127.0.0.1:514:514\/udp/' docker-compose.production.yml
sed -i 's/- 443:5601/- "127.0.0.1:5601:5601"/' docker-compose.production.yml
docker compose -f docker-compose.production.yml config > /tmp/wazuh-compose-rendered.yml
grep -nE '127\.0\.0\.1|1514|1515|514|55000|9200|5601' \
/tmp/wazuh-compose-rendered.yml
No guarde credenciales expandidas en un temporal compartido. Use un archivo privado o inspección JSON solo de puertos. Que sed termine correctamente no demuestra enlaces seguros. Compruebe:
- Dashboard
5601, Indexer9200, API Manager55000y Syslog opcional514/UDPsolo usan127.0.0.1. 1514/TCPy1515/TCPson accesibles a agentes por la red restringida elegida.- No queda publicación
0.0.0.0:443que entre en conflicto con Caddy.
Si no usa Syslog, elimine el enlace 514/UDP. docker-compose.production.yml es configuración local que deberá comparar con cada versión de destino.
Los puertos publicados por Docker pueden saltarse las reglas normales INPUT de UFW. Una lista de fuentes en UFW no prueba la restricción. Preferiblemente reemplace la lista de puertos Manager por enlaces explícitos a la IP VPN/privada real:
ports:
- "10.66.0.1:1514:1514"
- "10.66.0.1:1515:1515"
- "127.0.0.1:55000:55000"
10.66.0.1 es un ejemplo y debe estar asignada realmente al host. Edite la lista existente; no mezcle un override que conserve enlaces públicos. La interfaz debe existir antes del inicio. Para agentes por Internet, aplique grupo de seguridad del proveedor y política apropiada de reenvío Docker; pruebe desde una IP no autorizada además del agente permitido.
Inspeccione los puertos sin mostrar secretos:
docker compose -f docker-compose.production.yml config --format json | python3 -c '
import json, sys
data = json.load(sys.stdin)
for name in ("wazuh.manager", "wazuh.indexer", "wazuh.dashboard"):
for port in data["services"][name].get("ports", []):
print(name, port.get("host_ip", "all interfaces"), port.get("published"), port.get("target"), port.get("protocol", "tcp"))
'
Restrinja el Dashboard al administrador previsto mientras existan credenciales predeterminadas. Descargue e inicie:
cd /opt/wazuh-docker/single-node
docker compose -f docker-compose.production.yml pull
docker compose -f docker-compose.production.yml up -d
docker compose -f docker-compose.production.yml ps
Las tres imágenes deben usar 4.14.7. Al principio Dashboard puede no conectar con Indexer durante la inicialización. Espere; no recree continuamente ni elimine volúmenes por un aviso transitorio. Revise:
docker compose -f docker-compose.production.yml logs --tail=100 wazuh.indexer
docker compose -f docker-compose.production.yml logs --tail=100 wazuh.manager
docker compose -f docker-compose.production.yml logs --tail=100 wazuh.dashboard
curl -kI https://127.0.0.1:5601/
ss -lntup | grep -E ':1514|:1515|:514|:55000|:9200|:5601'
curl -k es diagnóstico local para el certificado autofirmado, no autorización para ignorar TLS del navegador. 5601/9200/55000/514 debe usar loopback donde esté publicado. Pruebe desde otro host: las listas de sockets no verifican reglas del proveedor o reenvío.
Dashboard usa HTTPS autofirmado interno en 5601. Caddy conecta localmente y presenta certificado válido al navegador. Edite /etc/caddy/Caddyfile:
wazuh.example.com {
encode zstd gzip
reverse_proxy https://127.0.0.1:5601 {
transport http {
tls_insecure_skip_verify
}
}
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
Referrer-Policy "strict-origin-when-cross-origin"
}
}
tls_insecure_skip_verify afecta únicamente a la conexión local de Caddy al upstream. El navegador sigue validando HTTPS público. Para mayor rigor, configure confianza en la CA interna y un nombre de servidor que coincida con el certificado. Active HSTS includeSubDomains solo tras revisar sus efectos sobre todos los subdominios.
Valide y recargue después de cambiar las credenciales y restringir el acceso inicial:
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://wazuh.example.com/
Ante fallos de certificados, revise DNS, reglas del proveedor para 80/443, UFW, AAAA y ocupación de puertos. Consulte la recuperación de UFW y mantenga una sesión SSH abierta.
El acceso inicial es admin / SecretPassword. Solo debe utilizarse durante preparación controlada; cambie valores antes de permitir Internet general.
Indexer admin, servicio Dashboard kibanaserver y API Manager wazuh-wui tienen referencias distintas. Cierre sesión, copie de forma privada single-node/config/ y detenga el stack antes de modificar Indexer. Genere hashes compatibles, actualice config/wazuh_indexer/internal_users.yml y todas las referencias Compose. Para wazuh-wui, cambie config/wazuh_dashboard/wazuh.yml y variables Manager/Dashboard. Escriba $ literal como $$ en YAML Compose.
Genere cada hash interactivamente con la imagen fijada:
docker run --rm -it wazuh/wazuh-indexer:4.14.7 \
bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/hash.sh
No introduzca contraseñas en historial, capturas o Git. Conserve usuarios personalizados en internal_users.yml: aplicar una configuración incompleta puede eliminarlos. Siga la guía oficial de contraseñas con un usuario Indexer cada vez y referencias sincronizadas.
Editar el hash no actualiza por sí solo el índice de seguridad activo. Inicie el stack privado, espere a que Indexer esté listo y aplique la configuración revisada con el certificado administrativo:
docker compose -f docker-compose.production.yml up -d
docker compose -f docker-compose.production.yml exec -T wazuh.indexer bash -e <<'SECURITY'
export JAVA_HOME=/usr/share/wazuh-indexer/jdk
config_dir=/usr/share/wazuh-indexer/config
bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/securityadmin.sh \
-cd "$config_dir/opensearch-security/" -nhnv \
-cacert "$config_dir/certs/root-ca.pem" \
-cert "$config_dir/certs/admin.pem" \
-key "$config_dir/certs/admin-key.pem" -p 9200 -icl
SECURITY
La orden aplica todo el directorio de seguridad; revise roles y usuarios personalizados antes. La contraseña API debe tener 8–64 caracteres y mayúscula, minúscula, número y símbolo; si incumple, Manager puede no iniciar. Recree contenedores tras actualizar referencias API. Compruebe que valores antiguos fallan y las conexiones de componentes funcionan. Use cuentas administrativas individuales, permisos mínimos y VPN o IP fija para el panel.
Permita primero el SSH administrativo y después web. Sustituya 203.0.113.10, una dirección documental, por la IP real de salida o red privada:
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow from 203.0.113.10 to any port 1514 proto tcp
sudo ufw allow from 203.0.113.10 to any port 1515 proto tcp
sudo ufw enable
sudo ufw status numbered
No ejecute ufw allow 9200 ni ufw allow 55000 sin restricción. Combine UFW con filtrado Docker/proveedor. Si cambian las direcciones de agentes, priorice VPN. Limite también el registro después del aprovisionamiento y revise autenticación/certificados: conectividad no constituye una política de registro confiable. Consulte la lista de seguridad de VPS.
Instale el agente en el sistema que desea supervisar. El agente dentro de un contenedor normal no accede directamente al host; utilizar Docker no da visibilidad del anfitrión automáticamente.
El procedimiento original Ubuntu 24.04 es:
sudo apt-get update
sudo apt-get install -y gnupg apt-transport-https curl
curl -s https://packages.wazuh.com/key/GPG-KEY-WAZUH \
| sudo gpg --no-default-keyring \
--keyring gnupg-ring:/usr/share/keyrings/wazuh.gpg --import
sudo chmod 644 /usr/share/keyrings/wazuh.gpg
echo "deb [signed-by=/usr/share/keyrings/wazuh.gpg] https://packages.wazuh.com/4.x/apt/ stable main" \
| sudo tee /etc/apt/sources.list.d/wazuh.list
sudo apt-get update
sudo WAZUH_MANAGER="WAZUH_MANAGER_IP" apt-get install -y wazuh-agent
sudo systemctl daemon-reload
sudo systemctl enable --now wazuh-agent
sudo systemctl status wazuh-agent --no-pager
Reemplace WAZUH_MANAGER_IP por la dirección Manager accesible mediante VPN/red privada, no por 127.0.0.1 local del servidor. Manager debe ser igual o más reciente que el agente. La instalación sin versión anterior puede elegir un agente superior. Tras añadir el repositorio, instale explícitamente antes de arrancar:
apt-cache madison wazuh-agent
sudo WAZUH_MANAGER="WAZUH_MANAGER_IP" apt-get install -y wazuh-agent=4.14.7-1
sudo systemctl daemon-reload
sudo systemctl enable --now wazuh-agent
El repositorio oficial amd64 contiene 4.14.7-1; confirme disponibilidad y arquitectura en el destino en vez de instalar otra versión silenciosamente. Si cambia Manager, elija un paquete compatible. Bloquee actualizaciones accidentales:
echo "wazuh-agent hold" | sudo dpkg --set-selections
dpkg --get-selections | grep wazuh-agent
En Dashboard entre en Agents management → Summary. Si falta el agente, examine:
sudo tail -n 100 /var/ossec/logs/ossec.log
sudo grep -n '<address>' /var/ossec/etc/ossec.conf
nc -vz WAZUH_MANAGER_IP 1514
nc -vz WAZUH_MANAGER_IP 1515
Revise wazuh.manager y contadores de cortafuegos. Causas comunes: dirección Manager errónea, puertos bloqueados, whitelist no coincidente, salida NAT distinta o agente superior al Manager.
El estado Active demuestra conexión, no detección. En un agente de prueba cree:
sudo mkdir -p /opt/wazuh-fim-test
echo "baseline" | sudo tee /opt/wazuh-fim-test/example.txt
Añada el directorio a <syscheck> en /var/ossec/etc/ossec.conf:
<directories realtime="yes" report_changes="yes">/opt/wazuh-fim-test</directories>
Valide FIM con sudo /var/ossec/bin/wazuh-syscheckd -t, reinicie y espere a que el primer análisis establezca la línea base. Solo entonces modifique el archivo. Las órdenes originales son:
sudo /var/ossec/bin/wazuh-control restart
echo "changed $(date -Is)" | sudo tee -a /opt/wazuh-fim-test/example.txt
Busque eventos por agente y ruta. Use report_changes inicialmente solo en el directorio de prueba. En carpetas con secretos o cambios frecuentes, los diffs pueden filtrar contenido y producir demasiadas alertas.
Vulnerability Detection depende del inventario, plataforma e Indexer. Verifique paquete, versión, CVE y host de una detección. Sirve para priorizar; no sustituye avisos de la distribución, ventanas de parches ni validación humana. Un CVE detectado no demuestra que sea explotable en ese entorno.
Enviar todas las reglas genera fatiga. Separe:
- Eventos urgentes y confiables para aviso inmediato.
- Prioridad media para tickets o resumen diario.
- Prioridad baja para búsqueda sin interrumpir guardias.
Verifique primero FIM y un acceso SSH fallido controlado; después configure correo, Slack, webhook o integración. Incluya agente, ID de regla, nivel, hora, origen y enlace de búsqueda sin reenviar registros completos con posibles secretos.
La respuesta activa puede bloquear fuentes o ejecutar scripts, pero una falsa alarma podría bloquear al administrador. Observe primero en modo de alerta, configure allowlist, expiración y acceso fuera de banda; active pocas reglas confiables gradualmente. Consulte la guía de desbloqueo Fail2Ban para errores de bloqueo.
Los volúmenes sobreviven a docker compose down; eso es persistencia. Borrado, fallo de disco o pérdida del host destruyen datos locales. Incluya:
- Certificados y configuración de
/opt/wazuh-docker/single-node/config/. - Configuración Manager, claves de registro, bases de cola, reglas, decodificadores e integraciones.
- Índices y estado Indexer mediante snapshots compatibles.
- Compose de producción, Caddyfile, tag/commit y referencias de imágenes realmente usadas.
- Copia fuera del host con sumas verificadas.
El original registra información mediante:
cd /opt/wazuh-docker/single-node
date -Is | sudo tee /var/backups/wazuh-backup-time.txt
git describe --tags --exact-match | sudo tee /var/backups/wazuh-version.txt
docker compose -f docker-compose.production.yml config --images \
| sudo tee /var/backups/wazuh-images.txt
docker compose -f docker-compose.production.yml config --volumes \
| sudo tee /var/backups/wazuh-volumes.txt
Utilice una carpeta root privada con modo 700. Los nombres de docker compose config --volumes son lógicos y pueden diferir de los volúmenes reales: descubra los montajes de los contenedores existentes y compruebe cada volumen antes de archivarlo. Un nombre equivocado puede crear un volumen vacío. Copie también certificados y configuración bind-mounted sin mostrar credenciales.
Configure y pruebe un repositorio de snapshots Wazuh/OpenSearch, complete y compruebe un snapshot y guarde repositorio y configuración fuera del host. Copiar un directorio Indexer activo no es un reemplazo admitido. Detenga Manager al copiar sus bases para evitar escrituras y registros nuevos; pause escritores de configuración Dashboard también. Use una trampa de reinicio y compruebe salud al terminar. Adapte el alcance oficial de copias centrales a los montajes Docker; las rutas de instalación por paquetes no necesariamente existen en el host.
Respalde antes de modificar contraseñas, reglas, integraciones o versión. Restaure periódicamente en VPS aislada con imágenes, certificados, claves y montajes correspondientes, evitando registros duplicados o respuestas reales. Verifique tres componentes, acceso, reconexión de agentes, búsquedas históricas y un evento FIM nuevo. Consulte la estrategia de recuperación VPS.
Fijar 4.14.7 no impide actualizar. Lea notas y procedimiento Docker; cambiar etiquetas a latest no basta.
- Compruebe copia externa y una muestra de restauración.
- Guarde diferencias de
docker-compose.production.ymly modificaciones locales de archivos versionados. - Detenga mediante
docker compose -f docker-compose.production.yml downconservando volúmenes. - Ejecute
git fetch --all --tagsy seleccione una etiqueta explícita revisada. - Reaplique puertos y referencias de contraseñas sobre la nueva configuración.
- Revise
docker compose configcon-f docker-compose.production.ymlpara inspeccionar el archivo real, protegiendo secretos expandidos. - Inicie y verifique Dashboard, Indexer, Manager, agentes y alertas.
La persistencia no sustituye respaldo. Cambios de índices/esquema pueden impedir usar una imagen antigua; la reversión requiere snapshot y copias previas, no solo tags. Actualice Manager antes de agentes, libere sus bloqueos y despliegue por lotes observados.
Compruebe sysctl vm.max_map_count igual a 262144, memoria y registros:
free -h
df -h
docker compose -f docker-compose.production.yml logs --tail=200 wazuh.indexer
No desactive comprobaciones para ocultar falta de memoria. Quite servicios compartidos, amplíe RAM o revise retención.
Verifique Dashboard y HTTPS local:
curl -kI https://127.0.0.1:5601/
sudo journalctl -u caddy -n 100 --no-pager
sudo caddy validate --config /etc/caddy/Caddyfile
Si curl local falla, revise Wazuh y enlaces; si funciona, Caddy, DNS y cortafuegos.
Revise dirección, acceso 1514/1515, proveedor, reenvío Docker, fuentes UFW, relojes y registros. No abra todo a 0.0.0.0/0.
Compruebe agente Active, recepción Manager, salud Indexer y rango de tiempo. Permita inicialización tras reiniciar.
Identifique el volumen real y revise registros, ruido y retención. No borre datos Indexer activos. Haga snapshot y pruebe recuperación antes de limpieza admitida.
- Etiquetas revisadas y fijadas, sin
latest. - Mínimo 4 núcleos/8 GB/50 GB y margen de crecimiento.
-
vm.max_map_count=262144persistente. - Dashboard y API Indexer/Manager privados o estrictamente restringidos.
-
1514/1515limitado a redes permitidas, comprobado más allá de UFW. -
admin / SecretPasswordya no autentica. - Administradores individuales con permisos mínimos.
- Agentes, FIM y notificaciones probados.
- Copia externa restaurada en aislamiento.
- Notas, diferencias y reversión por recuperación revisadas antes de actualizar.
No es recomendable. El mínimo Docker es 4 núcleos, 8 GB RAM y 50 GB disco. Un inicio parcial con 2 GB puede fallar durante inicialización o consultas Indexer.
No por completo. Wazuh prioriza seguridad, vulnerabilidades y endpoints; Zabbix métricas, capacidad, disponibilidad y dispositivos de red. Pueden coexistir.
El agente conecta al Manager 1514/1515. Normalmente no requiere entradas públicas Wazuh; Manager sí debe aceptar su red.
Manténgalos en red de contenedores, loopback, VPN o segmento administrativo estricto. Un número poco habitual no protege una API valiosa.
Dashboard utiliza un certificado interno autofirmado. El ejemplo omite solo validación local; HTTPS del navegador sigue validado. Confiar en la CA interna y verificar nombre es más sólido.
down conserva volúmenes nombrados; down -v los elimina. Incluso conservados, hacen falta copias externas de configuración, Manager, Indexer e instrucciones.
Un contenedor normal no accede al host como un agente nativo. Instale el agente en el sistema operativo de la VPS.
El valor de Wazuh está en conectar recogida, detección, aviso, respuesta y recuperación. Fije versiones y restrinja puertos; cambie credenciales, conecte pocos agentes compatibles y pruebe FIM/notificaciones antes de ampliar.
Un nodo Docker puede cubrir necesidades iniciales tras validar la carga. Más agentes, registros y retención requieren medir índices y considerar varios nodos. Interfaces privadas, recuperación probada y alertas manejables siguen siendo esenciales.