Guía de Solución de Problemas de Servicios Web

ServBay soporta el uso de Caddy, NGINX y Apache como servidores web predeterminados. Durante el uso diario, los usuarios pueden encontrar problemas como que el sitio web no se abre; a continuación, se presentan algunas soluciones a problemas comunes.

Resolución de Problemas con Herramientas de ServBay

ServBay incluye una herramienta de diagnóstico de fallos muy potente. Se recomienda utilizar la herramienta de solución de problemas de ServBay para diagnóstico y solución autónoma.

Abra la aplicación ServBay y en la navegación de la izquierda, encuentre Diagnóstico de Fallos para acceder a la herramienta de diagnóstico proporcionada por ServBay.

Verificación de Archivos de Configuración

Verificación de Caddyfile

Utilice la función de verificación integrada de Caddy para comprobar si el Caddyfile es correcto. Ejecute el siguiente comando:

$ /Applications/ServBay/bin/caddy validate -c /Applications/ServBay/etc/caddy/Caddyfile

Si devuelve Valid configuration, significa que todo está bien. Si devuelve otros códigos de error, proceda según las indicaciones del código de error. (Nota: el comando anterior generará una gran cantidad de salidas INFO y WARN, lo cual es normal y no afectará el funcionamiento del servicio.)

Errores de Certificado

Si aparece un error similar a loading certificates: open xxxxx: no such file or directory, significa que el archivo de certificado no existe. Verifique si la dirección del archivo de certificado es correcta.

2024/12/09 17:24:16.970 INFO usando configuración desde el archivo {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
2024/12/09 17:24:16.991 INFO adaptando configuración a JSON {"adapter": "caddyfile"}
2024/12/09 17:24:16.991 WARN La entrada del Caddyfile no está formateada; ejecute 'caddy fmt --overwrite' para corregir inconsistencias {"adapter": "caddyfile", "file": "/Applications/ServBay/etc/caddy/Caddyfile", "line": 8}
2024/12/09 17:24:16.999 INFO tls.cache.maintenance mantenimiento de certificados en segundo plano iniciado {"cache": "0x1400121f300"}
2024/12/09 17:24:17.006 INFO tls.cache.maintenance mantenimiento de certificados en segundo plano detenido {"cache": "0x1400121f300"}

Error: loading http app module: provision http: getting tls app: loading tls app module: provision tls: loading certificates: open /Applications/ServBay/ssl/private/tls-certs/mail.servbay.host/mail.servbay.host.1crt: no such file or directory

Errores en el Directorio del Sitio Web

Si aparece el error parsing caddyfile tokens for 'root': too many arguments, verifique si hay espacios en la ruta del directorio del sitio web. Este es un error muy común.

Por ejemplo, root * /Applications/ServBay/www/public web tiene un espacio entre public y web, lo que se interpreta como dos parámetros, provocando un error. La forma correcta de configurarlo es envolver la ruta con comillas dobles ("). Por ejemplo, root * "/Applications/ServBay/www/public web".

Se recomienda firmemente no incluir espacios ni símbolos especiales en nombres de archivos o rutas. Para separar palabras, puede usar - o _, por ejemplo: public-folder, public_dir.

2024/12/09 17:26:37.371 INFO usando configuración desde el archivo {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}

Error: adaptando configuración usando caddyfile: parsing caddyfile tokens for 'root': too many arguments; debe haber solo un matcher y una ruta, en /Applications/ServBay/etc/caddy/Caddyfile:1388

Errores en Reglas de Rewrite

Utilizar reglas de Rewrite incorrectas en Caddy, como intentar usar directamente reglas de NGINX, también puede causar errores.

Verificación de Configuración de NGINX

Utilice el siguiente comando para verificar si la configuración de NGINX es correcta:

$ /Applications/ServBay/bin/nginx -t

Si la configuración es correcta, se mostrará:

nginx: el archivo de configuración /Applications/ServBay/etc/nginx/nginx.conf tiene una sintaxis correcta
nginx: la prueba del archivo de configuración /Applications/ServBay/etc/nginx/nginx.conf fue exitosa

Errores comunes incluyen:

1. Errores de sintaxis (como falta de punto y coma)
2. Errores en la ruta del archivo
3. Conflictos de puerto

Verificación de Configuración de Apache

Utilice el siguiente comando para verificar la configuración de Apache:

$ /Applications/ServBay/bin/apachectl configtest

Errores comunes incluyen:

1. Fallo al cargar módulos
2. Errores de sintaxis en el archivo .htaccess
3. Configuración incorrecta de permisos de directorio

Manejo de Errores 500

Los errores 500 de servidor interno son errores comunes en servidores web, y pueden deberse a múltiples razones:

Pasos Generales de Verificación

1. Verifique los registros de errores del servidor:

   • Caddy: /Applications/ServBay/var/logs/caddy/error.log
   • NGINX: /Applications/ServBay/var/logs/nginx/error.log
   • Apache: /Applications/ServBay/var/logs/apache/error.log

2. Verifique si el servicio PHP está en funcionamiento

   ps aux | grep php-fpm

3. Verifique los errores de PHP (si está utilizando PHP):

   • /Applications/ServBay/var/logs/php/php_error.log

4. Verifique los permisos de los archivos:

   $ ls -la /Applications/ServBay/www/your-site

   Asegúrese de que el usuario del servidor web tenga permisos de lectura.

Errores 500 Específicos de Caddy

1. Verifique que la configuración de FastCGI sea correcta.
2. Asegúrese de que el servicio PHP-FPM esté en funcionamiento.
3. Verifique la configuración del proxy inverso.

Errores 500 Específicos de NGINX

1. Verifique la configuración de fastcgi_pass.
2. Verifique que client_max_body_size sea lo suficientemente grande.
3. Verifique la configuración de la directiva try_files.

Errores 500 Específicos de Apache

1. Verifique si mod_rewrite está habilitado.
2. Valide el contenido del archivo .htaccess.
3. Verifique la configuración de AllowOverride.

Gestión de Servicios

Reiniciar Servicios

Si ha modificado la configuración, necesita reiniciar los servicios correspondientes:

# Caddy
$ servbayctl restart caddy -all

# NGINX
$ servbayctl restart nginx -all

# Apache
$ servbayctl restart apache -all

Ver Estado de los Servicios

# Caddy
$ servbayctl status caddy -all

# NGINX
$ servbayctl status nginx -all

# Apache
$ servbayctl status apache -all

Resolución de Problemas Avanzada

Si los métodos anteriores no resuelven el problema, puede intentar:

1. Desactivar temporalmente el firewall para pruebas.
2. Usar curl -v para ver detalles de la solicitud.
3. Probar en diferentes navegadores / dispositivos.
4. Verificar si la resolución DNS es correcta.

Para obtener más ayuda, comuníquese con el equipo de soporte técnico de ServBay.