Fijar kernel de arranque en Ubuntu VPS
Evite errores al configurar GRUB_DEFAULT en Ubuntu. Aprenda a listar las entradas reales de su menu y fijar el kernel correcto sin perder acceso a su servidor por SSH.
Qué determina qué kernel arranca su VPS
Qué kernel arrancará su VPS en el siguiente inicio lo decide un archivo generado, /boot/grub/grub.cfg. Nunca edite ese archivo directamente. Edite sus archivos de entrada y vuelva a generarlo. En una imagen de nube de Ubuntu, algunas de esas entradas provienen del proveedor de la imagen y el menú generado tiene una estructura distinta a la que asumen la mayoría de las guías. Por eso, GRUB_DEFAULT=1 seguido de update-grub no devuelve el kernel anterior: en Ubuntu, el índice 1 es un submenú, no un kernel antiguo.
Proceda en este orden. Confirme que usted tiene el control sobre la elección del kernel. Lea todos los archivos de entrada, incluidos los añadidos por el proveedor. Lea la salida generada y cuente las entradas que contiene realmente. Solo entonces elija un método de fijación. Si se equivoca en una máquina a la que solo accede por SSH, necesitará una consola de rescate; por ello, las respuestas más seguras se encuentran al final de esta página y suelen ser las correctas.
Primero compruebe que el kernel es suyo y se puede fijar
uname -r
systemd-detect-virt
ls -1 /boot/vmlinuz-*systemd-detect-virt al mostrar kvm, qemu o xen significa que ejecuta su propio kernel y que todo lo siguiente se aplica. Al mostrar lxc o openvz, el servidor comparte el kernel del host, por lo que no tiene un bootloader propio ni nada que fijar. En ese caso, uname -r informa de una versión que no aparece en absoluto en /boot/vmlinuz-*, porque el kernel en ejecución pertenece al host y ninguna configuración del disco puede cambiarlo.
ls -1 /boot/vmlinuz-* es la lista real de kernels que puede elegir. Si contiene una sola línea, el kernel anterior ya se ha eliminado y ninguna configuración del bootloader puede recuperarlo. Esto suele ocurrir durante un autoremove. Conviene entenderlo antes de eliminar kernels antiguos en Ubuntu en un sistema importante.
El archivo que edita no es el archivo que lee GRUB
/etc/default/grub contiene asignaciones simples de variables de shell. Es una entrada. /boot/grub/grub.cfg es la salida, y comienza con # DO NOT EDIT THIS FILE y el motivo. Todo lo que escriba en la salida desaparece la próxima vez que se instale o elimine un paquete del kernel, porque los scripts de esos paquetes la regeneran.
cat /usr/sbin/update-grubupdate-grub es un contenedor. Ejecuta grub-mkconfig -o /boot/grub/grub.cfg, que lee las variables, ejecuta todos los scripts de /etc/grub.d/ y escribe el resultado. Son dos comandos en una sola dirección: las entradas entran y grub.cfg sale.
Qué sobrescribe la configuración: /etc/default/grub.d
grep -rn '^[^#]' /etc/default/grub /etc/default/grub.d/La segunda ruta es la parte que suele pasarse por alto. grub-mkconfig obtiene primero el contenido de /etc/default/grub y, después, el de todos los archivos *.cfg de /etc/default/grub.d/ en el orden de expansión glob. Consulte el código que lo hace:
grep -n 'default/grub' /usr/sbin/grub-mkconfigLa carga del archivo es una operación normal de shell, por lo que prevalece la última asignación. Las imágenes cloud de Ubuntu incluyen archivos en ese directorio y establecen valores como el tiempo de espera y la línea de comandos del kernel después de que ya se haya leído su archivo. Su GRUB_TIMEOUT=10 en /etc/default/grub se sobrescribe un momento después con un archivo del proveedor que lo establece en 0. El comando grep anterior muestra las asignaciones exactas de su imagen, así que consulte esas asignaciones en lugar de confiar en esta explicación.
La regla práctica es la siguiente: coloque su propia configuración en un archivo que se ordene al final, como /etc/default/grub.d/99-local.cfg, en lugar de editar /etc/default/grub. Así, ningún archivo incluido en la imagen podrá cargarse después.
Qué cambia GRUB_FORCE_PARTUUID y qué no
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 cambia el contenido de cada entrada de arranque. El generador escribe root=PARTUUID=... directamente en la línea de comandos del kernel, añade una línea set partuuid= e intenta arrancar primero sin initrd, recurriendo al arranque con este si el intento falla. La compilación de la imagen lo escribe en /etc/default/grub.d/40-force-partuuid.cfg bajo el comentario Force boot without an initramfs by setting GRUB_FORCE_PARTUUID; a fecha de 2026-10-27, los scripts de compilación de imágenes de Ubuntu solo hacen esto para imágenes minimizadas y para imágenes compiladas con un kernel de reemplazo, por lo que en una imagen estándar el primer grep podría no devolver nada. El segundo grep le muestra el código que actúa sobre la variable, en /etc/grub.d/10_linux. Ese script se encuentra en su propio disco y es la autoridad sobre lo que hace su imagen.
Lo que no cambia es cuántas entradas obtiene. El bucle en 10_linux que recorre los kernels instalados, for linux in ${reverse_sorted_list}, no tiene ninguna comprobación propia para la variable. La comprobación reside en la función linux_entry, que el bucle llama una vez por cada entrada que escribe, por lo que la variable da forma a lo que contiene cada entrada pero nunca decide si se escribe una entrada. La estructura del menú depende de GRUB_DISABLE_SUBMENU y GRUB_DISABLE_RECOVERY, que los archivos de imagen en la nube no definen. Cuente lo que tiene.
sudo grep -cE '^\s*(menuentry|submenu) ' /boot/grub/grub.cfg
sudo grep -nE '^\s*(menuentry|submenu) ' /boot/grub/grub.cfgIncluso con un solo kernel instalado, el 10_linux de Ubuntu escribe una entrada de nivel superior para el kernel más reciente, con un identificador que comienza por gnulinux-simple-, seguido de un submenu 'Advanced options for Ubuntu' que contiene una entrada advanced y una entrada recovery para cada kernel, empezando por el más reciente. Por lo tanto, el recuento es de al menos 4 con un kernel, y cada kernel adicional añade dos líneas más dentro del submenú. El índice 0 es el kernel más reciente. El índice 1 es el submenú en sí, por lo que GRUB_DEFAULT=1 nunca nombra un kernel antiguo. La entrada normal del kernel anterior se encuentra dentro del submenú, en 1>2 cuando hay entradas de recuperación presentes. Si un valor que usted establece no nombra ninguna entrada, GRUB recurre a la primera entrada, que es el nuevo kernel que intentaba evitar. En cualquier caso, la solución es nombrar la entrada que desea mediante su identificador, lo cual cubren las siguientes secciones. No hay nada que reconstruir.
Mover el archivo del proveedor no añade entradas, así que no lo haga por esa razón. Cambia cada entrada de la ruta PARTUUID sin initrd de vuelta a un arranque initrd ordinario, lo cual es un cambio independiente en cómo la imagen de su proveedor encuentra su sistema de archivos raíz. Si desea ver qué produciría un cambio en las entradas antes de aplicarlo, grub-mkconfig sin -o escribe en la salida estándar y no modifica nada en el disco.
sudo grub-mkconfig 2>/dev/null | grep -nE '^\s*(menuentry|submenu) 'Compare eso con el mismo grep en /boot/grub/grub.cfg. Aún no se ha escrito nada. Tome una instantánea antes de ejecutar update-grub de forma definitiva.
Si su único objetivo es sobrevivir a un kernel defectuoso, deténgase aquí y utilice las opciones más seguras que se indican más adelante. Cambiar las entradas del cargador de arranque en un servidor remoto para evitar una única actualización supone más riesgo de lo que vale el problema.
Por qué los números de entrada son una mala referencia para fijar configuraciones
GRUB_DEFAULT acepta un número, un título o un identificador. Los números cuentan las entradas de nivel superior empezando desde 0. Una entrada anidada utiliza > como separador, por lo que GRUB_DEFAULT="1>2" significa la entrada en el índice 2 dentro del submenú en el índice 1.
Los índices cambian. 10_linux lista los kernels del más reciente al más antiguo y asigna a cada uno dos entradas dentro del submenú: una normal y una de recuperación. Por tanto, instalar un kernel desplaza cada entrada del submenú anterior dos posiciones hacia abajo, y eliminar un kernel las desplaza dos posiciones hacia arriba. Su configuración 1>2, aunque sea precisa, se resuelve después de ese cambio. Ahora apunta a un kernel diferente, y el que usted pretendía ha pasado a 1>4. En el nivel superior no hay desplazamientos: 0 sigue siendo el kernel más reciente y 1 sigue siendo el submenú. No se producen errores ni advertencias, y usted se entera del cambio tras reiniciar.
Los identificadores dentro del submenú no se mueven, ya que cada uno contiene la versión del kernel, con el formato gnulinux-<version>-advanced-<id> o gnulinux-<version>-recovery-<id>. El identificador de nivel superior gnulinux-simple- es la excepción. No contiene ninguna versión, por lo que siempre se resuelve en el kernel más reciente; fijarlo haría que siguiera silenciosamente al siguiente kernel que instale. Lea el suyo:
sudo awk -F"'" '/menuentry_id_option/ {print $2, "==>", $4}' /boot/grub/grub.cfgIgnore las primeras líneas de la salida, que corresponden a la variable definida en la cabecera. A partir de ahí, el lado izquierdo es el título que ve el usuario y el lado derecho es el identificador que debe pasar a las herramientas. Para una entrada dentro de un submenú, combine el identificador del submenú y el identificador de la entrada con >, en ese orden, exactamente igual que en el formato numérico.
Arrancar el kernel anterior una vez con grub-reboot
Una selección de una sola vez es la opción correcta en un servidor remoto, ya que se revierte automáticamente. grub-reboot escribe next_entry en /boot/grub/grubenv. GRUB lee esa variable, la limpia y guarda el valor limpio antes de arrancar nada, por lo que un kernel que causa un kernel panic no se reintenta en el siguiente arranque. Usted obtiene un intento y luego la máquina vuelve a su valor predeterminado por sí misma.
Primero confirme que su configuración generada lee esa variable:
sudo grep -n -B2 -A5 'next_entry' /boot/grub/grub.cfgUsted busca una línea load_env y un bloque que defina default a partir de next_entry. El /etc/grub.d/00_header de Ubuntu escribe ese bloque en cada configuración que genera update-grub, independientemente de si GRUB_FORCE_PARTUUID está definido, y al arrancar carga grubenv solo cuando ese archivo existe y no está vacío. Si el comando grep no devuelve nada, el grub.cfg en el disco no fue producido por update-grub, ya sea porque alguien lo editó manualmente o porque otra herramienta lo escribió; por lo tanto, grub-reboot será aceptado en la shell pero ignorado por el gestor de arranque. Regenérelo con sudo update-grub y ejecute el grep de nuevo.
sudo grub-reboot '<the identifier you copied>'
sudo grub-editenv listgrub-editenv list debería mostrar ahora una línea next_entry= que contenga exactamente lo que usted indicó. Abra la consola de su proveedor en una pestaña del navegador, reinicie y compruebe el resultado.
sudo rebootuname -rQue uname -r reporte la versión anterior significa que el anclaje funcionó. Si reporta la versión nueva, significa que el identificador no se resolvió o que grubenv no se está leyendo; en cualquier caso, la máquina está operativa, que es el objetivo de usar la forma de un solo intento.
Haz que la elección persista con GRUB_DEFAULT=saved
GRUB_DEFAULT=saved hace que el valor predeterminado proceda de saved_entry en grubenv, y ese valor se establece con grub-set-default. Se conserva durante las instalaciones del kernel, porque update-grub vuelve a escribir grub.cfg y nunca modifica 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.cfgEl último comando debe mostrar set default="${saved_entry}". Si muestra set default="0", algo cargado después de su archivo volvió a establecer GRUB_DEFAULT como un valor literal. Por tanto, vuelva a enumerar /etc/default/grub.d/ y compruebe que 99-local.cfg quede realmente en último lugar.
GRUB_SAVEDEFAULT=true es una configuración diferente y es fácil confundirla con esta. Guarda lo que acaba de arrancar como el nuevo valor predeterminado, de modo que este sigue el último arranque correcto. En un servidor, un reinicio desatendido puede cambiar silenciosamente la selección fijada. Déjela desactivada salvo que ese sea el comportamiento que necesita.
Una selección fijada por identificador todavía puede fallar de una forma. Si elimina el kernel al que hace referencia, el identificador deja de resolverse y el sistema vuelve a la primera entrada. Por tanto, mantenga también el paquete o impida que ese kernel se elimine mediante autoremove.
Cómo mostrar el menú en la consola del proveedor
La selección interactiva requiere que el menú aparezca en pantalla, pero las imágenes de cloud lo ocultan. Añada estas líneas al archivo que se ordena en último lugar y ejecute sudo update-grub.
GRUB_TIMEOUT=10
GRUB_TIMEOUT_STYLE=menu
GRUB_RECORDFAIL_TIMEOUT=10GRUB_TIMEOUT_STYLE=hidden junto con GRUB_TIMEOUT=0 no muestra nada, por lo que quien observe la consola ve que los mensajes del kernel empiezan de inmediato y concluye que se omitió el cargador de arranque. GRUB_RECORDFAIL_TIMEOUT es el tiempo de espera independiente que se usa después de un arranque que no se completó. Las imágenes de cloud también lo establecen en 0. Por eso, un servidor cuyo arranque acaba de fallar tampoco se detiene ni espera su intervención.
Si el proveedor ofrece una consola serie en lugar de una consola gráfica y sigue sin ver nada, GRUB está escribiendo en un terminal que no puede ver. Añada ambas líneas juntas, porque la primera selecciona las salidas y la segunda configura el puerto:
GRUB_TERMINAL="console serial"
GRUB_SERIAL_COMMAND="serial --speed=115200 --unit=0 --word=8 --parity=no --stop=1"A partir de ahora, se añaden diez segundos a cada arranque. Vuelva a establecer el tiempo de espera en 0 cuando termine.
Opciones más seguras que editar el gestor de arranque
Cambiar la configuración del gestor de arranque en una máquina a la que solo accede por SSH es la opción de mayor riesgo en esta página. Existen soluciones más económicas que suelen resolver el problema real.
Retenga los paquetes del kernel. Si el objetivo es "no me entregues un kernel más nuevo", indíquelo al gestor de paquetes en lugar de al gestor de arranque.
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 showholdUtilice los nombres que imprimió el primer comando, ya que las imágenes en la nube suelen instalar la variante virtual o kvm en lugar de generic. Si el kernel más nuevo apareció durante una actualización de la imagen y sospecha que la versión cambió por debajo, no fue así, porque una versión de mantenimiento son las actualizaciones que ya tiene integradas en nuevos medios de instalación y no ofrece a un servidor ya parcheado nada que no se le haya ofrecido semanas antes. Un paquete retenido es omitido por apt upgrade. Antes de apt 3.0, como en la serie 2.8 en Ubuntu 24.04, anuncia la omisión con The following packages have been kept back:. A partir de apt 3.0, que incluye el apt 3.2.0 que trae Ubuntu 26.04, apt upgrade enumera los mismos paquetes bajo Not upgrading:, y solo apt-get upgrade sigue imprimiendo el encabezado antiguo. Un paquete retenido también es omitido por las actualizaciones desatendidas en Ubuntu. El coste es real: un kernel retenido deja de recibir correcciones de seguridad, así que trátelo como una pausa con fecha de caducidad y libérelo con sudo apt-mark unhold. Si evita las actualizaciones del kernel porque los reinicios implican tiempo de inactividad, en lugar de porque un kernel sea defectuoso, la aplicación de parches al kernel en vivo en un VPS resuelve eso.
Realice una instantánea antes de la actualización. Una instantánea restaura el sistema en minutos, sin necesidad de escribir en la consola y sin riesgo de un cambio en el gestor de arranque aplicado a medias. Realice la instantánea, actualice, reinicie y verifique. Si el nuevo kernel funciona mal, revierta el estado y la ruta de arranque será exactamente la misma que antes.
Utilice la consola o una imagen de rescate para un equipo que ya no arranca. Una vez que el servidor no arranca, la configuración del gestor de arranque no es donde se soluciona; esa ruta de recuperación tiene su propio procedimiento: qué hacer cuando un VPS no arranca tras una actualización del kernel.
Qué falla y el mensaje que verá
Su edición en /boot/grub/grub.cfg desapareció. Se instaló o eliminó un paquete del kernel, su script de mantenimiento ejecutó update-grub y el archivo se regeneró a partir de las entradas. La cabecera # DO NOT EDIT THIS FILE indica las dos ubicaciones de entrada. Edítelas.
grub-editenv: error: environment block too small. /boot/grub/grubenv falta o está truncado. Recreelo con sudo grub-editenv /boot/grub/grubenv create, luego establezca su valor de nuevo y confirme con sudo grub-editenv list.
Un kernel fijado (pinned) causa un kernel panic con VFS: Unable to mount root fs on unknown-block(0,0). La entrada que fijó apunta a un kernel o initrd que ya no está en el disco, generalmente porque el paquete se eliminó mientras el identificador permaneció en grubenv. La recuperación consiste en arrancar desde la consola con una entrada funcional y luego borrar el valor obsoleto.
uname -r no cambia tras un reinicio en el que esperaba cambios. Compruebe tres cosas en orden: ¿grub-editenv list sigue mostrando su valor o fue consumido?; ¿el identificador que estableció aparece en el grub.cfg actual?; ¿grub.cfg contiene una línea set default que lea la variable que estableció? Una de esas tres razones lo explica siempre.
El menú apareció por sí solo tras un fallo. GRUB registra un arranque que no se completó en grubenv como recordfail=1 y, en el siguiente arranque, reemplaza el tiempo de espera normal con GRUB_RECORDFAIL_TIMEOUT. Una imagen de nube estándar establece ese valor en 0, lo que arranca directamente sin mostrar el menú; por lo tanto, el menú solo espera por usted después de un fallo cuando ese tiempo de espera es superior a 0, por ejemplo, porque estableció GRUB_RECORDFAIL_TIMEOUT=10 como se indica en la sección de consola anterior. Límpielo con sudo grub-editenv /boot/grub/grubenv unset recordfail una vez que la máquina esté en buen estado.
La única frase que vale la pena recordar: el archivo que usted edita no es el archivo que GRUB lee, y en una imagen de nube la brecha entre ambos es donde reside la confusión. Lea primero la configuración generada. Cada decisión en esta página se deriva de lo que dice realmente.
FAQ
¿Por qué GRUB_DEFAULT=1 no cambia el kernel con el que arranca mi VPS?
Porque en Ubuntu, el índice 1 no es un kernel anterior. 10_linux escribe el kernel más reciente como entrada 0 y un submenú Advanced options for Ubuntu como entrada 1, incluso cuando solo hay un kernel instalado, y las entradas normal y de recuperación de cada kernel residen dentro de ese submenú. Nada en una imagen de nube de Ubuntu sobrescribe GRUB_DEFAULT por sí mismo: 00_header escribe su valor en grub.cfg, lo cual puede verificar con sudo grep -n 'set default' /boot/grub/grub.cfg. Liste las entradas reales con sudo grep -nE '^\s*(menuentry|submenu) ' /boot/grub/grub.cfg y luego fije el valor mediante el identificador, uniendo los identificadores del submenú y de la entrada con >. GRUB_FORCE_PARTUUID, si su imagen lo establece, solo cambia cómo cada entrada encuentra su sistema de archivos raíz, no cuántas entradas existen.
¿Cómo arranco el kernel anterior una sola vez?
Ejecute sudo grub-reboot '<identifier>' con un identificador copiado de su propio grub.cfg y luego reinicie con la consola del proveedor ya abierta. GRUB borra next_entry antes de arrancar, por lo que la elección se aplica exactamente a un intento y un kernel que causa un kernel panic no se reintenta. Confirme que el valor se aplicó con sudo grub-editenv list. Antes de depender de esto, ejecute sudo grep -n next_entry /boot/grub/grub.cfg, ya que una configuración que no fue generada por update-grub podría no cargar nunca grubenv e ignorará el comando sin mostrar error.
¿Debo fijar el valor por número de entrada o por identificador?
Por identificador. Los números de entrada son posiciones en una lista que 10_linux reconstruye poniendo lo más reciente primero, con dos entradas por kernel dentro del submenú, por lo que instalar o eliminar cualquier kernel desplaza cada entrada del submenú en dos posiciones, y un 1>2 obsoleto aún se resuelve en una entrada real pero incorrecta sin imprimir ninguna advertencia. Los identificadores de las entradas dentro del submenú contienen la versión del kernel, por lo que coinciden con el kernel que usted pretendía o fallan al resolverse. Omita el identificador de nivel superior gnulinux-simple-, que no contiene versión y siempre sigue al kernel más reciente. Lístelos con sudo grep -n menuentry_id_option /boot/grub/grub.cfg y copie la cadena entre comillas que aparece en cada línea de entrada.
¿Es más seguro retener el paquete del kernel que cambiar el gestor de arranque?
Para el objetivo habitual, sí. sudo apt-mark hold linux-image-virtual linux-headers-virtual impide que llegue un kernel más nuevo, por lo que la ruta de arranque nunca cambia y no hay nada que pueda salir mal desde una consola a la que quizás no tenga acceso. Compruebe primero los nombres de las variantes instaladas en su equipo con apt list --installed y verifique la retención con apt-mark showhold. El inconveniente es que un kernel retenido no recibe parches de seguridad, así que decida cuándo ejecutará sudo apt-mark unhold antes de aplicar la retención.