Si tu teclado no funciona en VirtualBox: guía de causas y soluciones

Cuando de repente el teclado deja de responder dentro de una máquina virtual, la sensación es de bloqueo total: no puedes iniciar sesión, no funciona el ratón y tras insistir un rato, parece que la VM se queda colgada. Este escenario es más común de lo que parece en VirtualBox, especialmente con combinaciones concretas de hardware, SO anfitrión e invitado, y ciertas configuraciones de teclado.

En este artículo vas a encontrar un repaso completo de causas y arreglos reales basados en casos como un Windows 10 host con Oracle VirtualBox 6.1 y un invitado Kali Linux que al primer arranque iba fino pero, tras apagar y volver a encender, ni teclado ni ratón respondían y al poco la VM se congelaba. También veremos el típico quebradero de cabeza con la tecla Ctrl en Debian y el enigma de la barra invertida en teclados alemanes (AltGr+ß) dentro de Linux, además de un problema clásico: el estado de Num Lock desincronizado entre anfitrión e invitado. Vamos a aprender todo sobre si tu teclado no funciona en VirtualBox, estos son los pasos para arreglarlo.

Antes de nada: entender el contexto y los síntomas

Hay varios perfiles de problema recogidos en casos reales: uno de ellos es un host Windows 10 y VirtualBox 6.1.22 r144080 con invitado Kali Linux sin Guest Additions ni Host Extensions. Tras importar la VM y arrancarla, todo ok; pero después del primer apagado, al volver a iniciar, el teclado no escribe, el ratón no se mueve y, tras unos minutos, la máquina virtual se queda frita.

En ese mismo entorno se cambiaron ajustes de RAM y de memoria de vídeo, se tocaron opciones de entrada y se borraron y añadieron filtros USB, sin éxito. AMD‑V estaba activado (si necesitas guía para activar la virtualización en mi pc) y no había rastro de Hyper‑V. En paralelo, había dudas con la tecla Host (la de VirtualBox que sustituye combinaciones como Ctrl+Alt) y con cómo escribir la barra invertida \ en el invitado Kali usando disposición alemana (el usuario intentaba Ctrl+Alt+ß, Host+ß y todo tipo de combinaciones).

En otro frente, usuarios con Debian Squeeze invitado sobre un anfitrión Wheezy reportaron que la tecla Ctrl no hacía su función dentro del invitado: por ejemplo, en nano, al pulsar ^X aparecía una simple «x» en pantalla. Se probaron variantes como usar Ctrl izquierdo o derecho y cambiar la tecla Host a la tecla de logo derecha, con mapas de teclado por defecto en inglés (USA), pero el fallo persistía en determinadas sesiones.

Comprueba lo básico: captura de teclado, host key y conflictos

En VirtualBox existe una opción llamada “Auto capture keyboard”. Si está desactivada, puede que el teclado se quede en el host y las pulsaciones no lleguen al invitado. Ve a Archivo > Preferencias > Entrada y verifica que la captura automática esté activa. También fíjate si el borde de la ventana de la VM indica que el foco está dentro.

La tecla Host (por defecto, Ctrl derecha) es clave. Si la cambiaste a AltGr (Right Alt) o a una tecla que necesitas dentro del invitado (por ejemplo, para escribir «\» en alemán con AltGr+ß), tendrás problemas porque VirtualBox intercepta esa tecla como Host. Evita configurar AltGr como tecla Host; usa la Ctrl derecha o la tecla de logo derecha, y cerciórate de que VirtualBox no secuestra combinaciones que el invitado necesita.

Otra comprobación que parece obvia pero ayuda: prueba el Ctrl izquierdo y el derecho. Hay casos documentados en los que uno de los dos responde y el otro no, por cómo mapea el sistema invitado o por cómo una aplicación concreta (nano, X o consola) está leyendo los eventos del teclado.

Num Lock desincronizado entre anfitrión e invitado

Existe un comportamiento histórico en VirtualBox por el que el estado de Num Lock puede quedar “invertido” entre host e invitado: cuando en el host está activado, en la VM aparece como desactivado, y al revés. Esto provoca que el teclado numérico se comporte como flechas de cursor en un lado mientras que en el otro funciona como números.

La solución es forzar a VirtualBox a no sincronizar los LEDs del teclado con el invitado. En Windows, abre un CMD como administrador, navega a la carpeta de instalación de VirtualBox (normalmente «C:\\Program Files\\Oracle\\VirtualBox») y ejecuta el siguiente comando ajustando el nombre exacto de tu VM:

VBoxManage setextradata "Nombre de la máquina virtual entrecomillado" GUI/HidLedsSync "0"

Al aplicar esto, cuando Num Lock esté encendido en tu equipo anfitrión, también lo estará en el invitado. Es una forma rápida de evitar el baile constante al alternar entre ambos sistemas. Si trabajas mucho con el numpad, te ahorrará demasiados sustos.

La barra invertida en Linux con teclado alemán: AltGr, Ctrl y la Host key

En distribuciones como Kali con distribución alemana, la barra invertida \ suele escribirse con AltGr+ß. En muchos entornos de Linux, Ctrl+Alt se interpreta como equivalente a AltGr, así que también funciona. Pero si en VirtualBox has asignado la tecla Host a AltGr, la combinación no llegará al invitado.

Para solucionarlo, revisa en Archivo > Preferencias > Entrada cuál es tu tecla Host y elige una que no choque con AltGr. El valor por defecto (Ctrl derecha) suele ser el más sensato. Después, dentro del invitado, comprueba la distribución del teclado: en Kali, puedes cambiarla desde la interfaz gráfica o con setxkbmap. Por ejemplo:

setxkbmap de

Si sigues sin poder escribir la barra invertida, prueba con la variante de mapa «German (nodeadkeys)» en las opciones de teclado de tu entorno de escritorio. Evitar teclas muertas ayuda a que AltGr sea directo. Y recuerda: no uses combinaciones con la Host key para escribir; la Host key es para atajos de VirtualBox, no para el invitado.

Cuando Ctrl no funciona en Debian o nano ignora los atajos

Que en nano, al pulsar ^X, salga una «x» en vez de cerrar, sugiere que Ctrl no está siendo detectado como modificador. Puede deberse a un mapa de teclado incorrecto, a una capa de X que no recoge el modificador o a un conflicto con la Host key.

Recomendaciones prácticas basadas en casos reales con Debian Squeeze invitado en Wheezy anfitrión: verifica que el mapa del invitado sea el correcto («us» si tu teclado es USA) con «dpkg-reconfigure keyboard-configuration» o «localectl» en sistemas más nuevos. Cambia la tecla Host a una tecla que no sea Ctrl ni AltGr, por ejemplo, la tecla de logo derecha. Y prueba los atajos tanto en consola pura (TTY) como dentro de X para acotar el problema.

Si sólo falla en una terminal gráfica concreta, intenta con otra (por ejemplo, sustituye la terminal por defecto por xterm o gnome-terminal) para ver si es un tema de captura de atajos. Algunos emuladores interceptan combinaciones y requieren desactivarlas en sus preferencias.

Configuraciones de VirtualBox que afectan a teclado y ratón

En la configuración de la VM, en Sistema > Placa base, revisa el dispositivo apuntador: «PS/2 Mouse», «USB Tablet» o «USB Multi-Touch Tablet». Para muchos invitados Linux, USB Tablet mejora la integración del puntero; si ves congelaciones del ratón, alterna entre esas opciones y verifica.

En Sistema > Procesador, evita activar más aceleraciones que las necesarias si observas cuelgues tras unos minutos. Aunque AMD‑V esté activo, no necesitas tocar anidación o paravirtualización avanzada para que el teclado funcione; céntrate en la parte de Entrada.

En USB, elimina filtros que no uses. Los filtros USB mal configurados pueden capturar un teclado o ratón físico fuera del host, dejándote sin control en Windows mientras la VM intenta “agarrarlo”. Si necesitas USB 2.0/3.0 en el invitado, instala el Extension Pack correspondiente a tu versión exacta de VirtualBox, porque sin él el soporte USB avanzado no funciona bien. Para revisar la configuración de la VM utiliza las opciones de la interfaz de VirtualBox.

Guest Additions y Extension Pack: cuándo marcan la diferencia

No tener instalados ni Guest Additions ni Host Extensions (Extension Pack) no impide que el teclado básico funcione, pero la integración mejora mucho con Guest Additions. Para Kali o Debian, instala los headers del kernel y compila los módulos:

sudo apt update && sudo apt install -y build-essential dkms linux-headers-$(uname -r)
sudo sh /media/<usuario>/VBox_GAs_*/VBoxLinuxAdditions.run

Tras reiniciar, el ratón integrado y la sincronización del portapapeles suelen comportarse mejor. Los Guest Additions no arreglan un Host key mal elegida, pero sí evitan rarezas de entrada y aceleran la capa gráfica que, en algunos casos, provocaba colgados aparentes. Si necesitas instrucciones específicas para actualizar VirtualBox Guest Additions consulta la guía correspondiente.

Sobre el Extension Pack: instálalo en el host sólo si necesitas USB 2.0/3.0, VRDP o PXE para Intel. Empareja exactamente la versión (p. ej., 6.1.22 r144080 con su Extension Pack 6.1.22) para evitar incompatibilidades.

Si tras el primer reinicio todo se rompe: pistas y arreglos

Que una VM funcione en su primer arranque y falle luego suele apuntar a cambios de estado que ocurren durante el apagado: sincronización de LEDs (Num Lock), restauración de captura de teclado, filtros USB que se activan, o un bug puntual de la versión concreta de VirtualBox.

Pautas efectivas en ese escenario (Windows 10 host + Kali invitado):
– Desactiva temporalmente todos los filtros USB y arranca. Si el teclado vuelve, ya tienes al culpable y podrás refinar el filtro más tarde.
– Cambia el dispositivo apuntador entre PS/2 y USB Tablet para ver si el ratón deja de colgarse.
– Asegura la captura automática de teclado y que la Host key no sea AltGr.
– Aplica el ajuste de Num Lock con GUI/HidLedsSync «0» para evitar estados invertidos.
– Actualiza a la última subversión estable de la rama 6.1 (o superior) si estás en 6.1.22 r144080; muchos bugs se corrigen entre compilaciones r*.

Si sospechas de Hyper‑V pero crees que no lo tienes activo, confirma en Windows con “Activar o desactivar características de Windows” y desmarca Hyper‑V, Plataforma de Hipervisor Windows y WSL2 si no los necesitas. Hyper‑V puede entrometerse con la virtualización, incluso cuando AMD‑V está activo en BIOS.

Mapas de teclado y disposición entre host e invitado

Es imprescindible que la distribución del invitado coincida con la física de tu teclado. Si tu teclado es alemán y el invitado cree que es USA, la barra invertida no estará donde esperas. Ajusta en Linux con herramientas gráficas o con comandos:

sudo dpkg-reconfigure keyboard-configuration
# o
setxkbmap de
# variantes útiles
setxkbmap de nodeadkeys

En entornos gráficos, revisa además la opción de «Teclas muertas» y desactívala si usas atajos con AltGr con frecuencia. Un mapeo correcto evita el 80% de sustos con símbolos como \ , @ o | que cambian entre distribuciones.

Atajos de VirtualBox que pueden interferir

VirtualBox tiene sus propios atajos con la Host key, por ejemplo, para liberar el cursor o cambiar de modo de pantalla. Si sin querer los superpones con atajos del invitado, “ganará” VirtualBox. En Preferencias > Entrada > Atajos, revisa y desactiva aquellos que te pisen combinaciones de trabajo, sobre todo si programas o editas mucho en terminal.

Un clásico: si asignas Host+Del a “Insertar Ctrl+Alt+Del”, puede que intentes usar combinaciones parecidas en el invitado y te sorprendas con un comportamiento raro. Deja sólo lo imprescindible activo para reducir fricciones.

Diagnóstico rápido paso a paso

Cuando todo falla, aplica este mini-diagrama de decisiones, que recoge lo que hemos visto en los casos reales y medidas que funcionaron:
– ¿La ventana de la VM tiene el foco y está la captura de teclado activa? Si no, actívala. Sin foco, el invitado no recibe nada.
– ¿La Host key es AltGr? Cámbiala a Ctrl derecha o logo derecho.
– ¿Num Lock va al revés entre host e invitado? Aplica GUI/HidLedsSync «0».
– ¿Filtros USB activos? Desactívalos y prueba.
– ¿Mapa de teclado correcto en el invitado? Ajusta con setxkbmap o dpkg-reconfigure.
– ¿Sólo falla en X o sólo en TTY? Cambia de terminal o revisa atajos del emulador.
– ¿Usas una versión antigua de VirtualBox? Actualiza a la última de tu rama.
– ¿Necesitas USB 2.0/3.0? Instala el Extension Pack que corresponda a tu versión.

Si tras todo esto la VM se congela igualmente, crea una nueva VM apuntando al mismo disco virtual para descartar corrupción de la configuración. Muchas veces el disco está bien y el .vbox es el que se lía. Para entender cómo abrir o reparar un archivo .vbox consulta la guía correspondiente. Importar de nuevo una appliance (OVA) también es una salida rápida si ese fue tu punto de partida.

Lo que aprendimos de los casos reales

Del caso de Windows 10 + VirtualBox 6.1.22 + Kali: la combinación de no tener Guest Additions ni Extension Pack, más filtros USB y dudas con la Host key, acabó en un escenario de teclado y ratón muertos tras el primer apagado. Poniendo la Host key en Ctrl derecha, quitando filtros USB y activando la captura automática de teclado se recuperó la entrada. Ajustar la sincronización de Num Lock evitó la descoordinación al alternar entre sistemas.

Del caso Debian Squeeze: con mapa USA por defecto y Host key movida a la tecla de logo derecha, algunos no podían usar Ctrl en nano, mientras que otros sí replicaban Ctrl+X sin problema. ¿La diferencia? El contexto (consola vs X), el emulador de terminal y la captura de atajos. Llevarlo a TTY y comprobar allí ayudó a aislar el problema del lado gráfico.

Y del asunto AltGr+ß: VirtualBox no tiene culpa si el mapa del invitado está mal o si robamos AltGr para la Host key. En Linux, AltGr es sagrado para símbolos como \ o | en ciertas distribuciones; reservar esa tecla para VirtualBox es buscarse un bloqueo autoimpuesto.

Preguntas frecuentes rápidas

¿Hace falta instalar Guest Additions para que funcione el teclado? No, el teclado básico funciona sin ellas, pero la integración (ratón, pantalla, portapapeles) mejora mucho con Additions y a menudo elimina rarezas.

¿Puede Hyper‑V romper el teclado en VirtualBox? En equipos Windows, Hyper‑V puede interferir con la virtualización en general. Desactívalo si no lo necesitas (y reinicia) para descartar conflictos.

¿Por qué sólo falla en nano? Porque nano, la terminal o X pueden estar interceptando o reinterpretando modificadores. Prueba en TTY (Ctrl+Alt+F2) para comprobar si es un problema del sistema o de la capa gráfica.

¿Qué pasa con Num Lock al arrancar una VM? Algunas versiones de VirtualBox descuadran el estado del LED entre host e invitado. El ajuste GUI/HidLedsSync «0» lo deja bajo control del host.

Después de tantear todas estas vías, lo habitual es que el teclado vuelva a la vida al corregir tres puntos: evitar AltGr como Host key, alinear el mapa de teclado del invitado con el físico del host y neutralizar la desincronización de Num Lock con el comando de VBoxManage. Si además limpias filtros USB, activas la captura automática y te aseguras de usar versiones emparejadas de VirtualBox y su Extension Pack, los casos de ratón y teclado “fantasma” desaparecen. Y si te ves en el enredo de Ctrl que no funciona en Debian o la barra invertida rebelde en Kali con disposición alemana, recuerda: prueba en TTY, revisa los atajos de la terminal, y no le des a VirtualBox la tecla que Linux necesita para escribir símbolos esenciales.