Caddy et Guide de Dépannage de Services Web

ServBay utilise Caddy comme serveur Web par défaut. Dans l'utilisation quotidienne, les utilisateurs peuvent rencontrer des problèmes tels que des sites Web qui ne s'ouvrent pas. Voici quelques solutions aux problèmes courants.

Utiliser les Outils de Dépannage Intégrés de ServBay

ServBay dispose d'un outil de diagnostic très puissant. Nous vous recommandons d'utiliser l'outil de dépannage intégré de ServBay pour l'auto-diagnostic et la résolution de problèmes.

Ouvrez l'application ServBay et trouvez Dépannage dans la navigation à gauche pour accéder à l'outil de diagnostic intégré de ServBay.

Vérifier le Caddyfile

Si vous souhaitez dépanner manuellement, vous pouvez suivre certaines étapes ci-dessous.

Utilisez la fonction de validation intégrée de Caddy pour vérifier si le Caddyfile est correct. Veuillez exécuter la commande suivante :

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

Si le retour est Valid configuration, cela signifie que tout est en ordre. Si un autre code d'erreur est retourné, veuillez suivre les instructions fournies par le code d'erreur pour la prochaine étape. (Remarque : la commande ci-dessus génèrera une grande quantité de sorties INFO et WARN, ce qui est normal et n’affectera pas le bon fonctionnement du service.)

Erreur de Certificat

Si vous voyez une erreur comme loading certificates: open xxxxx: no such file or directory, cela signifie que le fichier de certificat est inexistant. Veuillez vérifier si l'adresse du fichier de certificat est correcte.

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

Erreur de Répertoire de Site Web

Si vous recevez l'erreur parsing caddyfile tokens for 'root': too many arguments, veuillez vérifier s'il y a des espaces dans le chemin du répertoire du site Web. C'est une erreur très courante.

Par exemple, root * /Applications/ServBay/www/public web contient un espace entre public et web, ce qui sera interprété comme deux arguments, entraînant une erreur. La bonne méthode de configuration est d'encapsuler le chemin avec des guillemets ("). Par exemple, root * "/Applications/ServBay/www/public web".

Nous vous recommandons fortement de ne pas inclure d'espaces ou de symboles spéciaux dans les noms de fichiers ou les chemins. Pour séparer les mots, vous pouvez utiliser le symbole - ou _, comme : 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

Erreurs de Règle de Réécriture

L'utilisation de règles de réécriture incorrectes dans Caddy, comme l'utilisation directe de règles NGINX, peut également entraîner des erreurs.