Configuració de la consola interactiva xterm.js en Proxmox VE
Guia tècnica per habilitar terminals interactives xterm.js optimitzades amb suport del tauler de retallades i ajust de resolució dinàmic en VM i contenidors LXC.
Habilitar la consola basada en xterm.js en lloc del visualitzador natiu noVNC proporciona una terminal interactiva fluida amb suport natiu de còpia i enganxa al navegador, redimensionament de pantalla dinàmic i rendiment de renderització superior.
1. Configuració en Màquines Virtuals (VM)
Sección titulada «1. Configuración en Máquinas Virtuales (VM)»Perquè les VM (per exemple, Ubuntu Server) canalitzin la seva sortida de terminal interactiva cap a la interfície web de Proxmox, és obligatori aprovisionar una interfície de port sèrie virtual al maquinari de la màquina.
Pas A: Aprovisionar el Port Sèrie al Hipervisor
Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»- Inicia la sessió a la consola web de Proxmox VE.
- Selecciona la màquina virtual al menú lateral esquerre.
- Navega a la pestanya Hardware.
- Fes clic al botó desplegable Add i selecciona Serial Port.
- Afegeix el port sèrie assignant l'índex
0(Serial 0). - Selecciona la targeta gràfica Display al panell de hardware, fes clic a Edit i canvia el controlador a Serial terminal 0 (serial0).
- Fes clic a OK.
Pas B: Configuració en el Sistema Operatiu Convidat (Guest OS)
Sección titulada «Paso B: Configuración en el Sistema Operativo Invitado (Guest OS)»Si el port sèrie virtual s'afegeix a Proxmox però no s'habilita en l'arrancador del sistema convidat, la pantalla de la consola xterm.js es mostrarà en negre. És imperatiu instruir el kernel de Linux perquè repliqui la seva sortida:
- Accedeix a la màquina virtual mitjançant una connexió SSH temporal o a través de la consola gràfica noVNC.
- Edita l'arxiu de configuració del gestor d'arrencada GRUB:
Ventana de terminal sudo nano /etc/default/grub - Localitza la directiva
GRUB_CMDLINE_LINUX_DEFAULTi incorpora els paràmetres de consola sèrie (tty0ittyS0a una velocitat de 115200 bauds):- Configuració anterior:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity" - Configuració modificada:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
- Configuració anterior:
- Guarda els canvis (Ctrl + O, confirma amb Enter i surt amb Ctrl + X).
- Actualitza les directives del gestor GRUB a la partició d'arrencada:
Ventana de terminal sudo update-grub - Reinicia el sistema operatiu de la màquina virtual per aplicar la reconfiguració del kernel:
Ventana de terminal sudo reboot
2. Configuració en contenidors LXC
Sección titulada «2. Configuración en Contenedores LXC»En entorns de contenidors LXC (com la passarel·la de seguretat lxc-portelcore-vpn-01), no és necessari afegir hardware sèrie virtualitzat, ja que Proxmox gestiona la comunicació directament a través d'interfícies natives TTY.
Procediment únic en LXC
Sección titulada «Procedimiento Único en LXC»- Selecciona el teu contenidor LXC a l'arbre lateral esquerre de Proxmox.
- Navega a la pestanya Options.
- Selecciona l'opció Console mode i fes doble clic sobre ella.
- Modifica el valor de Default a Shell.
- Fes clic a OK.
- Reinicia el contenidor LXC per propagar els canvis lògics.
🚀 Accés i interacció amb xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»Un cop l'host de destinació s'hagi inicialitzat:
- Dirigeix-te a la barra de menú superior dreta de la màquina virtual o del contenidor i fes clic al botó desplegable Console.
- Com que la pantalla està configurada en mode sèrie, la consola web es connectarà automàticament a la terminal xterm.js.
- Si el monitor es mostra inactiv o en espera, pressiona Enter una vegada per forçar el servei d'autenticació de Linux a desplegar el prompt de login (
w-server-login:).
⚡ Checklist d'operació de xterm.js
Sección titulada «⚡ Checklist de Operación de xterm.js»- ✓ Hardware Serial: Interfaz virtual Serial 0 añadida y vinculada al controlador Display en Proxmox.
- ✓ Redirección de Kernel: Parámetro
console=ttyS0configurado en el cargador GRUB y compilado con éxito. - ✓ Terminal LXC: Parámetro de consola de contenedor ajustado a modo Shell y reiniciado correctamente.

