CDN
Svuotamento della cache di Kapsule CDN
Purging clears the copy of your content held at the edge so the next visitor gets a freshly fetched version from your origin, which is what you do when you have published a change and the old…
Lo svuotamento cancella la copia del tuo contenuto conservata ai margini della rete, così il prossimo visitatore riceve una versione appena recuperata dalla tua origine, cioè quello che fai quando hai pubblicato una modifica e la versione precedente è ancora visualizzata.
La memorizzazione nella cache è ciò che rende il CDN veloce, ed è anche il motivo per cui una modifica che hai appena apportato potrebbe non apparire subito. Invece di ridurre i tuoi tempi di cache a zero, mantienili lunghi e svuota su richiesta. Questa guida copre entrambi gli aspetti, oltre a come distinguere una cache edge da una cache del browser prima di cercare nel posto sbagliato.
Quando Devi Svuotare
Svuota dopo aver modificato qualcosa che i visitatori recuperano tramite URL:
- Hai sostituito un file CSS o JavaScript e quello vecchio viene ancora servito.
- Hai caricato una nuova versione di un'immagine sopra un nome di file esistente.
- Hai corretto un bug su una pagina e vuoi che la versione non funzionante scompaia globalmente, subito.
- Hai modificato il contenuto di una pagina e non puoi aspettare che il TTL edge scada.
Non devi svuotare quando hai aggiunto una pagina completamente nuova o un nuovo nome di file. Niente viene messo in cache per un URL che non è mai stato richiesto.
Se versionali i nomi dei tuoi file di risorse (style.a1b2c3.css piuttosto che style.css), raramente hai bisogno di svuotare affatto. Un nuovo nome di file è un nuovo URL, quindi viene recuperato fresco dalla tua origine e messo in cache con la sua propria chiave.
Dove si Trova il Controllo di Svuotamento
- Accedi a KPanel.
- Fai clic su Websites nella barra laterale sinistra, quindi fai clic sul tuo sito.
- Nel menu del sito, apri Performance, quindi Kapsule CDN.
- Scorri verso il basso fino alla scheda Purge cache.
L'indirizzo diretto è /websites/<site-id>/cdn.

Il controllo di svuotamento appare solo una volta che il CDN è attivato per il sito. Se la pagina mostra il banner CDN is off for this site, o ti chiede di connettere un dominio personalizzato, non c'è ancora nulla ai margini da svuotare. Kapsule CDN è anche un diritto del piano, quindi un sito su un piano Orbit o Container Hosting non ha alcun CDN. Enabling Kapsule CDN on Your Site elenca esattamente quali piani lo includono.
Svuotamento di un Singolo URL
- Nella scheda Purge cache, digita l'URL pubblico completo in URL to purge (leave blank for whole site). Il segnaposto del campo mostra la forma prevista:
https://your-domain.tld/path. - Fai clic su Purge.
- Appare una conferma che recita "Purged" seguita dall'URL che hai inserito.
Usa l'URL esatto che un visitatore richiederebbe, incluso lo schema (https://), l'host e il percorso. Uno svuotamento viene abbinato all'URL, quindi https://example.com/about e https://example.com/about/ sono due voci di cache diverse, così come la stessa pagina con una stringa di query allegata.
Lo svuotamento di un URL è la mossa giusta da fare per prima quando sai esattamente cosa è cambiato. È istantaneo e lascia intatta il resto della tua cache, quindi il resto del sito rimane veloce.
Svuotamento dell'Intero Sito
- Lascia il campo URL to purge completamente vuoto.
- Fai clic su Purge.
- La conferma recita "Full cache purged."
Uno svuotamento completo svuota ogni oggetto memorizzato nella cache per il sito in ogni posizione edge. Fino a quando ogni 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 aspetta un viaggio di andata e ritorno completo. Su un sito trafficato, preferisci svuotare gli URL specifici che hai modificato.
Ogni svuotamento che esegui viene registrato nel registro attività dell'account con l'URL o un marcatore di zona completa, così puoi vedere chi ha svuotato cosa e quando.
Tempi di Cache e Come Interagiscono
La scheda Cache TTLs, sulla stessa pagina, controlla per quanto tempo il contenuto sopravvive senza uno svuotamento:
| Impostazione | Cosa controlla | Predefinito |
|---|---|---|
| Edge TTL (seconds) | Per quanto tempo il margine della rete tiene una copia prima di recuperare di nuovo dalla tua origine | 3600 (1 ora) |
| Browser TTL (seconds) | Per quanto tempo il browser di un visitatore mantiene la sua copia locale | 3600 (1 ora) |
I due sono indipendenti, e questa è la fonte più comune di confusione. Uno svuotamento cancella il margine della rete. Non può raggiungere il browser di un visitatore. Se svuoti e vedi ancora la versione vecchia tu stesso, stai quasi certamente guardando la tua cache del browser.
Per escludere questo, carica la pagina in una finestra privata o in incognito, oppure fai un ricaricamento forzato. Se la finestra privata mostra la nuova versione, lo svuotamento ha funzionato e stai solo aspettando il tuo browser e i browser degli altri visitatori, che si aggiorneranno una volta che il loro browser TTL scade.
Se pubblichi di frequente e non puoi versionare i nomi dei file, riduci il Browser TTL a qualcosa di breve (pochi minuti) e lascia il Edge TTL lungo. Mantieni la maggior parte del vantaggio edge mentre dai ai visitatori una finestra molto più breve in cui possono stare bloccati su una copia vecchia.
Ottimizzazione delle Immagini e Svuotamento
Se On-the-fly image optimisation è attivo, il margine della rete memorizza il derivato ottimizzato di ogni immagine insieme all'originale. Lo svuotamento dell'URL dell'immagine cancella anche il derivato, quindi un'immagine sostituita viene ri-ottimizzata alla sua prossima richiesta. Non c'è uno svuotamento separato per le immagini ottimizzate.
Lo stesso si applica a Serve WebP to supported browsers: la variante WebP vive sotto lo stesso URL ed è cancellata dallo stesso svuotamento.
Risoluzione dei Problemi
"CDN not provisioned for this site." Il sito non ha ancora una zona edge. Abilita il CDN per primo e aspetta che il certificato finisca di eseguire il provisioning.
"Purge failed." La richiesta di svuotamento non ha raggiunto il margine della rete. Aspetta un momento e riprova. Se continua a non riuscire, la zona edge potrebbe essere in fase di provisioning; verifica che la pagina mostri il banner CDN is on.
Ho svuotato e la pagina è ancora vecchia. Controlla prima in una finestra privata. Se anche una finestra privata mostra la versione vecchia, conferma di aver svuotato l'URL esatto, incluso qualsiasi barra finale e stringa di query, quindi prova uno svuotamento completo.
Solo alcuni visitatori vedono l'aggiornamento. I loro browser sono ancora dentro il browser TTL. Non c'è nulla di sbagliato: raccoglieranno la nuova versione quando scade, o immediatamente con un ricaricamento forzato.
L'origine si è fermata dopo uno svuotamento completo. Questo è il picco di traffico non memorizzato nella cache descritto sopra. Aumenta il TTL edge, e la prossima volta svuota solo gli URL che hai modificato. Improving Website Speed riguarda il rendimento dell'origine stessa più resiliente.
Se uno svuotamento ha successo ma il margine della rete continua a servire contenuto vecchio per più di pochi minuti, invia un'email a support@kapsulehost.com con l'URL esatto e l'ora in cui hai svuotato.