Configuración de Consola Interactiva xterm.js en Proxmox VE
Guía técnica para habilitar terminales interactivas xterm.js optimizadas con soporte de portapapeles y ajuste de resolución dinámico en VMs y contenedores LXC.
Habilitar la consola basada en xterm.js en lugar del visualizador nativo noVNC proporciona una terminal interactiva fluida con soporte nativo de copiado y pegado en el navegador, redimensionamiento de pantalla dinámico y rendimiento de renderizado superior.
1. Configuración en Máquinas Virtuales (VM)
Sección titulada «1. Configuración en Máquinas Virtuales (VM)»Para que las VMs (por ejemplo, Ubuntu Server) canalicen su salida de terminal interactiva hacia la interfaz web de Proxmox, es obligatorio aprovisionar una interfaz de puerto serie virtual en el hardware de la máquina.
Paso A: Aprovisionar el Puerto Serie en el Hipervisor
Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»- Inicia sesión en la consola web de Proxmox VE.
- Selecciona la máquina virtual en el menú lateral izquierdo.
- Navega a la pestaña Hardware.
- Haz clic en el botón desplegable Add y selecciona Serial Port.
- Añade el puerto serie asignando el índice
0(Serial 0). - Selecciona la tarjeta gráfica Display en el panel de hardware, haz clic en Edit y cambia el controlador a Serial terminal 0 (serial0).
- Haz clic en OK.
Paso B: Configuración en el Sistema Operativo Invitado (Guest OS)
Sección titulada «Paso B: Configuración en el Sistema Operativo Invitado (Guest OS)»Si el puerto serie virtual se añade en Proxmox pero no se habilita en el cargador de arranque del sistema invitado, la pantalla de la consola xterm.js se mostrará en negro. Es imperativo instruir al kernel de Linux para que replique su salida:
- Accede a la máquina virtual a través de una conexión SSH temporal o mediante la consola noVNC gráfica.
- Edita el archivo de configuración del gestor de arranque GRUB:
Ventana de terminal sudo nano /etc/default/grub - Localiza la directiva
GRUB_CMDLINE_LINUX_DEFAULTe incorpora los parámetros de consola serie (tty0yttyS0a una velocidad de 115200 baudios):- Configuración anterior:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity" - Configuración modificada:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
- Configuración anterior:
- Guarda los cambios (Ctrl + O, confirma con Enter y sal con Ctrl + X).
- Actualiza las directivas del gestor GRUB en la partición de arranque:
Ventana de terminal sudo update-grub - Reinicia el sistema operativo de la máquina virtual para aplicar la reconfiguración del kernel:
Ventana de terminal sudo reboot
2. Configuración en Contenedores LXC
Sección titulada «2. Configuración en Contenedores LXC»En entornos de contenedores LXC (como la pasarela de seguridad lxc-portelcore-vpn-01), no es necesario añadir hardware serie virtualizado, puesto que Proxmox gestiona la comunicación directamente a través de interfaces nativas TTY.
Procedimiento Único en LXC
Sección titulada «Procedimiento Único en LXC»- Selecciona tu contenedor LXC en el árbol lateral izquierdo de Proxmox.
- Navega a la pestaña Options.
- Selecciona la opción Console mode y haz doble clic sobre ella.
- Modifica el valor de Default a Shell.
- Haz clic en OK.
- Reinicia el contenedor LXC para propagar los cambios lógicos.
🚀 Acceso e Interacción con xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»Una vez que el host de destino se haya inicializado:
- Dirígete a la barra de menú superior derecha de la máquina virtual o contenedor y haz clic en el botón desplegable Console.
- Al estar configurada la pantalla en modo serie, la consola web se conectará automáticamente a la terminal xterm.js.
- Si el monitor se muestra inactivo o en espera, presiona Enter una vez para forzar al servicio de autenticación de Linux a desplegar el prompt de login (
w-server-login:).
⚡ Checklist de Operación 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.

