Caddy y Guía de solución de problemas de servicios web

ServBay utiliza Caddy como servidor web predeterminado. Durante el uso diario, los usuarios pueden encontrarse con problemas como que el sitio no se carga; a continuación se presentan algunos métodos para resolver problemas comunes.

Usar herramientas de diagnóstico de ServBay

ServBay incluye una poderosa herramienta de diagnóstico. Se recomienda usar la herramienta de solución de problemas integrada de ServBay para el auto-diagnóstico y resolución.

Abre la aplicación ServBay, busca diagnóstico en la navegación de la izquierda para acceder a la herramienta de diagnóstico incorporada.

Revisar Caddyfile

Si deseas solucionar problemas de forma manual, puedes seguir los siguientes pasos:

Usa la función de validación incorporada en Caddy para verificar si el Caddyfile es correcto. Ejecuta el siguiente comando:

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

Si devuelve Valid configuration, significa que todo está correcto. Si devuelve otros códigos de error, sigue las indicaciones que proporciona el código de error. (Nota: el comando anterior generará mucha salida de INFO y WARN, esto es normal y no afectará la operación normal del servicio).

Error de certificado

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

2024/12/09 17:24:16.970 INFO using config from file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
2024/12/09 17:24:16.991 INFO adapted config to JSON {"adapter": "caddyfile"}
2024/12/09 17:24:16.991 WARN Caddyfile input is not formatted; run 'caddy fmt --overwrite' to fix inconsistencies {"adapter": "caddyfile", "file": "/Applications/ServBay/etc/caddy/Caddyfile", "line": 8}
2024/12/09 17:24:16.999 INFO tls.cache.maintenance started background certificate maintenance {"cache": "0x1400121f300"}
2024/12/09 17:24:17.006 INFO tls.cache.maintenance stopped background certificate maintenance {"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

Error de directorio del sitio web

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

Por ejemplo, en root * /Applications/ServBay/www/public web, hay un espacio entre public y web, lo que se tomará como dos argumentos, provocando un error. La forma correcta de configurarlo es envolviendo la ruta con comillas dobles ("). Por ejemplo, root * "/Applications/ServBay/www/public web".

Recomendamos encarecidamente no incluir espacios ni símbolos especiales en ningún nombre de archivo o ruta. Para separar palabras, puedes usar el símbolo - o _, como por ejemplo: public-folder, public_dir.

2024/12/09 17:26:37.371 INFO using config from file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}

Error: adapting config using caddyfile: parsing caddyfile tokens for 'root': too many arguments; should only be a matcher and a path, at /Applications/ServBay/etc/caddy/Caddyfile:1388

Error en las reglas de Rewrite

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