Siti web
Pagine di errore personalizzate
A custom error page replaces the plain server default with your own branded HTML, while keeping the true error status so search engines still see a real 404. This guide covers adding a page for each…
Una pagina di errore personalizzata sostituisce il banale default del server con il tuo HTML brandizzato, mantenendo lo stato di errore reale affinché i motori di ricerca riconoscano comunque un vero 404. Questa guida copre l'aggiunta di una pagina per ogni codice supportato, cosa viene rimosso per sicurezza e come funziona il badge di verifica.
Dove si trovano le pagine di errore in KPanel
- Accedi a KPanel.
- Fai clic su Websites nella barra laterale sinistra, quindi fai clic sul sito.
- Nella scheda del sito, apri Advanced, quindi Error pages.
L'indirizzo diretto è /websites/<site-id>/error-pages.
Perché preoccuparsene
Una pagina di errore default del server è un vicolo cieco. Non ha branding, non ha navigazione e non ha spiegazioni, quindi un visitatore che vi si ritrova di solito se ne va.
Una pagina personalizzata trasforma il tutto in una via di ritorno al sito: il tuo logo, la tua tipografia, una frase con la tua voce e un link alla home o a una casella di ricerca. Su un sito grande, gli URL errati e obsoleti rappresentano un flusso costante di traffico, e una pagina 404 è il recupero più economico che costruirai mai.
I codici supportati
Puoi impostare una pagina personalizzata per otto codici, una pagina per codice:
| Codice | Significato | Causa tipica |
|---|---|---|
| 400 | Bad Request | Una richiesta malformata |
| 401 | Unauthorized | Autenticazione richiesta o non riuscita |
| 403 | Forbidden | Una regola di accesso ha bloccato la richiesta |
| 404 | Not Found | Non esiste nulla a questo URL |
| 500 | Internal Server Error | La tua applicazione non ha funzionato |
| 502 | Bad Gateway | L'applicazione non ha risposto correttamente |
| 503 | Service Unavailable | L'applicazione è giù o sovraccarica |
| 504 | Gateway Timeout | L'applicazione ha impiegato troppo tempo |
Inizia con 404. È di gran lunga la più comune, ed è l'unica che un visitatore raggiunge attraverso la navigazione ordinaria piuttosto che per un errore.
La famiglia 5xx vale la pena affrontarla dopo, perché quelle sono le pagine che le persone vedono nel tuo giorno peggiore. Una pagina brandizzata calma che dice che qualcosa è andato storto e fornisce un indirizzo email è molto meglio di un errore del server vuoto.
Aggiunta di una pagina
- Fai clic su Add error page.
- Scegli un codice di errore dal menu a discesa. I codici già in uso non sono elencati.
- Sostituisci l'HTML di esempio nel campo HTML body con il tuo.
- Fai clic su Add error page.
L'editor inizia con un documento 404 funzionante che puoi modificare, il che è un buon punto di partenza se vuoi solo qualcosa di ordinato e veloce.
Scrittura dell'HTML
Fornisci un documento HTML completo, iniziando con un doctype. Viene servito così com'è, quindi deve essere autosufficiente.
Parte dell'HTML viene rimosso prima ancora che la pagina venga archiviata, per motivi di sicurezza:
- Tag
<script> - gestori di eventi inline come
onclick - iframe
- fogli di stile remoti
Se qualcosa è stato rimosso, un avviso te lo comunica dopo il salvataggio.
Poiché i fogli di stile remoti vengono rimossi, una pagina di errore non può richiamare il file CSS principale del tuo sito. Stilizzalo con CSS inline o un blocco <style> nell'head del documento. Questo è intenzionale: una pagina di errore deve renderizzarsi quando il resto del sito non funziona, e una pagina che dipende dal recupero di asset da un server guasto verrà renderizzata come testo senza stile proprio nel momento sbagliato.
Indicazioni pratiche:
- Mantienilo piccolo e autosufficiente. Incorpora tutto. Evita immagini esterne. L'elenco delle pagine mostra la dimensione di ogni pagina in KB.
- Spiega cosa è successo con parole semplici. "Non abbiamo trovato quella pagina" è meglio di "404 Not Found".
- Fornisci una via d'uscita. Un link alla home, un link alle tue sezioni principali o una casella di ricerca.
- Includi una via di contatto nelle pagine 5xx, poiché il visitatore non può usare il sito per raggiungerti.
- Non usarlo per reindirizzare. Se un URL si è spostato, reindirizzalo correttamente invece. Vedi Site Redirects.
Lo stato di errore è preservato
La tua pagina personalizzata viene servita con lo stato di errore reale, non 200. Un 404 rimane 404 fino al client.
Questo è più importante di quanto sembri. Una pagina brandizzata restituita come 200 è un soft 404: i motori di ricerca la indicizzano come una pagina reale, le tue analitiche la contano come una visualizzazione riuscita, e i link interrotti non vengono mai segnalati da nessuno strumento. Poiché Kapsule mantiene lo stato vero, tutto questo continua a funzionare correttamente.
Lettura del badge di stato
La colonna Status riporta cosa potrebbe essere effettivamente verificato, ed è deliberatamente onesta sui limiti.
| Badge | Significato |
|---|---|
| Verified: branded page served (true 404) | Abbiamo forzato un 404 dall'esterno e abbiamo ricevuto la tua pagina con lo stato corretto |
| Configured (not externally tested) | La pagina è applicata. Quel codice non può essere attivato dall'esterno su richiesta |
| Not yet verified | Il controllo non è ancora stato eseguito |
| Applied, live test inconclusive | La sonda ha ricevuto qualcosa di diverso da un 404 pulito, spesso perché un reindirizzamento l'ha catturato |
| Got a 404 but the branded page was not served | La regola è in place ma la tua pagina non è tornata. Prova a salvare di nuovo |
Solo 404 può essere forzato esternamente. La richiesta di un URL che non esiste produce in modo affidabile un 404, ma non c'è modo di far produrre a un server sano un vero 500 su richiesta senza romperlo. Quindi gli altri codici riportano Configured piuttosto che affermare una verifica che non è mai accaduta. Continuano comunque a essere serviti quando l'errore si verifica effettivamente.
Potresti anche vedere un avviso che un'altra configurazione sul server reclama lo stesso dominio. Finché non viene risolto, la pagina di errore potrebbe non applicarsi. Contatta il supporto se lo vedi.
Risoluzione dei problemi di un sito che sta effettivamente generando errori
Se sei qui perché il tuo sito sta generando errori piuttosto che perché vuoi pagine più carine, la pagina ha un collegamento: il pulsante Troubleshoot with Kora nel banner in alto.
Chiede a Kora, l'assistente all'interno di KPanel, di leggere i tuoi log degli errori e i recenti fallimenti per questo sito e di dirti la causa probabile e come risolverla. È un primo passo molto più veloce rispetto alla lettura dei log raw.
Per il quadro prestazioni sottostante, vedi Site Performance and APM, e per il tasso di errore nel tempo, vedi Site Traffic Analytics.
Modifica e rimozione
Ogni riga ha un pulsante di modifica, che apre lo stesso editor con il codice fisso e l'HTML caricato, e un pulsante di rimozione.
La rimozione chiede una conferma e spiega il risultato: le richieste che raggiungono quel codice ricadono sulla pagina predefinita del server.
Risoluzione dei problemi
La mia pagina non viene visualizzata. Conferma di stare attivando il codice giusto. Un percorso che reindirizza non raggiunge mai un 404. Prova con un URL che effettivamente non esiste, in una finestra privata in modo che nessuna cache sia coinvolta.
La pagina viene visualizzata ma sembra senza stile. Il tuo foglio di stile è stato rimosso come asset remoto. Incorpora il CSS.
Il mio script di tracciamento manca. Gli script vengono rimossi per design. Non c'è modo di eseguire JavaScript da una pagina di errore personalizzata qui.
Tutti i codici hanno già una pagina. Tutti e otto sono in uso. Modifica una pagina esistente invece di aggiungerne un'altra.
Il badge dice che la pagina brandizzata non è stata servita. Salva di nuovo la pagina. Se persiste e non è apparso alcun avviso di conflitto di dominio, apri un ticket.
Pagine correlate
- Site Redirects per evitare che il 404 accada in primo luogo.
- Site Traffic Analytics per vedere quante risposte 4xx e 5xx stai effettivamente servendo.
- Password-Protecting a Site, che produce risposte 401 per design.