Volver a herramientas

Validador de Configuración Web

Errores comunes de configuración por servidor

Conocer los errores más frecuentes de cada servidor web te ayudará a identificarlos y corregirlos más rápido. Esta herramienta detecta errores comunes de sintaxis, pero siempre debes probar tu configuración con el comando nativo del servidor.

ServidorError típicoCausaSolución
NginxMissing semicolonOlvidar punto y coma al final de directivasAgrega punto y coma al final de cada directiva
NginxDuplicate locationDos bloques location con la misma rutaCombina reglas en un solo bloque location
ApacheVirtualHost mal formadoFalta cierre de VirtualHost o anidación incorrectaVerifica que cada VirtualHost tenga su cierre
ApacheInvalid commandDirectiva mal escrita o módulo deshabilitadoHabilita el módulo con a2enmod o corrige nombre
HAProxyUnknown keywordPalabra clave mal escrita en la directivaRevisa la ortografía de la palabra clave
HAProxyMissing argumentDirectiva bind sin especificar puertoAñade el puerto a la directiva bind

Esta herramienta es un análisis estático básico y no puede detectar todos los errores lógicos o de configuración. Siempre complementa con el comando nativo del servidor.

Preguntas frecuentes

¿Cuáles son los errores más comunes en nginx.conf?

Los errores más frecuentes en Nginx incluyen: punto y coma faltante al final de directivas como server_name o root; bloques location mal cerrados; paréntesis curvos faltantes en expresiones regex; nombres de archivo incorrectos en las directivas ssl_certificate; y la falta del bloque events antes de definir server. También es común olvidar incluir puntos y coma después de las líneas que contienen rutas de archivo.

¿Por qué Apache devuelve "Syntax error on line X"?

Apache es muy estricto con la sintaxis. Los errores típicos incluyen: VirtualHost anidados incorrectamente, directivas sin cerrar, rutas de archivo con espacios sin comillas, etiquetas <Directory> que no cierran, y la omisión de la directiva Require en configuraciones de acceso. VirtualHosts mal formados (como olvidar </VirtualHost>) son la causa número uno de errores en Apache.

¿Cuál es la diferencia entre validar y testear la configuración?

La validación (validate) es un análisis estático que revisa la sintaxis básica del archivo, mientras que testear (test) ejecuta la configuración en el contexto del servidor real, verificando que los puertos estén disponibles, los archivos referenciados existan, los certificados SSL sean válidos, y los módulos requeridos estén cargados. Nginx "nginx -t" realiza ambas operaciones. La validación online detecta errores de sintaxis, pero siempre debes ejecutar el comando nativo del servidor para una verificación completa antes de recargar.

¿Cómo interpretar los errores de sintaxis en HAProxy?

HAProxy muestra errores con el formato "[ALERT] (pid) : parsing [archivo.cfg:línea] : error". Los más comunes incluyen: "unknown keyword" (palabra clave mal escrita), "missing argument" (falta un parámetro como "bind" sin puerto), "duplicate name" (dos backends con el mismo nombre), y errores de indentación porque HAProxy espera que los parámetros dentro de un bloque estén tabulados. Un typo en "bind" (como "bnd") es un error frecuente.

¿Qué herramientas de línea de comandos complementan este validador?

Además de nuestro validador online, debes conocer los comandos nativos: "nginx -t" para Nginx (con "nginx -T" para ver la configuración completa), "apache2ctl configtest" o "httpd -t" para Apache, y "haproxy -c -f archivo.cfg" para HAProxy. Para debugging avanzado usa "nginx -s reload" combinado con logs de error, y "systemctl status apache2" para ver errores de servicio. Herramientas como "grep" y "sed" ayudan a localizar líneas problemáticas en archivos grandes.

¿Puede este validador detectar errores lógicos o de seguridad en la configuración?

Nuestro validador realiza análisis estático básico y puede detectar errores de sintaxis, paréntesis desbalanceados y palabras clave inválidas. Sin embargo, no puede detectar errores lógicos como reglas de proxy mal configuradas, conflictos de rutas, problemas de permisos de archivos, o vulnerabilidades de seguridad como SSL mal configurado. Para estos casos, combínalo con herramientas como SSL Labs, linters especializados o pruebas de carga.