Ir al contenido

Wazuh 故障排除与监控

Docker Compose 配置错误解决、不安全密码异常 5007、inode 腐蚀和蓝队审计命令。

0阅读

本技术指南汇总了在 Wazuh 4.9 安全平台通过 Docker 进行架构、部署和集成阶段检测到的关键事件,以及针对 蓝队 分析师的相应诊断流程和操作审计指令。


  • 错误症状: 容器拒绝初始复杂密码,并在初始化日志中抛出加密异常。
  • 系统诊断:Docker Compose 引擎会原生在 YAML 配置文件中将特殊字符 $ 解释为主机本地变量插值或调用指令。由于管理员密钥包含特殊字符,导致注入的密码被截断。
  • 应用解决方案: 用高熵复杂字母数字密码全面替换密钥字典,避免冲突的转义符号。

事件2:管理器容器中的无限重启循环(错误5007)

Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»
  • 错误症状:容器查询显示 Manager wazuh.manager 处于持续重启循环中。日志审计抛出以下异常: wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided。
  • 系统诊断: 从 4.9 版本开始,Wazuh 固件对 REST API 强制实施 密码强化 指令。它强制要求同时包含大写字母、小写字母、数字和至少一个 特殊标点符号。
  • 应用的解决方案:修改 API 密钥(mP5nT8qB2vK9wR3xY6cS4dB9.),在其末尾添加一个点号 .,以满足原生正则表达式验证器的要求。
  • 错误症状: OpenSearch 引擎拒绝同步命令,声称身份不存在于凭据表中。文件在容器内似乎完全为空。
  • 系统诊断: 在尝试将主机文件挂载并实时修改到 Docker 卷时,文件系统级别发生 inode 冲突。OpenSearch 清空元数据以重新写入,导致物理引用丢失。
  • 应用的解决方案:设计一个稳健的异步流程:
    1. 在容器内独立生成 bcrypt 哈希值。
    2. 直接从主机物理修改原始文件。
    3. 使用脚本 securityadmin.sh 的 SSL 签名强制读取。

事件4:‘Wazuh dashboard server is not ready yet’ 永久加载挂起

Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»
  • 错误症状: 清除系统卷后,网络前端始终无法访问。
  • 系统诊断:down -v 指令会销毁挂载在主机上的本地数据库。启动集群时,OpenSearch 将使用出厂默认哈希初始化,从而破坏与使用复杂密钥的 Dashboard 之间的通信。
  • 应用解决方案: 在每次集群卷清除后,必须重新执行模块2的步骤1(加密哈希同步)。

事件5:重复密钥(重复映射键)导致的仪表板崩溃循环

Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»
  • 错误症状:Web 容器 wazuh.dashboard 停止运行,并在错误堆栈中抛出: FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:。
  • 系统诊断:如果 Web 界面在首次初始化时未找到 wazuh.yml 文件,会自动注入 Manager 结构。若管理员同时手动编辑该文件,就会注入两个 hosts: 头键,导致 YAML 描述语言语法无效。
  • 应用的解决方案:手动干预:停止容器,使用单一干净的 hosts: 键重建配置文件,然后重新启动服务。

用于在入侵模拟或日常管理任务中验证SIEM系统健康状态和性能的推荐命令:

Ventana de terminal
# Comprobar estado de encendido de todos los servicios
sudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedor
sudo docker stats

验证分布式数据库是否存在索引问题或分片掉线(应返回密钥 "status" : "green"):

Ventana de terminal
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"

检查 Wazuh 分析核心的内部状态,确认所有分析队列和日志引擎报告为活跃状态(running):

Ventana de terminal
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control status

用于审计通信错误或跟踪实时网络安全事件的关键命令:

Ventana de terminal
# Monitorizar trazas de conexión del Portal Web
sudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Manager
sudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentes
sudo docker compose exec wazuh.manager tail -f /var/ossec/logs/ossec.log
# Visualización analítica de Alertas en Caliente (Ideal para Incident Response)
sudo docker compose exec wazuh.manager tail -f /var/ossec/logs/alerts/alerts.json