Webdienst Fehlersuche Leitfaden

ServBay unterstützt die Nutzung von Caddy, NGINX und Apache als Standard-Webserver. Im täglichen Gebrauch kann es vorkommen, dass Nutzer auf Probleme stoßen, wie zum Beispiel Webseiten, die nicht geladen werden. Im Folgenden finden Sie Lösungen für einige häufige Probleme.

Verwendung der integrierten Tools von ServBay zur Fehlerbehebung

ServBay verfügt über ein sehr leistungsfähiges Fehlerdiagnosetool, daher empfehlen wir, das Fehlerbehebungstool von ServBay zur Selbstdiagnose und -lösung zu verwenden.

Öffnen Sie die ServBay-Anwendung und finden Sie im linken Navigationsbereich Fehlerdiagnose, um auf das integrierte Fehlerdiagnosetool von ServBay zuzugreifen.

Überprüfung der Konfigurationsdateien

Caddyfile Überprüfung

Verwenden Sie die eingebaute Validierungsfunktion von Caddy, um die Richtigkeit der Caddyfile zu überprüfen. Bitte führen Sie den folgenden Befehl aus:

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

Wenn Valid configuration zurückgegeben wird, ist alles in Ordnung. Wenn ein anderer Fehlercode zurückgegeben wird, folgen Sie den Hinweisen des Fehlercodes für die nächsten Schritte. (Hinweis: Der oben genannte Befehl erzeugt viele INFO- und WARN-Ausgaben; das ist normal und hat keinen Einfluss auf den reibungslosen Betrieb des Dienstes.)

Zertifikatsfehler

Falls ein Fehler wie loading certificates: open xxxxx: no such file or directory auftritt, bedeutet das, dass die Zertifikatdatei nicht existiert. Bitte überprüfen Sie, ob der Pfad zur Zertifikatdatei korrekt ist.

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

Fehler im Webverzeichnis

Wenn der Fehler parsing caddyfile tokens for 'root': too many arguments auftritt, überprüfen Sie, ob im Pfad des Webverzeichnisses Leerzeichen vorhanden sind. Dies ist ein sehr häufiges Problem.

Beispielsweise hat root * /Applications/ServBay/www/public web ein Leerzeichen zwischen public und web, wodurch dies als zwei Parameter interpretiert wird und einen Fehler verursacht. Die korrekte Möglichkeit ist, den Pfad mit Anführungszeichen (") zu umschließen. Zum Beispiel root * "/Applications/ServBay/www/public web".

Wir empfehlen dringend, keine Leerzeichen oder Sonderzeichen in Dateinamen und Pfaden zu verwenden. Für die Trennung von Wörtern können Sie die Symbole - oder _ verwenden, wie z.B.: 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

Fehler bei Rewrite-Regeln

Wenn im Caddy falsche Rewrite-Regeln verwendet werden, wie z.B. direkt NGINX-Regeln, kann dies ebenfalls zu Fehlern führen.

NGINX Konfigurationsüberprüfung

Verwenden Sie den folgenden Befehl, um die NGINX-Konfiguration auf Richtigkeit zu überprüfen:

$ /Applications/ServBay/bin/nginx -t

Wenn die Konfiguration korrekt ist, wird folgendes angezeigt:

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

Häufige Fehler sind:

1. Syntaxfehler (z.B. fehlendes Semikolon)
2. Falscher Dateipfad
3. Portkonflikte

Apache Konfigurationsüberprüfung

Verwenden Sie den folgenden Befehl, um die Apache-Konfiguration zu überprüfen:

$ /Applications/ServBay/bin/apachectl configtest

Häufige Fehler sind:

1. Modul konnte nicht geladen werden
2. Syntaxfehler in .htaccess-Dateien
3. Falsche Verzeichnisberechtigungen

500 Fehlerbehebung

Fehler 500 - Interner Serverfehler ist ein gängiger Webserverfehler, der durch verschiedene Ursachen hervorgerufen werden kann:

Allgemeine Fehlersuche

1. Überprüfen Sie die Server-Fehlerprotokolle:

   • 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. Überprüfen Sie, ob der PHP-Dienst gestartet ist

   ps aux | grep php-fpm

3. Überprüfen Sie PHP-Fehler (sofern PHP verwendet wird):

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

4. Überprüfen Sie die Dateiberechtigungen:

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

   Stellen Sie sicher, dass der Webserver-Benutzer Leseberechtigungen hat.

Caddy-spezifische 500 Fehler

1. Überprüfen Sie, ob die FastCGI-Konfiguration korrekt ist.
2. Stellen Sie sicher, dass der PHP-FPM-Dienst läuft.
3. Überprüfen Sie die Einstellungen des Reverse Proxy.

NGINX-spezifische 500 Fehler

1. Überprüfen Sie, ob die Einstellung fastcgi_pass korrekt ist.
2. Überprüfen Sie, ob client_max_body_size groß genug ist.
3. Überprüfen Sie die Konfiguration der try_files-Direktive.

Apache-spezifische 500 Fehler

1. Überprüfen Sie, ob mod_rewrite aktiviert ist.
2. Überprüfen Sie den Inhalt der .htaccess-Datei.
3. Überprüfen Sie die Einstellungen von AllowOverride.

Dienstverwaltung

Dienst neu starten

Wenn Sie die Konfiguration geändert haben, müssen Sie den entsprechenden Dienst neu starten:

# Caddy
$ servbayctl restart caddy -all

# NGINX
$ servbayctl restart nginx -all

# Apache
$ servbayctl restart apache -all

Dienststatus überprüfen

# Caddy
$ servbayctl status caddy -all

# NGINX
$ servbayctl status nginx -all

# Apache
$ servbayctl status apache -all

Erweiterte Fehlerbehebung

Wenn die oben genannten Methoden das Problem nicht lösen, können Sie Folgendes versuchen:

1. Firewall vorübergehend deaktivieren und testen
2. Verwenden Sie curl -v, um detaillierte Anforderungsinformationen zu sehen.
3. In verschiedenen Browsern/ Geräten testen.
4. Überprüfen Sie, ob die DNS-Auflösung korrekt ist.

Für weitere Unterstützung wenden Sie sich bitte an das technische Support-Team von ServBay.