Caddy und Web-Dienstfehlerbehebung

ServBay verwendet Caddy als Standard-Webserver. Im täglichen Gebrauch können Benutzer auf Probleme wie das Nichtöffnen von Websites stoßen. Im Folgenden sind einige häufige Probleme und deren Lösungen aufgeführt.

Verwendung der ServBay-eigenen Tools zur Fehlerbehebung

ServBay verfügt über sehr leistungsstarke Diagnosewerkzeuge. Wir empfehlen, die Fehlerbehebungstools von ServBay zur Selbstdiagnose und -behebung zu verwenden.

Öffnen Sie die ServBay-Anwendung und wählen Sie im linken Navigationsbereich Fehlerdiagnose, um Zugang zu den integrierten Diagnosewerkzeugen von ServBay zu erhalten.

Überprüfung der Caddyfile

Wenn Sie das Problem manuell beheben möchten, können Sie die folgenden Schritte befolgen.

Verwenden Sie die integrierte Validierungsfunktion von Caddy, um zu überprüfen, ob die Caddyfile korrekt ist. Führen Sie den folgenden Befehl aus:

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

Wenn Valid configuration zurückgegeben wird, bedeutet das, dass alles in Ordnung ist. Wenn andere Fehlermeldungen angezeigt werden, führen Sie gemäß den Hinweisen der Fehlermeldung die nächsten Schritte aus. (Hinweis: Der obige Befehl gibt viele INFO- und WARN-Nachrichten aus, was normal ist und den regulären Betrieb des Dienstes nicht beeinträchtigt.)

Zertifikatfehler

Wenn Sie einen Fehler sehen wie loading certificates: open xxxxx: no such file or directory, bedeutet das, dass die Zertifikatsdatei nicht vorhanden ist. Überprüfen Sie den Pfad zur Zertifikatsdatei.

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 Websiteverzeichnis

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

Beispielsweise root * /Applications/ServBay/www/public web, wo zwischen public und web ein Leerzeichen ist, wird dies als zwei Argumente interpretiert, was zu einem Fehler führt. Die korrekte Methode besteht darin, den Pfad in Anführungszeichen (") zu setzen, beispielsweise 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 die Zeichen - oder _ verwendet werden, 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 in Rewrite-Regeln

Die Verwendung von falschen Rewrite-Regeln in Caddy, wie z. B. die direkte Verwendung von NGINX-Regeln, kann ebenfalls zu Fehlern führen.