Ir al contenido

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.

0lecturas

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»
  1. Inicia sesión en la consola web de Proxmox VE.
  2. Selecciona la máquina virtual en el menú lateral izquierdo.
  3. Navega a la pestaña Hardware.
  4. Haz clic en el botón desplegable Add y selecciona Serial Port.
  5. Añade el puerto serie asignando el índice 0 (Serial 0).
  6. Selecciona la tarjeta gráfica Display en el panel de hardware, haz clic en Edit y cambia el controlador a Serial terminal 0 (serial0).
  7. 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:

  1. Accede a la máquina virtual a través de una conexión SSH temporal o mediante la consola noVNC gráfica.
  2. Edita el archivo de configuración del gestor de arranque GRUB:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Localiza la directiva GRUB_CMDLINE_LINUX_DEFAULT e incorpora los parámetros de consola serie (tty0 y ttyS0 a 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"
  4. Guarda los cambios (Ctrl + O, confirma con Enter y sal con Ctrl + X).
  5. Actualiza las directivas del gestor GRUB en la partición de arranque:
    Ventana de terminal
    sudo update-grub
  6. Reinicia el sistema operativo de la máquina virtual para aplicar la reconfiguración del kernel:
    Ventana de terminal
    sudo reboot

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.

  1. Selecciona tu contenedor LXC en el árbol lateral izquierdo de Proxmox.
  2. Navega a la pestaña Options.
  3. Selecciona la opción Console mode y haz doble clic sobre ella.
  4. Modifica el valor de Default a Shell.
  5. Haz clic en OK.
  6. Reinicia el contenedor LXC para propagar los cambios lógicos.

Una vez que el host de destino se haya inicializado:

  1. 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.
  2. Al estar configurada la pantalla en modo serie, la consola web se conectará automáticamente a la terminal xterm.js.
  3. 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:).

  • ✓ Hardware Serial: Interfaz virtual Serial 0 añadida y vinculada al controlador Display en Proxmox.
  • ✓ Redirección de Kernel: Parámetro console=ttyS0 configurado en el cargador GRUB y compilado con éxito.
  • ✓ Terminal LXC: Parámetro de consola de contenedor ajustado a modo Shell y reiniciado correctamente.