Come impostare il kernel di avvio su VPS Ubuntu
Impostare GRUB_DEFAULT=1 su Ubuntu spesso punta a un sottomenu invece che al kernel. Scopri come leggere correttamente il file grub.cfg e bloccare il kernel desiderato.
Cosa determina quale kernel avvia la tua VPS
Il kernel che la tua VPS avvierà al prossimo riavvio è determinato da un file generato, /boot/grub/grub.cfg. Non modificare mai direttamente questo file. Modifica invece i suoi file di input e rigeneralo. Nelle immagini cloud di Ubuntu, alcuni di questi input provengono dal fornitore dell'immagine e il menu generato ha una struttura diversa da quella ipotizzata dalla maggior parte delle guide; ecco perché GRUB_DEFAULT=1 seguito da update-grub non ripristina il kernel precedente: su Ubuntu, l'indice 1 è un sottomenu, non un kernel meno recente.
Procedi in questo ordine. Conferma che la scelta del kernel sia sotto il tuo controllo. Leggi ogni file di input, inclusi quelli aggiunti dal fornitore. Leggi l'output generato e conta le voci che contiene effettivamente. Solo allora scegli un metodo di pinning. Sbagliare questa procedura su una macchina raggiungibile solo tramite SSH comporta la necessità di utilizzare una console di ripristino, pertanto le soluzioni più sicure si trovano alla fine di questa pagina e spesso sono quelle corrette.
Verifica innanzitutto di poter selezionare il tuo kernel
uname -r
systemd-detect-virt
ls -1 /boot/vmlinuz-*systemd-detect-virt che restituisce kvm, qemu o xen indica che usi un kernel gestito da te e che tutto ciò che segue è applicabile. lxc o openvz indica invece che il server condivide il kernel dell'host. In questo caso non hai un bootloader gestito da te e non c'è nulla da selezionare. uname -r mostra una versione che non compare affatto in /boot/vmlinuz-*, perché il kernel in esecuzione appartiene all'host e nessuna impostazione presente sul disco può modificarlo.
ls -1 /boot/vmlinuz-* contiene l'elenco effettivo dei kernel tra cui puoi scegliere. Se contiene una sola riga, il kernel precedente è già stato eliminato e nessuna impostazione del bootloader può ripristinarlo. Di solito accade durante un'operazione di autoremove. È utile comprenderne il funzionamento prima di eliminare i kernel obsoleti su Ubuntu da un server importante.
Il file che modifichi non è il file letto da GRUB
/etc/default/grub contiene semplici assegnazioni di variabili della shell. È un file di input. /boot/grub/grub.cfg è l’output e inizia con # DO NOT EDIT THIS FILE e la motivazione. Qualsiasi modifica apportata all’output viene persa alla successiva installazione o rimozione di un pacchetto del kernel, perché gli script del pacchetto lo rigenerano.
cat /usr/sbin/update-grubupdate-grub è un wrapper. Esegue grub-mkconfig -o /boot/grub/grub.cfg, che legge le variabili, esegue ogni script in /etc/grub.d/ e scrive il risultato. Due comandi, una sola direzione: i dati di input entrano e grub.cfg viene prodotto.
Cosa sovrascrive la configurazione: /etc/default/grub.d
grep -rn '^[^#]' /etc/default/grub /etc/default/grub.d/Il secondo percorso è quello che spesso viene trascurato. grub-mkconfig esegue prima il source di /etc/default/grub, quindi carica ogni file *.cfg presente in /etc/default/grub.d/ in ordine glob. Leggi il codice che esegue questa operazione:
grep -n 'default/grub' /usr/sbin/grub-mkconfigIl caricamento dei file usa la normale sintassi della shell, quindi prevale l'ultima assegnazione. Le immagini cloud Ubuntu includono file in quella directory e impostano valori come il timeout e la riga di comando del kernel dopo che il tuo file è già stato letto. La tua assegnazione GRUB_TIMEOUT=10 in /etc/default/grub viene sovrascritta poco dopo da un file del fornitore che la imposta su 0. Il comando grep precedente stampa le assegnazioni esatte presenti nella tua immagine. Usa quindi quei valori invece di fare affidamento su questa spiegazione.
La regola pratica è la seguente: inserisci le tue impostazioni in un file che venga ordinato per ultimo, ad esempio /etc/default/grub.d/99-local.cfg, invece di modificare /etc/default/grub. In questo modo nessun file fornito con l'immagine può essere caricato dopo il tuo.
Cosa modifica GRUB_FORCE_PARTUUID e cosa non modifica
grep -rn GRUB_FORCE_PARTUUID /etc/default/grub /etc/default/grub.d/
grep -n GRUB_FORCE_PARTUUID /etc/grub.d/10_linux
sudo grep -n 'root=PARTUUID' /boot/grub/grub.cfgGRUB_FORCE_PARTUUID modifica il contenuto di ogni voce di boot. Il generatore scrive root=PARTUUID=... direttamente nella riga di comando del kernel, aggiunge una riga set partuuid= e prova prima ad avviare il sistema senza initrd; se il tentativo fallisce, ripiega sull'avvio con initrd. La generazione dell'immagine scrive il valore in /etc/default/grub.d/40-force-partuuid.cfg, sotto il commento Force boot without an initramfs by setting GRUB_FORCE_PARTUUID, e, al 2026-10-27, gli script di generazione delle immagini di Ubuntu lo fanno soltanto per le immagini minimizzate e per quelle create con un kernel sostitutivo; quindi, su un'immagine standard, il primo grep potrebbe non stampare nulla. Il secondo grep mostra il codice che agisce sulla variabile, in /etc/grub.d/10_linux. Questo script si trova sul disco locale ed è l'autorità per stabilire il comportamento della propria immagine.
Non modifica invece il numero di voci presenti. Il ciclo in 10_linux che attraversa i kernel installati, for linux in ${reverse_sorted_list}, non contiene un controllo autonomo della variabile. Il controllo si trova nella funzione linux_entry, che il ciclo richiama una volta per ogni voce scritta; la variabile determina quindi il contenuto di ogni voce, ma non decide se una voce viene scritta. La struttura del menu dipende da GRUB_DISABLE_SUBMENU e GRUB_DISABLE_RECOVERY, che i file delle cloud image non impostano. Verificare il numero effettivo di voci.
sudo grep -cE '^\s*(menuentry|submenu) ' /boot/grub/grub.cfg
sudo grep -nE '^\s*(menuentry|submenu) ' /boot/grub/grub.cfgAnche con un solo kernel installato, 10_linux di Ubuntu scrive una voce di livello superiore per il kernel più recente, con un identificatore che inizia con gnulinux-simple-, seguita da un submenu 'Advanced options for Ubuntu' che contiene una voce advanced e una voce recovery per ogni kernel, dal più recente al meno recente. Il conteggio è quindi almeno 4 con un solo kernel, e ogni kernel aggiuntivo aggiunge altre due righe all'interno del sottomenu. L'indice 0 corrisponde al kernel più recente. L'indice 1 corrisponde al sottomenu, quindi GRUB_DEFAULT=1 non identifica mai un kernel meno recente. La voce normale del kernel precedente si trova all'interno del sottomenu, in 1>2 quando sono presenti le voci di ripristino. Se un valore impostato non identifica alcuna voce, GRUB ripiega sulla prima voce, cioè il nuovo kernel che si voleva evitare. In entrambi i casi, la soluzione consiste nell'indicare la voce corretta tramite identificatore, come descritto nelle sezioni successive. Non è necessario ricostruire nulla.
Spostare il file del vendor non aggiunge voci, quindi non farlo per questo motivo. Questa operazione riporta ogni voce dal percorso PARTUUID senza initrd al normale avvio con initrd, modificando separatamente il modo in cui l'immagine del provider individua il filesystem root. Per vedere quale risultato produrrebbe una modifica agli input prima che venga applicata, grub-mkconfig senza -o scrive sull'output standard e non modifica nulla sul disco.
sudo grub-mkconfig 2>/dev/null | grep -nE '^\s*(menuentry|submenu) 'Confrontare questo risultato con lo stesso grep eseguito su /boot/grub/grub.cfg. Non è ancora stato scritto nulla. Creare uno snapshot prima di eseguire realmente update-grub.
Se l'unico obiettivo è superare un problema con un kernel, fermarsi qui e usare le opzioni più sicure riportate sotto. Modificare gli input del bootloader su un server remoto per superare un singolo aggiornamento comporta un rischio superiore al beneficio.
Perché i numeri di indice sono il metodo errato per bloccare le voci
GRUB_DEFAULT accetta un numero, un titolo o un identificativo. I numeri contano le voci di primo livello partendo da 0. Una voce annidata utilizza > come separatore, quindi GRUB_DEFAULT="1>2" indica la voce all'indice 2 all'interno del sottomenu all'indice 1.
Gli indici cambiano. 10_linux elenca i kernel dal più recente e assegna a ciascuno due voci all'interno del sottomenu, una normale e una di ripristino; pertanto, l'installazione di un kernel sposta ogni voce di sottomenu precedente verso il basso di due posizioni, mentre la rimozione di un kernel le sposta verso l'alto di due. Il tuo accurato 1>2 viene comunque risolto dopo tale operazione. Ora punta a un kernel diverso, mentre quello desiderato si è spostato in 1>4. Al primo livello non cambia nulla: 0 rimane sempre il kernel più recente e 1 rimane il sottomenu. Non vengono generati errori o avvisi e te ne accorgi solo dopo un riavvio.
Gli identificativi all'interno del sottomenu non cambiano, poiché ognuno contiene la versione del kernel, nel formato gnulinux-<version>-advanced-<id> o gnulinux-<version>-recovery-<id>. L'identificativo di primo livello gnulinux-simple- rappresenta l'eccezione. Non contiene alcuna versione, quindi punta sempre al kernel più recente; bloccarlo significherebbe seguire silenziosamente ogni nuovo kernel installato. Leggi il tuo:
sudo awk -F"'" '/menuentry_id_option/ {print $2, "==>", $4}' /boot/grub/grub.cfgIgnora le prime righe dell'output, che definiscono la variabile nell'header. Successivamente, il lato sinistro mostra il titolo visualizzato dall'utente, mentre il lato destro mostra l'identificativo da passare agli strumenti. Per una voce all'interno di un sottomenu, unisci l'identificativo del sottomenu e quello della voce con >, in questo ordine, esattamente come avviene per il formato numerico.
Avviare il kernel precedente una sola volta con grub-reboot
Una selezione valida per un solo avvio è la scelta corretta su un server remoto, poiché si annulla automaticamente. grub-reboot scrive next_entry all'interno di /boot/grub/grubenv. GRUB legge tale variabile, la azzera e salva il valore azzerato prima di avviare qualsiasi cosa; in questo modo, un kernel che causa un kernel panic non viene riprovato al riavvio successivo. Si ha a disposizione un solo tentativo, dopodiché la macchina torna autonomamente alla configurazione predefinita.
Per prima cosa, verificare che la configurazione generata legga effettivamente tale variabile:
sudo grep -n -B2 -A5 'next_entry' /boot/grub/grub.cfgÈ necessaria una riga load_env e un blocco che imposti default a partire da next_entry. Il file /etc/grub.d/00_header di Ubuntu scrive tale blocco in ogni configurazione generata da update-grub, indipendentemente dal fatto che GRUB_FORCE_PARTUUID sia impostato; all'avvio, il sistema carica grubenv solo se il file esiste e non è vuoto. Se il comando grep non restituisce nulla, il file grub.cfg sul disco non è stato prodotto da update-grub, probabilmente perché è stato modificato manualmente o da un altro strumento; di conseguenza, grub-reboot verrà accettato dalla shell ma ignorato dal bootloader. Rigenerarlo con sudo update-grub ed eseguire nuovamente il grep.
sudo grub-reboot '<the identifier you copied>'
sudo grub-editenv listgrub-editenv list dovrebbe ora restituire una riga next_entry= contenente esattamente quanto specificato. Aprire la console del proprio provider in una scheda del browser, quindi riavviare e verificare il risultato.
sudo rebootuname -rSe uname -r riporta la versione precedente, significa che il blocco ha funzionato. Se riporta la nuova versione, significa che l'identificativo non è stato risolto o che grubenv non viene letto; in entrambi i casi la macchina è operativa, che è lo scopo dell'utilizzo della modalità "one shot".
Rendere persistente la scelta con GRUB_DEFAULT=saved
GRUB_DEFAULT=saved fa derivare il valore predefinito da saved_entry in grubenv, e si imposta quel valore con grub-set-default. La configurazione resta valida dopo l’installazione dei kernel, perché update-grub riscrive grub.cfg e non modifica mai grubenv.
echo 'GRUB_DEFAULT=saved' | sudo tee /etc/default/grub.d/99-local.cfg
sudo update-grub
sudo grub-set-default '<the identifier you copied>'
sudo grub-editenv list
sudo grep -n 'set default' /boot/grub/grub.cfgL’ultimo comando deve stampare set default="${saved_entry}". Se stampa set default="0", significa che qualcosa ha eseguito il source dopo il tuo file e ha reimpostato GRUB_DEFAULT su un valore letterale. Elenca quindi di nuovo /etc/default/grub.d/ e verifica che 99-local.cfg venga ordinato effettivamente per ultimo.
GRUB_SAVEDEFAULT=true è un’impostazione diversa e può essere confusa facilmente con questa. Salva come nuovo valore predefinito la voce appena utilizzata per l’avvio, quindi il valore predefinito segue l’ultimo avvio riuscito. Su un server, un riavvio non presidiato può quindi modificare silenziosamente il kernel fissato. Lascialo disattivato, salvo che sia esattamente il comportamento desiderato.
Un pin basato sull’identificatore può comunque fallire in un caso. Se rimuovi il kernel indicato, l’identificatore non viene più risolto e il sistema torna alla prima voce. Mantieni quindi anche il pacchetto oppure escludi quel kernel da autoremove.
Visualizzare il menu nella console del provider
La selezione interattiva richiede che il menu sia visualizzato, ma le immagini cloud lo nascondono. Inserire queste righe nel file che viene elaborato per ultimo, quindi eseguire sudo update-grub.
GRUB_TIMEOUT=10
GRUB_TIMEOUT_STYLE=menu
GRUB_RECORDFAIL_TIMEOUT=10GRUB_TIMEOUT_STYLE=hidden insieme a GRUB_TIMEOUT=0 non visualizza nulla. Chi osserva la console vede quindi comparire immediatamente i messaggi del kernel e conclude che il bootloader sia stato ignorato. GRUB_RECORDFAIL_TIMEOUT è il timeout separato utilizzato dopo un avvio non completato. Anche questo valore è impostato su 0 nelle immagini cloud. Per questo motivo, un server il cui avvio è appena fallito non si arresta comunque in attesa di un intervento.
Se il provider offre una console seriale invece di una console grafica e non viene visualizzato nulla, GRUB sta scrivendo su un terminale che non è possibile vedere. Aggiungere entrambe le righe, perché la prima seleziona gli output e la seconda configura la porta:
GRUB_TERMINAL="console serial"
GRUB_SERIAL_COMMAND="serial --speed=115200 --unit=0 --word=8 --parity=no --stop=1"Da questo momento, ogni avvio avrà dieci secondi di attesa aggiuntiva. Al termine, riportare il timeout a 0.
Opzioni più sicure rispetto alla modifica del bootloader
Modificare i parametri del bootloader su una macchina raggiungibile solo tramite SSH è l'operazione più rischiosa descritta in questa pagina. Esistono soluzioni meno drastiche che solitamente risolvono il problema alla radice.
Bloccare i pacchetti del kernel. Se l'obiettivo è "non installare un kernel più recente", è preferibile comunicarlo al gestore dei pacchetti piuttosto che al bootloader.
apt list --installed 2>/dev/null | grep -E '^linux-(image|headers|generic|virtual|kvm|aws|azure|gcp|oracle)'
sudo apt-mark hold linux-image-virtual linux-headers-virtual
apt-mark showholdUtilizzare i nomi restituiti dal primo comando, poiché le immagini cloud installano comunemente la variante virtual o kvm anziché generic. Se il nuovo kernel è apparso in seguito a un aggiornamento dell'immagine e si sospetta che la release sia cambiata, non è così: una point release consiste negli aggiornamenti già disponibili integrati nel nuovo supporto di installazione e non propone a un server già aggiornato nulla che non fosse già stato offerto settimane prima. Un pacchetto bloccato viene ignorato da apt upgrade. Prima di apt 3.0, come nella serie 2.8 di Ubuntu 24.04, l'operazione viene segnalata con The following packages have been kept back:. A partire da apt 3.0, che include la versione apt 3.2.0 presente in Ubuntu 26.04, apt upgrade elenca gli stessi pacchetti sotto Not upgrading:, e solo apt-get upgrade continua a stampare l'intestazione precedente. Un pacchetto bloccato viene ignorato anche da unattended upgrades su Ubuntu. Il costo è reale: un kernel bloccato smette di ricevere correzioni di sicurezza; pertanto, è necessario considerarlo come una pausa temporanea e sbloccarlo con sudo apt-mark unhold. Se si evitano gli aggiornamenti del kernel perché i riavvii comportano tempi di inattività, anziché perché il kernel è difettoso, live kernel patching su una VPS è la soluzione corretta.
Creare uno snapshot prima dell'aggiornamento. Uno snapshot consente il ripristino in pochi minuti, senza digitare comandi da console e senza il rischio di una modifica parziale del bootloader. Snapshot, aggiornamento, riavvio, verifica. Se il nuovo kernel non funziona correttamente, eseguire il rollback: il percorso di avvio tornerà esattamente allo stato precedente.
Utilizzare la console o un'immagine di ripristino per un server già offline. Una volta che il server non si avvia più, la configurazione del bootloader non è il punto in cui intervenire; tale procedura di recupero segue un iter specifico: cosa fare quando una VPS non si avvia dopo un aggiornamento del kernel.
Cosa si rompe e il messaggio che vedrai
La tua modifica a /boot/grub/grub.cfg è scomparsa. È stato installato o rimosso un pacchetto del kernel, il suo script di manutenzione ha eseguito update-grub e il file è stato rigenerato a partire dagli input. L'intestazione # DO NOT EDIT THIS FILE indica le due posizioni di input. Modifica quelle.
grub-editenv: error: environment block too small. /boot/grub/grubenv manca o è troncato. Ricrealo con sudo grub-editenv /boot/grub/grubenv create, quindi imposta nuovamente il tuo valore e conferma con sudo grub-editenv list.
Un kernel bloccato (pinned) va in kernel panic con VFS: Unable to mount root fs on unknown-block(0,0). La voce che hai bloccato punta a un kernel o a un initrd che non si trova più sul disco, solitamente perché il pacchetto è stato rimosso mentre l'identificativo è rimasto in grubenv. Il ripristino consiste nell'avviare da console una voce funzionante e successivamente eliminare il valore obsoleto.
uname -r rimane invariato dopo un riavvio in cui ti aspettavi una modifica. Verifica tre cose in ordine: grub-editenv list mostra ancora il tuo valore o è stato consumato; l'identificativo che hai impostato appare nel grub.cfg corrente; grub.cfg contiene una riga set default che legge la variabile che hai impostato. Una di queste tre spiega sempre il motivo.
Il menu è apparso da solo dopo un crash. GRUB registra un avvio non completato in grubenv come recordfail=1 e, all'avvio successivo, sostituisce il timeout normale con GRUB_RECORDFAIL_TIMEOUT. Un'immagine cloud standard imposta questo valore a 0, che avvia il sistema direttamente senza mostrare il menu; pertanto, il menu attende il tuo intervento dopo un crash solo quando quel timeout è superiore a 0, ad esempio perché hai impostato GRUB_RECORDFAIL_TIMEOUT=10 come indicato nella sezione sulla console qui sopra. Ripristinalo con sudo grub-editenv /boot/grub/grubenv unset recordfail una volta che la macchina è tornata in salute.
L'unica frase che vale la pena ricordare: il file che modifichi non è il file che GRUB legge e, su un'immagine cloud, il divario tra i due è dove risiede la confusione. Leggi prima la configurazione generata. Ogni decisione su questa pagina deriva da ciò che è effettivamente scritto lì.
FAQ
Perché GRUB_DEFAULT=1 non modifica il kernel con cui si avvia la mia VPS?
Perché su Ubuntu, l'indice 1 non corrisponde a un kernel precedente. 10_linux scrive il kernel più recente come voce 0 e un sottomenu Advanced options for Ubuntu come voce 1, anche quando è installato un solo kernel; le voci normali e di ripristino di ogni kernel risiedono all'interno di tale sottomenu. Nulla in un'immagine cloud di Ubuntu sovrascrive GRUB_DEFAULT stesso: 00_header scrive il tuo valore in grub.cfg, che puoi visualizzare con sudo grep -n 'set default' /boot/grub/grub.cfg. Elenca le voci reali con sudo grep -nE '^\s*(menuentry|submenu) ' /boot/grub/grub.cfg, quindi imposta il valore tramite identificativo, unendo gli identificativi del sottomenu e della voce con >. GRUB_FORCE_PARTUUID, se impostato dalla tua immagine, modifica solo il modo in cui ogni voce individua il filesystem root, non il numero di voci presenti.
Come posso avviare il kernel precedente una sola volta?
Esegui sudo grub-reboot '<identifier>' con un identificativo copiato dal tuo grub.cfg, quindi riavvia tenendo già aperta la console del provider. GRUB cancella next_entry prima dell'avvio, quindi la scelta si applica esattamente a un tentativo e un kernel che va in panic non viene riprovato. Conferma che il valore sia stato applicato con sudo grub-editenv list. Prima di fare affidamento su di esso, esegui sudo grep -n next_entry /boot/grub/grub.cfg, poiché una configurazione non generata da update-grub potrebbe non caricare mai grubenv e ignorerà il comando senza restituire errori.
È meglio impostare il valore tramite numero di voce o tramite identificativo?
Tramite identificativo. I numeri di voce sono posizioni in un elenco che 10_linux ricostruisce mettendo per primo il più recente, con due voci per kernel all'interno del sottomenu; pertanto, installare o rimuovere un kernel sposta ogni voce del sottomenu di due posizioni, e un 1>2 obsoleto continuerà a puntare a una voce reale ma errata, senza alcun avviso. Gli identificativi delle voci all'interno del sottomenu contengono la versione del kernel, quindi corrispondono al kernel desiderato o falliscono la risoluzione. Evita l'identificativo di primo livello gnulinux-simple-, che non contiene la versione e segue sempre il kernel più recente. Elencali con sudo grep -n menuentry_id_option /boot/grub/grub.cfg e copia la stringa tra virgolette che segue su ogni riga di voce.
Bloccare il pacchetto del kernel è più sicuro che modificare il bootloader?
Per l'obiettivo comune, sì. sudo apt-mark hold linux-image-virtual linux-headers-virtual impedisce l'arrivo di un kernel più recente, quindi il percorso di avvio non cambia mai e non c'è rischio di errori da una console a cui potresti non avere accesso. Verifica prima i nomi dei flavor installati sulla tua macchina con apt list --installed e conferma il blocco con apt-mark showhold. Il compromesso è che un kernel bloccato non riceve correzioni di sicurezza, quindi decidi quando eseguire sudo apt-mark unhold prima di applicare il blocco.