Nginx è fuori uso? Stato in tempo reale e segnalazioni di guasti

Informazioni sul servizio e risoluzione dei problemi

Il sito non risponde alle richieste

Quando Nginx restituisce un errore 502 o 504, il problema è quasi sempre nel backend: il server applicativo non è raggiungibile o risponde troppo lentamente. Controlla che il processo upstream sia attivo e che la porta sia in ascolto. Se il timeout è troppo basso nella configurazione, aumenta i valori di proxy_connect_timeout e proxy_read_timeout. Riavvia il servizio dopo ogni modifica e verifica i log in /var/log/nginx/error.log per individuare l'errore esatto.

Pagina di login non carica correttamente

Questo succede spesso quando la configurazione del proxy non passa correttamente gli header di autenticazione. Assicurati che proxy_set_header Host e proxy_set_header X-Real-IP siano presenti nel blocco location. Senza questi header, l'applicazione non riconosce l'origine della richiesta e può bloccare l'accesso.

Errore 403 su file o directory

• Verifica i permessi dei file nella root del sito: Nginx deve poterli leggere con l'utente di sistema corretto, di solito www-data o nginx.
• Controlla la direttiva autoindex: se è disabilitata e manca un file indice, il server restituisce 403.
• Ricontrolla il percorso nella direttiva root o alias: un errore di battitura è sufficiente a bloccare tutto.

Certificato SSL scaduto o non valido

Se il browser mostra un avviso di connessione non sicura, il certificato potrebbe essere scaduto o il percorso nei file di configurazione è errato. Verifica le date con il comando openssl x509 -noout -dates -in /path/to/cert.pem. Se usi Certbot, esegui il rinnovo manuale con certbot renew e ricarica il servizio.

Upload di file bloccato o incompleto

Nginx limita la dimensione massima del corpo delle richieste tramite la direttiva client_max_body_size. Il valore predefinito è 1 megabyte, troppo basso per upload di immagini o documenti. Aumentalo nel blocco server o http in base alle esigenze reali, poi riavvia il processo.

Latenza elevata nelle risposte

• Abilita la compressione gzip per ridurre il peso delle risposte testuali.
• Configura la cache proxy con proxy_cache per evitare richieste ripetute al backend.
• Controlla il numero di worker_processes e worker_connections: valori troppo bassi creano colli di bottiglia sotto carico.

Connessione WebSocket interrotta

Le applicazioni in tempo reale perdono la connessione se mancano gli header Upgrade e Connection nella configurazione del proxy. Aggiungi proxy_http_version 1.1, proxy_set_header Upgrade $http_upgrade e proxy_set_header Connection upgrade nel blocco location dedicato. Senza questi, il server chiude il tunnel immediatamente.