# Pagine di Errore Personalizzate

Source: https://support.kapsulehost.com/it-it/site-error-pages

Una pagina di errore personalizzata sostituisce la pagina predefinita del server con il tuo HTML brandizzato, mantenendo il vero stato di errore in modo che i motori di ricerca continuino a vedere un reale 404. Questa guida illustra come aggiungere 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

1. Accedi a [KPanel](https://kpanel.kapsulehost.com).
2. Fai clic su **Siti web** nella barra laterale sinistra, poi fai clic sul sito.
3. Nel menu a sinistra del sito, apri **Impostazioni**, poi **Pagine di errore**.

L'indirizzo diretto è `/websites/<site-id>/error-pages`.

![Pagine di errore personalizzate per un sito in KPanel](https://support.kapsulehost.com/help/screenshots/site-error-pages.89c17e2d.webp)

## Perché Vale la Pena Farlo

Una pagina di errore predefinita del server è un vicolo cieco. Non ha branding, navigazione né spiegazioni, quindi un visitatore che vi atterra solitamente se ne va.

Una pagina personalizzata trasforma tutto questo in un percorso di ritorno verso il sito: il tuo logo, la tua tipografia, una frase nel tuo tono di voce e un link alla home o a una casella di ricerca. Su un sito di grandi dimensioni, gli URL digitati male o ormai obsoleti rappresentano un flusso costante di traffico, e una pagina 404 è il modo più economico per recuperarlo che tu possa mai costruire.

## I Codici Supportati

Puoi impostare una pagina personalizzata per otto codici, una pagina per ogni codice:

| Codice | Significato | Causa tipica |
|---|---|---|
| 400 | Richiesta non valida | Una richiesta malformata |
| 401 | Non autorizzato | Autenticazione richiesta o non riuscita |
| 403 | Vietato | Una regola di accesso ha bloccato la richiesta |
| 404 | Non trovato | Non esiste nulla a quell'URL |
| 500 | Errore interno del server | La tua applicazione non ha funzionato |
| 502 | Gateway non valido | L'applicazione non ha risposto correttamente |
| 503 | Servizio non disponibile | L'applicazione è inattiva o sovraccarica |
| 504 | Timeout del gateway | L'applicazione ha impiegato troppo tempo |

Inizia con il 404. È di gran lunga il più comune, ed è l'unico che un visitatore raggiunge tramite la normale navigazione e non a causa di un guasto.

Vale la pena occuparsi poi della famiglia 5xx, perché sono le pagine che le persone vedono nel tuo giorno peggiore. Una pagina brandizzata e rassicurante, che dice che qualcosa è andato storto e fornisce un indirizzo email, è molto meglio di un errore vuoto del server.

## Aggiungere una Pagina

1. Fai clic su **Aggiungi pagina di errore**.
2. Scegli un codice di errore dal menu a tendina. I codici già in uso non vengono elencati.
3. Sostituisci l'HTML di esempio nel campo **Corpo HTML** con il tuo.
4. Fai clic su **Aggiungi pagina di errore**.

L'editor parte da un documento 404 funzionante che puoi modificare, un buon punto di partenza se vuoi semplicemente qualcosa di ordinato in modo rapido.

## Scrivere l'HTML

Fornisci un documento HTML completo, a partire dal doctype. Viene servito così com'è, quindi deve reggersi da solo.

Alcuni elementi HTML vengono rimossi prima ancora che la pagina venga salvata, per sicurezza:

- tag `<script>`
- gestori di eventi inline come `onclick`
- iframe
- fogli di stile remoti

Se è stato rimosso qualcosa, un avviso te lo segnala dopo il salvataggio.

> **Warning:** Poiché i fogli di stile remoti vengono rimossi, una pagina di errore non può richiamare il file CSS principale del tuo sito. Stilizzala con CSS inline o con un blocco `<style>` nell'head del documento. Questo è intenzionale: una pagina di errore deve essere renderizzata anche quando il resto del sito è compromesso, e una pagina che dipende dal recupero di risorse da un server non funzionante verrà renderizzata come testo privo di stile proprio nel momento peggiore.

Indicazioni pratiche:

- **Mantienila piccola e autosufficiente.** Includi tutto in linea. Evita immagini esterne. L'elenco delle pagine mostra la dimensione in KB di ciascuna pagina.
- **Dì cosa è successo con parole semplici.** "Non siamo riusciti a trovare quella pagina" è meglio di "404 Non trovato".
- **Offri un modo per proseguire.** Un link alla home, un link alle sezioni principali o una casella di ricerca.
- **Includi un modo per contattarti** nelle pagine 5xx, poiché il visitatore non può usare il sito per raggiungerti.
- **Non usarla per reindirizzare.** Se un URL si è spostato, reindirizzalo correttamente invece. Vedi [Reindirizzamenti del Sito](https://support.kapsulehost.com/it-it/site-redirects).

## Lo Stato di Errore Viene Mantenuto

La tua pagina personalizzata viene servita con il vero stato di errore, non con 200. Un 404 rimane un 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 nessuno strumento segnala mai i link non funzionanti. Poiché KapsuleHost mantiene lo stato reale, tutto questo continua a funzionare correttamente.

## Interpretare il Badge di Stato

La colonna **Status** riporta ciò che è stato effettivamente possibile verificare, ed è deliberatamente onesta riguardo ai propri limiti.

| Badge | Significato |
|---|---|
| Verificato: pagina branded fornita (vero 404) | Abbiamo forzato un 404 dall'esterno e abbiamo ottenuto la tua pagina con lo stato corretto |
| Configurato (non verificato esternamente) | La pagina è applicata. Quel codice non può essere attivato dall'esterno su richiesta |
| Non ancora verificato | Il controllo non è ancora stato eseguito |
| Applicato, test live inconcludente | Il test ha ottenuto qualcosa di diverso da un 404 pulito, spesso perché un reindirizzamento lo ha intercettato |
| Ottenuto un 404 ma la pagina branded non è stata servita | La regola è impostata ma la tua pagina non è stata restituita. Prova a salvarla di nuovo |

Solo il 404 può essere forzato dall'esterno. Richiedere un URL inesistente produce in modo affidabile un 404, ma non esiste alcun modo per far produrre a un server sano un vero 500 su richiesta senza romperlo. Per questo gli altri codici riportano **Configurato** invece di dichiarare una verifica che non è mai avvenuta. Vengono comunque serviti quando l'errore si verifica realmente.

Potresti anche vedere un avviso che indica che un'altra configurazione sul server rivendica lo stesso dominio. Finché questo non viene risolto, la pagina di errore potrebbe non essere applicata. Contatta l'assistenza se lo vedi.

## Risolvere i Problemi di un Sito che Sta Effettivamente Generando Errori

Se sei qui perché il tuo sito sta generando errori, e non perché vuoi pagine più belle, questa pagina offre una scorciatoia: 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 malfunzionamenti di questo sito e di dirti la causa probabile e come risolverla. È un primo passo molto più rapido rispetto alla lettura dei log grezzi.

Per il quadro generale delle prestazioni, consulta [Prestazioni del Sito e APM](https://support.kapsulehost.com/it-it/site-performance), e per l'andamento del tasso di errore nel tempo, consulta [Analitiche di Traffico del Sito](https://support.kapsulehost.com/it-it/site-analytics).

## Modificare ed Eliminare

Ogni riga ha un pulsante di modifica, che apre lo stesso editor con il codice fissato e l'HTML caricato, e un pulsante di rimozione.

La rimozione richiede una conferma e spiega il risultato: le richieste che incontrano quel codice ricadranno sulla pagina predefinita del server.

## Risoluzione dei Problemi

**La mia pagina non viene mostrata.** Conferma di star attivando il codice giusto. Un percorso che reindirizza non raggiunge mai un 404. Esegui un test con un URL che effettivamente non esiste, in una finestra privata in modo che non intervenga alcuna cache.

**La pagina viene mostrata ma appare priva di stile.** Il tuo foglio di stile è stato rimosso in quanto risorsa remota. Inserisci il CSS in linea.

**Il mio script di tracciamento è mancante.** Gli script vengono rimossi di proposito. Non c'è modo di eseguire JavaScript da una pagina di errore personalizzata qui.

**Tutti i codici hanno già una pagina.** Tutti e otto sono già in uso. Modifica una pagina esistente invece di aggiungerne un'altra.

**Il badge indica che la pagina branded non è stata servita.** Salva di nuovo la pagina. Se il problema persiste, e non è comparso alcun avviso di conflitto di dominio, apri un ticket.

## Pagine Correlate

- [Reindirizzamenti del Sito](https://support.kapsulehost.com/it-it/site-redirects) per evitare che il 404 si verifichi fin dall'inizio.
- [Analitiche di Traffico del Sito](https://support.kapsulehost.com/it-it/site-analytics) per vedere quante risposte 4xx e 5xx stai effettivamente servendo.
- [Proteggere un Sito con Password](https://support.kapsulehost.com/it-it/site-password-protect), che produce risposte 401 per progettazione.