Tutoriais de VPS
Wazuh SIEM na VPS (2026): Docker, agentes, HTTPS e recuperação
Instale Wazuh de nó único no Ubuntu com Docker e Caddy. Restrinja APIs, troque credenciais, conecte agentes Linux compatíveis, teste FIM e prepare backup e atualização segura.

Quando você administra vários sites, bancos, bastions e computadores de funcionários, métricas de CPU e disponibilidade deixam perguntas importantes sem resposta. Quem tenta entrar repetidamente por SSH? Arquivos do sistema foram alterados? Qual máquina usa um pacote vulnerável? É possível relacionar um alerta grave a um host e horário?
O Wazuh é uma plataforma SIEM/XDR de código aberto para eventos de segurança, integridade de arquivos, vulnerabilidades, avaliação de configuração, análise de logs e resposta ativa. Este tutorial completo usa Wazuh 4.14.7, Ubuntu 24.04, Docker Compose de nó único e Caddy: implantação central, portas restritas, HTTPS, agentes Linux, testes de alertas, backups e atualização. O contexto de versões vem da revisão original de setembro de 2026. A descrição do Wazuh 5.0 como pré-lançamento se refere àquela data; confira versões e avisos de segurança atuais antes de escolher uma versão de produção.
As ferramentas respondem a perguntas diferentes e podem se complementar:
| Ferramenta | Pergunta principal | Dados típicos | Melhor uso |
|---|---|---|---|
| Wazuh | O host foi atacado, alterado ou está em risco? | Logs de segurança, alterações, vulnerabilidades, configuração | SIEM, XDR, conformidade e endpoints |
| Zabbix | Servidores e serviços estão saudáveis? | CPU, RAM, disco, portas, SNMP | Disponibilidade e capacidade da infraestrutura |
| Sentry | Por que a aplicação falhou e qual versão causou o problema? | Exceções, pilhas, traces, releases | Erros e desempenho de aplicações |
Para capacidade e dispositivos, veja o guia de Zabbix; para exceções de código, o Sentry próprio. Uma combinação pode usar Zabbix para saúde do sistema, Sentry para erros da aplicação e Wazuh para segurança.
O mínimo oficial para Docker de nó único é 4 núcleos CPU, 8 GB RAM e 50 GB de disco. É um piso para instalações pequenas, não garantia de capacidade. Volume de logs, agentes, retenção e regras alteram o consumo.
| Escopo | Recursos iniciais sugeridos | Observações |
|---|---|---|
| Teste, 1–5 agentes | 4 vCPU, 8 GB RAM, 80 GB NVMe | Limite logs e valide todo o fluxo |
| Produção pequena, 5–30 agentes | 8 vCPU, 16 GB RAM, 200 GB NVMe | Folga para índices e atualizações |
| Mais agentes ou alto volume | Meça antes; considere vários nós | Quantidade de agentes sozinha não basta |
A arquitetura original encaminha HTTPS do navegador ao Caddy e ao Dashboard local. Componentes usam a rede interna; agentes chegam às portas de eventos e registro do Manager:
浏览器 -> Caddy :443 -> Wazuh Dashboard :5601(仅本机)
|
+-> Wazuh Indexer(内部网络)
+-> Wazuh Manager(内部网络)
Linux Agent -> Wazuh Manager :1514(事件)
Linux Agent -> Wazuh Manager :1515(注册)
Mantenha API Manager 55000/TCP, API Indexer 9200/TCP e Dashboard direto fora da Internet pública. Abra 514/UDP apenas para um receptor Syslog deliberado. Prefira WireGuard, Tailscale ou rede privada. Se agentes usarem a Internet, restrinja 1514/1515 aos IPs de saída no provedor e verifique também o tráfego encaminhado pelo Docker.
Aponte um domínio como wazuh.example.com à VPS. Não adicione AAAA sem IPv6 funcional. Instale os pré-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 e Compose devem estar instalados. Se faltarem, use o repositório oficial Docker para Ubuntu. A conta deve conseguir executar Docker: use sudo de forma consistente ou conceda acesso deliberadamente, equivalente a root. Instale python3 para a inspeção estruturada e netcat-openbsd nos agentes para testar conexão. Consulte a lista de Compose em produção para logs, saúde, limites e rollback.
O Indexer usa OpenSearch e precisa do limite persistente de mapeamento de memória:
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
O resultado deve ser vm.max_map_count = 262144. Um limite baixo pode impedir a inicialização ou fazer Indexer encerrar repetidamente.
Use a tag oficial publicada em vez da branch que muda:
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. O Compose inicia Manager, Indexer e Dashboard, persistindo configuração, logs, filas e índices em volumes nomeados. Confira correções de segurança antes de usar essa versão histórica em produção nova.
Gere certificados TLS 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
Confira certificados e chaves obrigatórios. Não publique chaves privadas; dê a cada componente acesso necessário sem abrir permissões gerais.
A configuração oficial publica Dashboard, Indexer, API Manager e Syslog. Faça uma cópia para produção e aplique as transformações originais:
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
Não grave credenciais expandidas em temporário compartilhado. Use arquivo privado ou JSON só de portas. sed terminar sem erro não prova os vínculos corretos. Confira:
- Dashboard
5601, Indexer9200, API Manager55000e Syslog opcional514/UDPapenas em127.0.0.1. 1514/TCPe1515/TCPacessíveis aos agentes pela rede restrita escolhida.- Nenhuma publicação
0.0.0.0:443restante em conflito com Caddy.
Se não usar Syslog, remova 514/UDP. docker-compose.production.yml é configuração local a comparar com cada versão de destino.
Portas publicadas pelo Docker podem contornar regras comuns INPUT do UFW. Uma regra de origem no UFW não comprova restrição. Prefira substituir a lista de portas Manager por vínculos explícitos no IP VPN/privado real:
ports:
- "10.66.0.1:1514:1514"
- "10.66.0.1:1515:1515"
- "127.0.0.1:55000:55000"
10.66.0.1 é exemplo de endereço já atribuído ao host. Edite a lista existente, sem mesclar override que mantenha vínculos públicos. A interface deve existir antes de subir. Para portas públicas de agentes, use grupo de segurança do provedor e política apropriada de encaminhamento Docker; teste de uma origem não autorizada e do agente permitido.
Inspecione portas efetivas sem imprimir segredos:
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 o Dashboard ao administrador previsto enquanto houver credenciais padrão. Baixe 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
As três imagens Wazuh devem usar 4.14.7. O Dashboard pode inicialmente informar falta de conexão com Indexer durante a inicialização. Aguarde; não recrie sem parar nem apague volumes por um aviso transitório. Confira:
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 é diagnóstico local do certificado autofirmado, não permissão para ignorar TLS no navegador. 5601/9200/55000/514 deve usar loopback onde publicado. Teste acesso de outro host; sockets locais não verificam regras do provedor ou encaminhamento.
Dashboard usa HTTPS interno autofirmado em 5601. Caddy conecta localmente e apresenta certificado confiável ao navegador. Configure /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 afeta apenas o upstream local. Clientes externos continuam validando HTTPS público. Para verificação mais forte, configure confiança na CA interna e nome de servidor correspondente ao certificado. Use HSTS includeSubDomains só depois de avaliar todos os subdomínios afetados.
Valide e recarregue após trocar credenciais e restringir o acesso inicial:
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://wazuh.example.com/
Em falhas de certificado, confira DNS, regras do provedor para 80/443, UFW, AAAA e portas ocupadas. Consulte a recuperação de UFW e mantenha uma sessão SSH autenticada.
O acesso inicial é admin / SecretPassword. Use apenas na configuração controlada; troque padrões antes de permitir acesso geral pela Internet.
Indexer admin, serviço Dashboard kibanaserver e API Manager wazuh-wui têm referências diferentes. Saia do Dashboard, faça backup protegido de single-node/config/ e pare o stack antes de alterar Indexer. Gere hashes compatíveis, atualize config/wazuh_indexer/internal_users.yml e referências Compose. Para wazuh-wui, mude config/wazuh_dashboard/wazuh.yml e ambiente Manager/Dashboard. Um $ literal em Compose YAML deve virar $$.
Gere cada hash interativamente com a imagem fixada:
docker run --rm -it wazuh/wazuh-indexer:4.14.7 \
bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/hash.sh
Não coloque senhas em histórico, captura ou Git. Preserve usuários próprios em internal_users.yml; uma configuração incompleta pode apagá-los. Siga o procedimento oficial de senhas para um usuário Indexer por vez, com referências sincronizadas.
Editar o hash sozinho não atualiza o índice de segurança ativo. Inicie o stack privado, espere Indexer ficar pronto e aplique a configuração revisada com 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
O comando aplica todo o diretório de segurança; revise funções e usuários personalizados antes. A senha API precisa de 8–64 caracteres, maiúscula, minúscula, número e símbolo; se inválida, Manager pode não iniciar. Recrie contêineres após alterar referências API. Confirme falha dos padrões antigos e funcionamento das conexões internas. Use administradores individuais, permissões mínimas e VPN ou IP fixo para o painel.
Permita SSH administrativo primeiro e depois web. Troque 203.0.113.10, endereço documental, pelo IP real de saída ou faixa 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
Não use ufw allow 9200 ou ufw allow 55000 irrestritos. Combine UFW com Docker/provedor. Para IPs variáveis, prefira VPN. Restrinja registro após provisionamento e revise autenticação/certificados; conectividade não é uma política confiável de cadastro. Veja a lista de segurança VPS.
Instale o agente no sistema monitorado. A documentação explica que um contêiner comum não acessa diretamente o host; usar Docker não fornece visibilidade automaticamente.
O procedimento original Ubuntu 24.04 é:
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
Troque WAZUH_MANAGER_IP pelo Manager acessível via rede privada/VPN, não por 127.0.0.1 local do servidor. Manager deve ser igual ou mais novo que os agentes. A instalação sem versão pode trazer um agente superior. Após configurar o repositório, instale explicitamente antes de iniciar:
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
O repositório oficial amd64 contém 4.14.7-1; confira arquitetura e disponibilidade no destino, sem instalar outra versão silenciosamente. Se mudar Manager, escolha o agente compatível. Bloqueie atualizações acidentais:
echo "wazuh-agent hold" | sudo dpkg --set-selections
dpkg --get-selections | grep wazuh-agent
No Dashboard, vá a Agents management → Summary. Se o agente não aparecer, 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
Confira logs wazuh.manager e contadores de firewall. Causas comuns: endereço errado, portas bloqueadas, whitelist diferente, saída NAT alterada ou agente superior ao Manager.
Active comprova conexão, não detecção. Em um agente de teste, crie:
sudo mkdir -p /opt/wazuh-fim-test
echo "baseline" | sudo tee /opt/wazuh-fim-test/example.txt
Adicione o diretório dentro de <syscheck> em /var/ossec/etc/ossec.conf:
<directories realtime="yes" report_changes="yes">/opt/wazuh-fim-test</directories>
Valide FIM com sudo /var/ossec/bin/wazuh-syscheckd -t, reinicie e aguarde o primeiro scan estabelecer a linha de base. Só então altere o arquivo. O original traz:
sudo /var/ossec/bin/wazuh-control restart
echo "changed $(date -Is)" | sudo tee -a /opt/wazuh-fim-test/example.txt
Busque eventos por agente e caminho. Use report_changes inicialmente só na pasta de teste. Diffs em diretórios com senhas, chaves ou alterações intensas podem expor conteúdo e gerar uma tempestade de alertas.
Vulnerability Detection depende de inventário, plataforma e Indexer. Verifique pacote, versão, CVE e host de um resultado. A ferramenta prioriza investigação; não substitui avisos da distribuição, janela de atualização ou validação humana. Detectar CVE não prova exploração viável naquele ambiente.
Enviar todas as regras gera fadiga. Separe:
- Eventos urgentes e confiáveis para aviso imediato.
- Prioridade média para chamados ou resumo diário.
- Baixa prioridade para consulta, sem interromper plantão.
Valide primeiro FIM e uma falha SSH controlada; depois configure e-mail, Slack, webhook ou integração. Inclua agente, ID da regra, nível, horário, origem e consulta Dashboard, sem enviar logs completos que possam conter segredos.
Resposta ativa pode bloquear origens ou executar scripts, mas falso positivo pode bloquear o administrador. Observe em modo de alerta, defina allowlist, expiração automática e acesso fora de banda, e ative poucas regras confiáveis gradualmente. Veja o guia de desbloqueio Fail2Ban em bloqueios acidentais.
Volumes sobrevivem a docker compose down; isso é persistência. Exclusão, falha de disco ou perda do host levam os dados locais. Inclua:
- Certificados e configuração em
/opt/wazuh-docker/single-node/config/. - Configuração Manager, chaves de registro, bancos de filas, regras, decodificadores e integrações.
- Índices e estado Indexer com snapshots suportados.
- Compose de produção, Caddyfile, tag/commit e referências das imagens efetivas.
- Cópia externa com somas verificadas.
O original registra estado com:
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
Use pasta privada root com modo 700. docker compose config --volumes mostra nomes lógicos que podem diferir dos volumes reais; descubra montagens dos contêineres existentes e confirme cada volume antes de arquivar. Um nome errado pode criar um volume vazio. Salve configuração e certificados bind-mounted também, sem imprimir credenciais.
Configure e teste repositório de snapshots Wazuh/OpenSearch; conclua e verifique o snapshot e preserve configuração e dados do repositório externamente. Copiar diretório Indexer ativo não é substituto suportado. Pare Manager ao copiar seus bancos para impedir escritas e registros simultâneos; pause também escritores da configuração Dashboard. Use trap de reinício e confira saúde ao terminar. Mapeie o escopo oficial de backup central aos volumes Docker; caminhos de instalação por pacote não necessariamente existem no host.
Faça backup antes de alterar senhas, regras, integrações ou versão. Restaure regularmente em VPS isolada com imagens, certificados, chaves e montagens correspondentes, sem registro duplicado ou resposta ativa real. Verifique os três componentes, login, reconexão de agentes, buscas históricas e novo evento FIM. Veja a estratégia de recuperação VPS.
Fixar 4.14.7 não significa nunca atualizar. Leia notas e procedimento Docker; mudar para latest e reiniciar não basta.
- Verifique backup externo e uma amostra de restauração.
- Guarde diferenças de
docker-compose.production.ymle modificações locais de arquivos versionados. - Pare com
docker compose -f docker-compose.production.yml down, preservando volumes. - Execute
git fetch --all --tagse escolha tag explícita revisada. - Reaplique portas restritas e referências de senhas no arquivo novo.
- Confira
docker compose configcom-f docker-compose.production.ymlpara inspecionar produção real sem expor segredos. - Inicie e valide Dashboard, Indexer, Manager, agentes e alertas.
Persistência não substitui backup. Mudanças de índice/esquema podem impedir voltar à imagem antiga; o rollback depende do snapshot e das cópias anteriores, não só tags. Atualize Manager antes dos agentes, libere holds e faça lotes observados.
Confira sysctl vm.max_map_count igual a 262144, memória e logs:
free -h
df -h
docker compose -f docker-compose.production.yml logs --tail=200 wazuh.indexer
Não desative verificações para esconder falta de memória. Reduza serviços no host, amplie RAM ou reveja retenção.
Confira Dashboard e 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
Se curl local falha, examine Wazuh ou vínculos. Se funciona, examine Caddy, DNS e firewall.
Confira endereço, acesso 1514/1515, provedor, encaminhamento Docker, origens UFW, relógios e logs. Não abra tudo a 0.0.0.0/0.
Confira Active, eventos recebidos pelo Manager, saúde Indexer e intervalo de tempo. Aguarde inicialização após reiniciar.
Identifique o volume real, depois logs, ruído e retenção. Não apague diretório Indexer ativo. Faça snapshot e teste recuperação antes de limpeza suportada.
- Tags revisadas fixadas, sem
latest. - Mínimo 4 núcleos/8 GB/50 GB com margem de crescimento.
-
vm.max_map_count=262144persistente. - Dashboard e APIs Indexer/Manager privados ou rigorosamente restritos.
-
1514/1515limitado a origens previstas, testado além do UFW. -
admin / SecretPasswordnão autentica mais. - Administradores individuais e permissões mínimas.
- Agentes, FIM e notificações testados.
- Backup externo restaurado em isolamento.
- Notas, diferenças e rollback por recuperação revisados antes da atualização.
Não é recomendado. O mínimo Docker é 4 núcleos, 8 GB RAM e 50 GB disco. Um início parcial com 2 GB pode falhar na inicialização ou em consultas Indexer.
Não completamente. Wazuh prioriza segurança, vulnerabilidades e endpoints; Zabbix, métricas, capacidade, disponibilidade e dispositivos de rede. Podem coexistir.
O agente conecta ao Manager 1514/1515. Normalmente não precisa de entrada pública Wazuh; Manager precisa aceitar sua rede.
Mantenha em rede de contêineres, loopback, VPN ou segmento administrativo restrito. Número incomum não protege API de alto valor.
Dashboard usa certificado interno autofirmado. O exemplo ignora só a verificação local; HTTPS do navegador continua validado. Confiar na CA interna e verificar nome é mais forte.
down preserva volumes nomeados; down -v os apaga. Mesmo preservados, precisam de backup externo de configuração, Manager, Indexer e instruções.
Um contêiner comum não acessa o host como agente nativo. Instale no sistema operacional da VPS para monitorar o host.
O valor do Wazuh vem de coleta, detecção, notificação, resposta e recuperação conectadas. Fixe versões e restrinja portas; troque credenciais, conecte poucos agentes compatíveis e teste FIM/notificações antes de ampliar.
Um nó Docker pode atender o início de equipes pequenas após validar carga. Mais agentes, logs e retenção pedem medir índices e avaliar vários nós. Interfaces privadas, restauração testada e alertas administráveis seguem essenciais em qualquer escala.