# Svuotare la cache di Kapsule CDN

Source: https://support.kapsulehost.com/it-it/cdn-cache-purge

Svuotare la cache elimina la copia dei tuoi contenuti conservata all'edge, così il visitatore successivo riceve una versione appena recuperata dalla tua origine. È ciò che fai quando hai pubblicato una modifica e continua a comparire la versione vecchia.

La cache è ciò che rende veloce la CDN, ed è anche il motivo per cui una modifica appena fatta potrebbe non comparire subito. Invece di azzerare la durata della cache, mantienila lunga e svuota la cache quando serve. Questa guida tratta entrambe le cose, oltre a come distinguere una cache edge da una cache del browser prima di cercare nel posto sbagliato.

## Quando svuotare la cache

Svuota la cache dopo aver modificato qualcosa che i visitatori recuperano tramite URL:

- Hai sostituito un file CSS o JavaScript e viene ancora servito quello vecchio.
- Hai caricato una nuova versione di un'immagine sopra un nome di file già esistente.
- Hai corretto un errore in una pagina e vuoi che la versione difettosa sparisca ovunque, subito.
- Hai modificato il contenuto di una pagina e non puoi aspettare che scada il TTL edge.

Non devi svuotare la cache quando hai aggiunto una pagina del tutto nuova o un nuovo nome di file. Per un URL mai richiesto non c'è nulla in cache.

> **Tip:** Se inserisci una versione nei nomi dei file delle risorse (`style.a1b2c3.css` invece di `style.css`), raramente dovrai svuotare la cache. Un nuovo nome di file è un nuovo URL, quindi viene recuperato da zero dalla tua origine e messo in cache con una propria chiave.

## Dove si trova il comando per svuotare la cache

1. Accedi a [KPanel](https://kpanel.kapsulehost.com).
2. Fai clic su **Siti web** nella barra laterale sinistra, poi sul tuo sito.
3. Nel menu del sito, apri **Prestazioni**, poi **Kapsule CDN**.
4. Scorri fino alla scheda **Svuota cache**.

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

![La scheda Svuota cache nella pagina Kapsule CDN](https://support.kapsulehost.com/help/screenshots/cdn-cache-purge.881b7fa3.webp)

> **Note:** Il comando per svuotare la cache compare solo quando la CDN è attiva per il sito. Se la pagina mostra il banner **CDN disattivata per questo sito**, o ti chiede di collegare un dominio personalizzato, all'edge non c'è ancora nulla da svuotare. [Attivare Kapsule CDN sul tuo sito](https://support.kapsulehost.com/it-it/cdn-enabling) elenca esattamente quali piani la includono.

## Svuotare un singolo URL

1. Nella scheda **Svuota cache**, digita l'URL pubblico completo nel campo **URL da svuotare (lascia vuoto per l'intero sito)**. Il testo di esempio del campo mostra la forma prevista: `https://your-domain.tld/path`.
2. Fai clic su **Svuota**.
3. Compare una conferma che indica che l'URL inserito è stato svuotato.

Usa esattamente l'URL che un visitatore richiederebbe, compresi lo schema (`https://`), l'host e il percorso. Lo svuotamento viene abbinato all'URL, quindi `https://example.com/about` e `https://example.com/about/` sono due voci di cache diverse, e lo stesso vale per la stessa pagina con una query string aggiunta.

Svuotare un singolo URL è la prima mossa giusta quando sai esattamente cosa è cambiato. È immediato e lascia intatto il resto della cache, così il resto del sito resta veloce.

## Svuotare l'intero sito

1. Lascia il campo **URL da svuotare** completamente vuoto.
2. Fai clic su **Svuota**.
3. La conferma riporta "Cache completamente svuotata."

> **Warning:** Uno svuotamento completo elimina ogni oggetto in cache del sito in ogni posizione edge. Finché ciascun URL non viene richiesto di nuovo, ogni visitatore viene servito dalla tua origine, quindi l'origine riceve un picco di traffico e il primo visitatore di ogni pagina attende un viaggio di andata e ritorno completo. Su un sito molto frequentato, è preferibile svuotare solo gli URL specifici che hai modificato.

Ogni svuotamento che esegui viene registrato nel registro attività dell'account con l'URL o un indicatore di zona completa, così puoi vedere chi ha svuotato cosa e quando.

## Durata della cache e come interagiscono

La scheda **Cache TTL**, nella stessa pagina, controlla per quanto tempo i contenuti restano validi senza uno svuotamento:

| Impostazione | Cosa controlla | Predefinito |
|---|---|---|
| **Edge TTL (secondi)** | Per quanto tempo l'edge conserva una copia prima di recuperarla di nuovo dalla tua origine | 3600 (1 ora) |
| **Browser TTL (secondi)** | Per quanto tempo il browser di un visitatore conserva la propria copia locale | 3600 (1 ora) |

Le due sono indipendenti, e questa è in assoluto la fonte di confusione più comune. Lo svuotamento cancella l'**edge**. Non può arrivare nel browser di un visitatore. Se svuoti la cache e vedi ancora tu stesso la versione vecchia, quasi certamente stai guardando la cache del tuo browser.

Per escluderlo, carica la pagina in una finestra privata o in incognito, oppure esegui un ricaricamento forzato. Se la finestra privata mostra la nuova versione, lo svuotamento ha funzionato e stai solo aspettando il tuo browser e quelli degli altri visitatori, che si aggiorneranno alla scadenza del loro TTL del browser.

> **Tip:** Se pubblichi spesso e non puoi inserire versioni nei nomi dei file, riduci il **Browser TTL** a un valore breve (qualche minuto) e lascia lungo l'**Edge TTL**. Mantieni gran parte del vantaggio dell'edge e dai ai visitatori una finestra molto più breve in cui possono restare bloccati su una copia vecchia.

## Ottimizzazione delle immagini e svuotamento

Se l'**Ottimizzazione delle immagini al volo** è attiva (una funzionalità di Kapsule CDN+), l'edge conserva la versione ottimizzata di ogni immagine accanto all'originale. Svuotare l'URL dell'immagine cancella anche la versione ottimizzata, quindi un'immagine sostituita viene ottimizzata di nuovo alla richiesta successiva. Non esiste uno svuotamento separato per le immagini ottimizzate.

Lo stesso vale per **Servi WebP ai browser supportati**: la variante WebP si trova sotto lo stesso URL e viene cancellata dallo stesso svuotamento.

## Risoluzione dei problemi

**"CDN non fornito per questo sito."** Il sito non ha ancora una zona edge. Attiva prima la CDN e attendi che il certificato abbia completato il provisioning.

**"Svuotamento della cache non riuscito."** La richiesta di svuotamento non ha raggiunto l'edge. Attendi un momento e riprova. Se continua a non riuscire, la zona edge potrebbe essere ancora in fase di provisioning: verifica che la pagina mostri il banner **CDN attiva**.

**Ho svuotato la cache e la pagina è ancora vecchia.** Controlla prima in una finestra privata. Se anche una finestra privata mostra la versione vecchia, verifica di aver svuotato esattamente l'URL giusto, compresi l'eventuale barra finale e la query string, poi prova uno svuotamento completo.

**Solo alcuni visitatori vedono l'aggiornamento.** I loro browser sono ancora entro il TTL del browser. Non c'è nulla che non va: riceveranno la nuova versione alla sua scadenza, oppure subito con un ricaricamento forzato.

**L'origine è crollata dopo uno svuotamento completo.** È il picco di traffico non in cache descritto sopra. Aumenta il TTL edge e la prossima volta svuota solo gli URL che sono cambiati. [Migliorare la velocità del sito web](https://support.kapsulehost.com/it-it/website-speed) spiega come rendere più resistente l'origine stessa.

Se uno svuotamento riesce ma l'edge continua a servire contenuti vecchi per più di qualche minuto, scrivi a [support@kapsulehost.com](mailto:support@kapsulehost.com) indicando l'URL esatto e l'ora dello svuotamento.