Caddy e guida alla risoluzione dei problemi del servizio Web

ServBay utilizza Caddy come server web predefinito, durante l'uso quotidiano, gli utenti possono riscontrare problemi come l'impossibilità di accedere al sito web. Di seguito sono riportati alcuni metodi per risolvere problemi comuni.

Utilizzare gli strumenti di diagnosi integrati di ServBay

ServBay include strumenti di diagnosi molto potenti. Si consiglia di utilizzare il tool di risoluzione dei problemi integrato in ServBay per l'auto-diagnosi e la risoluzione.

Aprire l'app ServBay e trovare Diagnosi nel menu a sinistra per accedere allo strumento di diagnosi integrato.

Controllare il Caddyfile

Se si desidera risolvere i problemi manualmente, è possibile seguire alcuni passaggi di seguito.

Utilizzare la funzione di verifica integrata di Caddy per convalidare il Caddyfile. Eseguire il seguente comando:

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

Se restituisce Valid configuration, tutto è a posto. Se restituisce altri codici errore, procedere in base ai messaggi forniti dai codici errore. (Nota: il comando sopra genererà un ampio output di INFO e WARN, che è normale e non influenzerà l'esecuzione del servizio.)

Errore di certificato

Se appare un errore simile a loading certificates: open xxxxx: no such file or directory, significa che il file del certificato non esiste. Si prega di controllare se l'indirizzo del file del certificato è corretto.

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

Errore nella directory del sito web

Se si verifica l'errore parsing caddyfile tokens for 'root': too many arguments, controllare se ci sono spazi nel percorso della directory del sito web. Questo è un errore molto comune.

Ad esempio, root * /Applications/ServBay/www/public web, c'è uno spazio tra public e web, che sarà considerato come due argomenti, causando un errore. La corretta impostazione è avvolgere il percorso tra virgolette ("). Ad esempio, root * "/Applications/ServBay/www/public web".

Si consiglia vivamente di non includere spazi e simboli speciali in nomi di file o percorsi. Per separare le parole, si possono usare i simboli - o _, come: 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

Errore nelle regole di Rewrite

Utilizzare regole di Rewrite non corrette in Caddy, ad esempio utilizzando direttamente le regole di NGINX, può anche causare errori.