Si el teu teclat no funciona a VirtualBox: guia de causes i solucions

Quan de sobte el teclat deixa de respondre dins una màquina virtual, la sensació és de bloqueig total: no pots iniciar sessió, no funciona el ratolí i després d'insistir-hi una estona, sembla que la VM es queda penjada. Aquest escenari és més comú del que sembla a VirtualBox, especialment amb combinacions concretes de maquinari, SO amfitrió i convidat, i certes configuracions de teclat.

En aquest article trobaràs un repàs complet de causes i arranjaments reals basats en casos com un Windows 10 host amb Oracle VirtualBox 6.1 i un convidat Kali Linux que a la primera arrencada anava fi però, després d'apagar i tornar a encendre, ni teclat ni ratolí responien i al cap de poc la VM es congelava. També veurem el típic maldecap amb la tecla Ctrl a Debian i l'enigma de la barra invertida en teclats alemanys (AltGr+ß) dins de Linux, a més d'un problema clàssic: l'estat de Num Lock desincronitzat entre amfitrió i convidat. Anem a aprendre tot sobre si el teu teclat no funciona a VirtualBox, aquests són els passos per arreglar-ho.

Primer de tot: entendre el context i els símptomes

Hi ha diversos perfils de problema recollits en casos reals: un és un host Windows 10 i VirtualBox 6.1.22 r144080 amb convidat Kali Linux sense Guest Additions ni Host Extensions. Després d'importar la VM i arrencar-la tot ok; però després del primer apagat, en tornar a iniciar, el teclat no escriu, el ratolí no es mou i, després d'uns minuts, la màquina virtual es queda fregida.

En aquest mateix entorn es van canviar ajustaments de RAM i de memòria de vídeo, es van tocar opcions d'entrada i es van esborrar i afegir filtres USB, sense èxit. AMD‑V estava activat (si necessites guia per activar la virtualització al meu pc) i no hi havia traça d'Hyper‑V. En paral·lel, hi havia dubtes amb la tecla Host (la de VirtualBox que substitueix combinacions com Ctrl+Alt) i amb com escriure la barra invertida \ al convidat Kali usant disposició alemanya (l'usuari intentava Ctrl+Alt+ß, Host+ß i tot tipus de combinacions).

En un altre front, usuaris amb Debian Squeeze convidat sobre un amfitrió Wheezy van reportar que la tecla Ctrl no feia la seva funció dins del convidat: per exemple, en nano, en prémer ^X apareixia una simple «x» en pantalla. Es van provar variants com utilitzar Ctrl esquerre o dret i canviar la tecla Host a la tecla de logo dreta, amb mapes de teclat per defecte en anglès (USA), però la fallada persistia en determinades sessions.

Comprova el bàsic: captura de teclat, host key i conflictes

A VirtualBox hi ha una opció anomenada “Auto capture keyboard”. Si està desactivada, és possible que el teclat es quedi al host i les pulsacions no arribin al convidat. Aneu a Fitxer > Preferències > Entrada i comproveu que la captura automàtica estigui activa. També fixa't si la vora de la finestra de la VM indica que el focus és a dins.

La tecla Host (per defecte, Ctrl dreta) és clau. Si la vas canviar a AltGr (Right Alt) oa una tecla que necessites dins del convidat (per exemple, per escriure «\» en alemany amb AltGr+ß), tindràs problemes perquè VirtualBox intercepta aquesta tecla com a Host. Evita configurar AltGr com a tecla Host; utilitza la Ctrl dreta o la tecla de logotip dreta, i assegura't que VirtualBox no segresta combinacions que el convidat necessita.

Una altra comprovació que sembla òbvia però ajuda: prova el Ctrl esquerre i el dret. Hi ha casos documentats en què un dels dos respon i l'altre no, per com mapeja el sistema convidat o per com una aplicació concreta (nano, X o consola) està llegint els esdeveniments del teclat.

Num Lock desincronitzat entre amfitrió i convidat

Hi ha un comportament històric a VirtualBox pel qual l'estat de Num Lock pot quedar “invertit” entre host i convidat: quan al host està activat, a la VM apareix com a desactivat, i al revés. Això provoca que el teclat numèric es comporti com a fletxes de cursor en un costat mentre que a l'altre funciona com a números.

La solució és forçar VirtualBox a no sincronitzar els LEDs del teclat amb el convidat. Al Windows, obre un CMD com a administrador, navega a la carpeta d'instal·lació de VirtualBox (normalment "C:\\Program Files\\Oracle\\VirtualBox") i executa la següent ordre ajustant el nom exacte del teu VM:

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

En aplicar això, quan Num Lock estigui encès al teu equip amfitrió, també ho estarà al convidat. És una manera ràpida d'evitar el ball constant en alternar entre tots dos sistemes. Si treballes molt amb el numpad, t'estalviarà massa ensurts.

La barra invertida en Linux amb teclat alemany: AltGr, Ctrl i Host key

En distribucions com Kali amb distribució alemanya, la barra invertida \ sol escriure's amb AltGr+ß. En molts entorns de Linux, Ctrl+Alt s'interpreta com a equivalent a AltGr, així que també funciona. Però si a VirtualBox heu assignat la tecla Host a AltGr, la combinació no arribarà al convidat.

Per solucionar-ho, revisa a Fitxer > Preferències > Entrada quina és la teva tecla Host i tria una que no xoc amb AltGr. El valor per defecte (Ctrl dreta) sol ser el més assenyat. Després, dins del convidat, comprova la distribució del teclat: a Kali, la pots canviar des de la interfície gràfica o amb setxkbmap. Per exemple:

setxkbmap de

Si segueixes sense poder escriure la barra invertida, prova amb la variant de mapa German (nodeadkeys) a les opcions de teclat del teu entorn d'escriptori. Evitar tecles mortes ajuda que AltGr sigui directe. I recorda: no facis servir combinacions amb la Host key per escriure; la Host key és per a dreceres de VirtualBox, no per al convidat.

Quan Ctrl no funciona a Debian o nano ignora les dreceres

Que en nano, en prémer ^X, surti una x en comptes de tancar, suggereix que Ctrl no està sent detectat com a modificador. Pot ser degut a un mapa de teclat incorrecte, a una capa de X que no recull el modificador oa un conflicte amb l'Host key.

Recomanacions pràctiques basades en casos reals amb Debian Squeeze convidat a Wheezy amfitrió: verifica que el mapa del convidat sigui el correcte («us» si el teclat és USA) amb «dpkg-reconfigure keyboard-configuration» o «localectl» en sistemes més nous. Canvia la tecla Host a una tecla que no sigui Ctrl ni AltGr, per exemple, la tecla de logotip dreta. I prova les dreceres tant en consola pura (TTY) com dins X per fitar el problema.

Si només falla en una terminal gràfica concreta, intenta amb una altra (per exemple, substitueix la terminal per defecte per xterm o gnome-terminal) per veure si és un tema de captura de dreceres. Alguns emuladors intercepten combinacions i requereixen desactivar-les a les seves preferències.

Configuracions de VirtualBox que afecten a teclat i ratolí

A la configuració de la VM, a Sistema > Placa base, revisa el dispositiu apuntador: «PS/2 Mouse», «USB Tablet» o «USB Multi-Touch Tablet». Per a molts convidats Linux, USB Tablet millora la integració del punter; si veus congelacions del ratolí, alterna entre aquestes opcions i verifica.

A Sistema > Processador, evita activar més acceleracions que les necessàries si observes penges després d'uns minuts. Encara que AMD‑V estigui actiu, no necessites tocar nidificació o paravirtualització avançada perquè el teclat funcioni; centra't a la part d'Entrada.

En USB, suprimiu filtres que no utilitzeu. Els filtres USB mal configurats poden capturar un teclat o ratolí físic fora del host, deixant-te sense control a Windows mentre la VM intenta “agafar-ho”. Si necessites USB 2.0/3.0 al convidat, instal·la l'Extension Pack corresponent a la teva versió exacta de VirtualBox, perquè sense ell el suport USB avançat no funciona bé. Per revisar la configuració de la VM utilitza les opcions de la interfície de VirtualBox.

Guest Additions i Extension Pack: quan marquen la diferència

No tenir instal·lats ni Guest Additions ni Host Extensions (Extension Pack) no impedeix que el teclat bàsic funcioni, però la integració millora molt amb Guest Additions. Per a Kali o Debian, instal·la els headers del nucli i compila els mòduls:

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

Després de reiniciar, el ratolí integrat i la sincronització del porta-retalls solen comportar-se millor. Els Guest Additions no arreglen un Host key mal escollida, però sí que eviten rareses d'entrada i acceleren la capa gràfica que, en alguns casos, provocava penjats aparents. Si necessites instruccions específiques per actualitzar VirtualBox Guest Additions consulta la guia corresponent.

Sobre l'Extension Pack: instal·la-ho al host només si necessites USB 2.0/3.0, VRDP o PXE per a Intel. Emparella exactament la versió (p. ex., 6.1.22 r144080 amb el seu Extension Pack 6.1.22) per evitar incompatibilitats.

Si després del primer reinici tot es trenca: pistes i arranjaments

Que una VM funcioni en la primera arrencada i falli després sol apuntar a canvis d'estat que ocorren durant l'apagat: sincronització de LEDs (Num Lock), restauració de captura de teclat, filtres USB que s'activen, o un bug puntual de la versió concreta de VirtualBox.

Pautes efectives en aquest escenari (Windows 10 host + Kali convidat):
– Desactiva temporalment tots els filtres USB i arrenca. Si el teclat torna, ja tens el culpable i podràs refinar el filtre més tard.
– Canvia el dispositiu apuntador entre PS/2 i USB Tablet per veure si el ratolí deixa de penjar-se.
– Assegura la captura automàtica de teclat i que l'Host key no sigui AltGr.
– Aplica la configuració de Num Lock amb GUI/HidLedsSync «0» per evitar estats invertits.
– Actualitza a la darrera subversió estable de la branca 6.1 (o superior) si estàs a 6.1.22 r144080; molts bugs es corregeixen entre compilacions r*.

Si sospites de Hyper‑V però creus que no ho tens actiu, confirma a Windows amb “Activar o desactivar característiques de Windows” i desmarca Hyper‑V, Plataforma d'Hipervisor Windows i WSL2 si no els necessites. Hyper‑V es pot ficar amb la virtualització, fins i tot quan AMD‑V està actiu a BIOS.

Mapes de teclat i disposició entre host i convidat

És imprescindible que la distribució del convidat coincideixi amb la física del teu teclat. Si el teu teclat és alemany i el convidat creu que és USA, la barra invertida no serà on esperes. Ajusta a Linux amb eines gràfiques o amb ordres:

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

En entorns gràfics, revisa a més l'opció de «Tecles mortes» i desactiva-la si fas servir dreceres amb AltGr amb freqüència. Un mapatge correcte evita el 80% dels ensurts amb símbols com \ , @ o | que canvien entre distribucions.

Dreceres de VirtualBox que poden interferir

VirtualBox té les seves pròpies dreceres amb la Host key, per exemple, per alliberar el cursor o canviar de mode de pantalla. Si sense voler els superpons amb dreceres del convidat, “guanyarà” VirtualBox. A Preferències > Entrada > Dreceres, revisa i desactiva aquells que et trepitgin combinacions de treball, sobretot si programes o edites molt en terminal.

Un clàssic: si assignes Host+Del a “Inserir Ctrl+Alt+Del”, pot ser que intentis utilitzar combinacions semblants al convidat i et sorprenguis amb un comportament rar. Deixa només allò imprescindible actiu per reduir friccions.

Diagnòstic ràpid pas a pas

Quan tot falla, aplica aquest minidiagrama de decisions, que recull el que hem vist en els casos reals i mesures que van funcionar:
– La finestra de la VM té el focus i hi ha la captura de teclat activa? Si no, activa-la. Sense focus, el convidat no rep res.
– La Host key és AltGr? Canvia-la a Ctrl dreta o logo dret.
– Num Lock va al revés entre host i convidat? Aplica GUI/HidLedsSync “0”.
– Filtres USB actius? Desactiva'ls i prova.
– Mapa de teclat correcte al convidat? Ajusteu-lo amb setxkbmap o dpkg-reconfigure.
– Només falla a X o només a TTY? Canvia de terminal o revisa dreceres de l'emulador.
– Uses una versió antiga de VirtualBox? Actualitza la darrera de la teva branca.
– Necessites USB 2.0/3.0? Instal·leu l'Extension Pack que correspongui a la vostra versió.

Si després de tot això la VM es congela igualment, creeu una nova VM apuntant al mateix disc virtual per descartar corrupció de la configuració. Moltes vegades el disc està bé i el .vbox és el que s'embolica. Per entendre com obrir o reparar un fitxer .vbox consulta la guia corresponent. Importar novament una appliance (OVA) també és una sortida ràpida si aquest va ser el teu punt de partida.

El que vam aprendre dels casos reals

Del cas de Windows 10 + VirtualBox 6.1.22 + Kali: la combinació de no tenir Guest Additions ni Extension Pack, més filtres USB i dubtes amb la Host key, va acabar en un escenari de teclat i ratolí morts després del primer apagat. Posant la Host key a Ctrl dreta, traient filtres USB i activant la captura automàtica de teclat es va recuperar lentrada. Ajustar la sincronització de Num Lock va evitar la descoordinació en alternar entre sistemes.

Del cas Debian Squeeze: amb mapa USA per defecte i Host key moguda a la tecla de logo dreta, alguns no podien fer servir Ctrl en nano, mentre que altres sí que replicaven Ctrl+X sense problema. La diferència? El context (consola vs X), l'emulador de terminal i la captura de dreceres. Portar-ho a TTY i comprovar-hi va ajudar a aïllar el problema del costat gràfic.

I de l'assumpte AltGr+ß: VirtualBox no en té culpa si el mapa del convidat està malament o si robem AltGr per a la Host key. A Linux, AltGr és sagrat per a símbols com a \ o | en certes distribucions; reservar aquesta tecla per a VirtualBox és buscar un bloqueig autoimpost.

Preguntes freqüents ràpides

Cal instal·lar Guest Additions perquè funcioni el teclat? No, el teclat bàsic funciona sense, però la integració (ratolí, pantalla, portapapers) millora molt amb Additions i sovint elimina rareses.

Hyper‑V pot trencar el teclat a VirtualBox? En equips Windows, Hyper‑V pot interferir amb la virtualització en general. Desactiva-ho si no ho necessites (i reinicia) per descartar conflictes.

Per què només falla en nano? Perquè nano, la terminal o X poden estar interceptant o reinterpretant modificadors. Proveu a TTY (Ctrl+Alt+F2) per comprovar si és un problema del sistema o de la capa gràfica.

Què passa amb Num Lock en arrencar una VM? Algunes versions de VirtualBox desquadreu l'estat del LED entre host i convidat. El paràmetre GUI/HidLedsSync «0» el deixa sota control del host.

Després de temptejar totes aquestes vies, el més habitual és que el teclat torni a la vida en corregir tres punts: evitar AltGr com a Host key, alinear el mapa de teclat del convidat amb el físic del host i neutralitzar la desincronització de Num Lock amb l'ordre de VBoxManage. Si a més neteges filtres USB, actives la captura automàtica i t'assegures d'usar versions aparellades de VirtualBox i el seu Extension Pack, els casos de ratolí i teclat “fantasma” desapareixen. I si et veus a l'embolic de Ctrl que no funciona a Debian o la barra invertida rebel a Kali amb disposició alemanya, recorda: prova a TTY, revisa les dreceres de la terminal, i no li donis a VirtualBox la tecla que Linux necessita per escriure símbols essencials.