Guida al Troubleshooting dei Servizi Web

ServBay supporta l'utilizzo di Caddy, NGINX e Apache come server web predefiniti. Durante l'uso quotidiano, gli utenti potrebbero incontrare problemi come l'impossibilità di aprire il sito web. Di seguito sono riportate alcune soluzioni per problemi comuni.

Utilizzo degli Strumenti di Diagnosi di ServBay

ServBay include uno strumento di diagnosi molto potente. Si consiglia di utilizzare il tool di troubleshooting di ServBay per autodiagnosi e risoluzione dei problemi.

Apri l'app ServBay e trova Diagnosi nel menu di navigazione a sinistra per accedere allo strumento di diagnosi di ServBay.

Controllo del File di Configurazione

Verifica del Caddyfile

Usa la funzione di validazione integrata di Caddy per verificare se il Caddyfile è corretto. Esegui il seguente comando

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

Se restituisce Valid configuration, significa che tutto funziona correttamente. Se restituisce altri codici di errore, procedi in base alle indicazioni fornite dal codice di errore. (Nota: il comando sopra fornirà un gran numero di output INFO e WARN, il che è normale e non influisce sul funzionamento 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. Controlla se l'indirizzo del file del certificato è corretto.

2024/12/09 17:24:16.970 INFO utilizzando la configurazione dal file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
2024/12/09 17:24:16.991 INFO adattata la configurazione a JSON {"adapter": "caddyfile"}
2024/12/09 17:24:16.991 WARN Input del Caddyfile non formattata; eseguire 'caddy fmt --overwrite' per correggere le incongruenze {"adapter": "caddyfile", "file": "/Applications/ServBay/etc/caddy/Caddyfile", "line": 8}
2024/12/09 17:24:16.999 INFO manutenzione del tls.cache avviata {"cache": "0x1400121f300"}
2024/12/09 17:24:17.006 INFO manutenzione del tls.cache interrotta {"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

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

Ad esempio, root * /Applications/ServBay/www/public web, presenta uno spazio tra public e web, il che provoca l'interpretazione come due argomenti, generando un errore. Il metodo corretto è racchiudere il percorso tra virgolette ("), come in root * "/Applications/ServBay/www/public web".

Si consiglia vivamente di non includere spazi o simboli speciali in nomi di file o percorsi. Per separare le parole, puoi usare simboli come - o _, ad esempio: public-folder, public_dir.

2024/12/09 17:26:37.371 INFO utilizzando la configurazione dal file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}

Error: adattamento della configurazione usando caddyfile: parsing caddyfile tokens per 'root': troppi argomenti; dovrebbero esserci solo un matcher e un percorso, in /Applications/ServBay/etc/caddy/Caddyfile:1388

Errore nelle Regole di Rewrite

Utilizzare regole di Rewrite non corrette in Caddy, come per esempio regole dirette di NGINX, porterà anch'esso a errori.

Controllo della Configurazione di NGINX

Utilizza il seguente comando per verificare se la configurazione di NGINX è corretta:

$ /Applications/ServBay/bin/nginx -t

Se la configurazione è corretta, comparirà:

nginx: il file di configurazione /Applications/ServBay/etc/nginx/nginx.conf ha una sintassi corretta
nginx: il test del file di configurazione /Applications/ServBay/etc/nginx/nginx.conf è riuscito

Errori comuni includono:

1. Errori di sintassi (come punti e virgola mancanti)
2. Percorsi di file errati
3. Conflitti di porte

Controllo della Configurazione di Apache

Utilizza il seguente comando per verificare la configurazione di Apache:

$ /Applications/ServBay/bin/apachectl configtest

Errori comuni includono:

1. Caricamento di moduli fallito
2. Errori di sintassi nel file .htaccess
3. Impostazioni di permessi delle directory errate

Gestione degli Errori 500

L'errore 500 Internal Server Error è un errore comune dei server web che può essere causato da diverse ragioni:

Passaggi di Diagnosi Generali

1. Controlla i log degli errori del server:

   • 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. Verifica se il servizio PHP è attivo

   ps aux | grep php-fpm

3. Controlla gli errori di PHP (se utilizzi PHP):

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

4. Controlla i permessi dei file:

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

   Assicurati che l'utente del server web abbia i permessi di lettura

Errori 500 Specifici di Caddy

1. Controlla se la configurazione di FastCGI è corretta
2. Assicurati che il servizio PHP-FPM sia in esecuzione
3. Verifica le impostazioni del proxy inverso

Errori 500 Specifici di NGINX

1. Controlla se le impostazioni di fastcgi_pass sono corrette
2. Verifica se client_max_body_size è sufficientemente grande
3. Controlla la configurazione della direttiva try_files

Errori 500 Specifici di Apache

1. Controlla se mod_rewrite è abilitato
2. Verifica il contenuto del file .htaccess
3. Controlla le impostazioni di AllowOverride

Gestione dei Servizi

Riavvio dei Servizi

Se hai modificato la configurazione, è necessario riavviare i servizi corrispondenti:

# Caddy
$ servbayctl restart caddy -all

# NGINX
$ servbayctl restart nginx -all

# Apache
$ servbayctl restart apache -all

Controllo dello Stato dei Servizi

# Caddy
$ servbayctl status caddy -all

# NGINX
$ servbayctl status nginx -all

# Apache
$ servbayctl status apache -all

Troubleshooting Avanzato

Se i metodi sopra non risolvono il problema, puoi provare:

1. Disattivare temporaneamente il firewall per testare
2. Utilizzare curl -v per visualizzare i dettagli delle richieste
3. Testare su diversi browser/dispositivi
4. Controllare se la risoluzione DNS è corretta

Se hai bisogno di ulteriore assistenza, contatta il team di supporto tecnico di ServBay.