La ricostruzione reinstalla da zero il sistema operativo sul tuo server esistente: cancella completamente il disco e ti lascia una macchina pulita con gli stessi indirizzi IP.
È lo strumento giusto per poche attività e uno strumento pessimo per tutto il resto. Questa guida spiega quando una ricostruzione è davvero la risposta, cosa distrugge, una conseguenza specifica che coglie molti di sorpresa e come prepararsi bene prima di fare clic.
Quando ricostruire è la scelta giusta
Ricostruisci quando:
- Vuoi cambiare sistema operativo, ad esempio da Ubuntu a Debian, o da una versione di Ubuntu a un'altra.
- Il sistema operativo non si avvia o è talmente danneggiato che ripararlo richiederebbe più tempo che ripartire da capo.
- Stai destinando il server a un uso completamente diverso e non vuoi che resti nulla della vecchia configurazione.
- Vuoi davvero che tutto ciò che c'è sul disco sparisca.
Non ricostruire per annullare una modifica appena fatta. A questo servono gli snapshot, e tornare a uno snapshot è più rapido e conserva i tuoi dati. Non ricostruire per liberare spazio su disco, per sistemare un'applicazione lenta o perché qualcosa è configurato male: niente di tutto questo richiede di sostituire il sistema operativo.
Leggi prima di ricostruire
Una ricostruzione distrugge definitivamente tutto ciò che si trova sul server: ogni sito, casella di posta, database, file caricato, pacchetto installato, certificato, cron job e file di configurazione. Non si può annullare, e dopo l'ultima conferma non ce n'è un'altra. La finestra di conferma lo dice chiaramente: "This reinstalls the operating system and permanently destroys everything on the server. This cannot be undone." (Questa operazione reinstalla il sistema operativo e distrugge definitivamente tutto ciò che si trova sul server. Non può essere annullata.)
La ricostruzione cancella gli strumenti KapsuleHost installati sul disco al primo provisioning del server, e sono proprio questi strumenti che il pannello usa per accedere alla macchina. Li reinstalliamo noi per te, automaticamente, e lo verifichiamo. I tuoi dati di backup esistenti sono conservati separatamente in uno storage esterno cifrato e non vengono toccati dalla ricostruzione.
Mentre questo avviene, Ripristina, Backup ora, il firewall in tempo reale e l'applicazione delle patch, e la console del browser non funzionano, perché dipendono tutti da quegli strumenti sul disco. Di solito servono pochi minuti. Il server resta contrassegnato come in ricostruzione per tutto il tempo: viene mostrato come pronto solo quando ciascuno di quegli elementi è stato riletto dalla macchina e confermato presente, così il pannello non ti mostra mai in verde un server che non è davvero in grado di gestire.
Se non riusciamo a ripristinarli, te lo diciamo. Il server resta in ricostruzione invece di diventare verde, e contemporaneamente viene allertato il nostro team operativo. Non devi controllare tu.
I tuoi indirizzi IPv4 e IPv6 non cambiano. Cambia solo il contenuto del disco.
Prepararsi a una ricostruzione
Segui questo elenco prima di iniziare. Nulla è facoltativo se sul server c'è qualcosa a cui tieni.
- Crea uno snapshot. Uno snapshot è una copia completa del disco. È l'unica cosa che ti permette di riavere la macchina attuale se cambi idea. Vedi Snapshot dei server cloud.
- Esporta tutto ciò con cui vuoi continuare a lavorare. Copia database, file caricati e configurazione in un posto fuori dal server: il tuo computer, un altro server o uno storage a oggetti. I tuoi backup esistenti sopravvivono alla ricostruzione e il pannello può ripristinarli una volta finita, ma una copia che hai tu è la strada più rapida per tornare a un sito funzionante.
- Annota cosa è installato. Dopo una ricostruzione dovrai rimettere in piedi il tuo stack a mano. Un elenco di pacchetti, servizi, virtual host e cron job fa risparmiare ore.
- Controlla il DNS. Tutto ciò che punta a questo server punterà a una macchina vuota per tutta la durata della ricostruzione e della nuova configurazione.
- Verifica di poter rientrare. Decidi adesso come ti collegherai al sistema operativo appena installato, e vedi Collegarsi al server cloud tramite SSH.
La console del browser non è disponibile nei pochi minuti tra la fine della ricostruzione e il ripristino degli strumenti, quindi non farne il tuo unico modo per rientrare. Tieni pronto SSH.
Come ricostruire
- Accedi a KPanel.
- Fai clic su Server Cloud nella barra laterale sinistra, poi sul server.
- Fai clic su Ricostruisci OS tra i pulsanti di azione in cima alla pagina.
- Si apre la finestra Ricostruisci OS con la riga "Tutti i dati su questo server andranno persi. Scegli l'OS da installare:" e un menu a tendina.
- Scegli il sistema operativo che vuoi:
- Ubuntu 24.04 LTS, l'attuale versione con supporto a lungo termine.
- Ubuntu 22.04 LTS, la precedente versione con supporto a lungo termine.
- Debian 12 (Bookworm), una Debian stabile e leggera.
- Fai clic su Ricostruisci Server.
- Compare un'ultima conferma, intitolata "Rebuild" (Ricostruisci) seguito dal nome del tuo server. Leggila, poi fai clic su Ricostruisci Server.

Ricostruisci OS è disponibile solo quando il server è In esecuzione o Spento. Un server ancora in fase di provisioning, o già in ricostruzione, non può essere ricostruito.
Cosa succede dopo
- Lo stato del server passa a Ricostruzione e compare un banner: "Ricostruzione in corso: la pagina si aggiornerà automaticamente."
- Tutto il contenuto del disco viene cancellato e al suo posto viene scritta l'immagine del sistema operativo scelto.
- Il server si riavvia nella nuova installazione.
- La pagina si aggiorna da sola e lo stato torna In esecuzione.
Il server resta offline per tutto il tempo. Una ricostruzione è di solito rapida, ma trattala come un'interruzione del servizio e non come un'attività in background, e falla in un momento in cui i tuoi utenti non se ne accorgano.
Dopo la ricostruzione
Ora hai un sistema operativo vuoto. Nulla di ciò che avevi installato prima esiste più.
- Collegati al server e verifica di ottenere una shell. Vedi Collegarsi al server cloud tramite SSH.
- Applica di nuovo le tue regole del firewall. La ricostruzione ha rimosso quelle vecchie. Vedi Firewall e gestione della sicurezza del server cloud.
- Reinstalla il tuo stack: web server, runtime, database e tutte le dipendenze dell'applicazione.
- Ripristina i tuoi dati esportati.
- Emetti di nuovo i certificati SSL. Quelli precedenti si trovavano sul disco che è stato cancellato.
Non dare per scontato che il backup giornaliero riprenda da solo il server. Se gli strumenti di backup lato server sono stati rimossi dalla ricostruzione, i backup non ripartiranno da soli. Controlla la scheda Backup dopo la ricostruzione e contattaci se indica che i backup non sono configurati. Vedi Backup dei server cloud.
Alternative da considerare prima
| Cosa vuoi | Strumento migliore di una ricostruzione |
|---|---|
| Annullare una modifica appena fatta | Tornare a uno snapshot |
| Recuperare file eliminati o un database danneggiato | Ripristinare da un backup |
| Più CPU, memoria o disco | Ridimensionare il server |
| Un'altra famiglia di processori o un'altra regione | Ordinare un nuovo server; vedi Scegliere tra vCPU ARM, standard e dedicata |
| Un ambiente pulito per i test | Creare un secondo server piccolo e lasciare intatto questo |
Risoluzione dei problemi
Il pulsante Ricostruisci OS è disattivato. Il server non si trova in uno stato che lo consente. Attendi la fine del provisioning o di una ricostruzione in corso.
Lo stato è bloccato su Ricostruzione. La pagina interroga lo stato ogni pochi secondi e si aggiorna da sola. Se dopo quindici minuti non è cambiato nulla, contatta il supporto indicando il nome del server.
Non riesco a collegarmi dopo la ricostruzione. Ti stai collegando a un'installazione del sistema operativo completamente nuova, con nuove chiavi host, quindi il tuo client SSH rifiuterà la vecchia impronta. Rimuovi la voce della chiave host obsoleta per quell'indirizzo IP e ricollegati. Se è l'autenticazione stessa a non riuscire, contattaci.
Ho ricostruito per errore. Se prima avevi creato uno snapshot, torna a quello. Altrimenti i dati sono persi. È per questo che la conferma è formulata così.
Se non sei sicuro che ti serva una ricostruzione, scrivi a support@kapsulehost.com spiegando cosa vuoi ottenere, prima di iniziare. Una ricostruzione è una delle poche azioni della piattaforma senza possibilità di ritorno.