Guide de dépannage des services Web

ServBay prend en charge l'utilisation de Caddy, NGINX et Apache comme serveur Web par défaut. Dans l'utilisation quotidienne, les utilisateurs peuvent rencontrer des problèmes tels que des sites Web inaccessibles. Ci-dessous, vous trouverez des solutions aux problèmes courants.

Dépannage avec les outils intégrés de ServBay

ServBay intègre un outil de diagnostic très puissant. Nous vous recommandons d'utiliser l'outil de dépannage fourni par ServBay pour un diagnostic et une résolution autonomes.

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

Vérification du fichier de configuration

Vérification du Caddyfile

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 message Valid configuration s'affiche, cela signifie que tout va bien. Si d'autres codes d'erreur apparaissent, veuillez suivre les instructions fournies par le code d'erreur. (Remarque : la commande ci-dessus produira de nombreuses sorties INFO et WARN. C'est normal et cela n'affectera pas le 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 introuvable. Veuillez vérifier si le chemin du fichier de certificat est correct.

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 du site

Si vous voyez l'erreur parsing caddyfile tokens for 'root': too many arguments, veuillez vérifier si le chemin du répertoire du site contient des espaces. C'est une erreur très courante.

Par exemple, root * /Applications/ServBay/www/public web, où il y a un espace entre public et web, sera interprété comme deux paramètres, entraînant une erreur. La méthode correcte consiste à entourer le chemin de guillemets (") : par exemple, root * "/Applications/ServBay/www/public web".

Nous vous conseillons fortement de ne pas inclure d'espaces et de symboles spéciaux dans les noms de fichiers ou les chemins. Pour séparer les mots, vous pouvez utiliser les symboles - 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ègles de réécriture

L'utilisation de règles de réécriture incorrectes dans Caddy, comme celles directement issues de NGINX, peut également provoquer des erreurs.

Vérification de la configuration NGINX

Utilisez la commande suivante pour vérifier si la configuration NGINX est correcte :

$ /Applications/ServBay/bin/nginx -t

Si la configuration est correcte, cela affichera :

nginx: the configuration file /Applications/ServBay/etc/nginx/nginx.conf syntax is ok
nginx: configuration file /Applications/ServBay/etc/nginx/nginx.conf test is successful

Les erreurs courantes comprennent :

1. Erreurs de syntaxe (comme un point-virgule manquant)
2. Chemin de fichier erroné
3. Conflits de port

Vérification de la configuration Apache

Utilisez la commande suivante pour vérifier la configuration Apache :

$ /Applications/ServBay/bin/apachectl configtest

Les erreurs courantes comprennent :

1. Échec de chargement d'un module
2. Erreurs de syntaxe dans le fichier .htaccess
3. Paramètres de permissions de répertoire incorrects

Gestion des erreurs 500

L'erreur 500 de serveur interne est une erreur courante des serveurs Web, pouvant être causée par de nombreuses raisons :

Étapes de dépannage générales

1. Vérifiez les journaux d'erreurs du serveur :

   • 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. Vérifiez si le service PHP est en cours d'exécution

   ps aux | grep php-fpm

3. Vérifiez les erreurs PHP (si PHP est utilisé) :

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

4. Vérifiez les permissions des fichiers :

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

   Assurez-vous que l'utilisateur du serveur Web a les autorisations de lecture.

Erreurs 500 spécifiques à Caddy

1. Vérifiez si la configuration FastCGI est correcte.
2. Assurez-vous que le service PHP-FPM fonctionne.
3. Vérifiez les paramètres de proxy inverse.

Erreurs 500 spécifiques à NGINX

1. Vérifiez si les paramètres fastcgi_pass sont corrects.
2. Vérifiez si client_max_body_size est suffisant.
3. Vérifiez la configuration des directives try_files.

Erreurs 500 spécifiques à Apache

1. Vérifiez si mod_rewrite est activé.
2. Vérifiez le contenu du fichier .htaccess.
3. Vérifiez les paramètres AllowOverride.

Gestion des services

Redémarrer un service

Si vous avez modifié la configuration, vous devez redémarrer le service concerné :

# Caddy
$ servbayctl restart caddy -all

# NGINX
$ servbayctl restart nginx -all

# Apache
$ servbayctl restart apache -all

Vérifier l'état du service

# Caddy
$ servbayctl status caddy -all

# NGINX
$ servbayctl status nginx -all

# Apache
$ servbayctl status apache -all

Dépannage avancé

Si les méthodes ci-dessus ne résolvent pas le problème, vous pouvez essayer :

1. De désactiver temporairement le pare-feu pour des tests.
2. D'utiliser curl -v pour voir les détails de la requête.
3. De tester sur différents navigateurs/appareils.
4. De vérifier si la résolution DNS est correcte.

Pour obtenir une assistance supplémentaire, veuillez contacter l'équipe de support technique de ServBay.