Ir al contenido

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.

0lectures

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.


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.

  1. Inicia la sessió a la consola web de Proxmox VE.
  2. Selecciona la màquina virtual al menú lateral esquerre.
  3. Navega a la pestanya Hardware.
  4. Fes clic al botó desplegable Add i selecciona Serial Port.
  5. Afegeix el port sèrie assignant l'índex 0 (Serial 0).
  6. Selecciona la targeta gràfica Display al panell de hardware, fes clic a Edit i canvia el controlador a Serial terminal 0 (serial0).
  7. 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:

  1. Accedeix a la màquina virtual mitjançant una connexió SSH temporal o a través de la consola gràfica noVNC.
  2. Edita l'arxiu de configuració del gestor d'arrencada GRUB:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Localitza la directiva GRUB_CMDLINE_LINUX_DEFAULT i incorpora els paràmetres de consola sèrie (tty0 i ttyS0 a 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"
  4. Guarda els canvis (Ctrl + O, confirma amb Enter i surt amb Ctrl + X).
  5. Actualitza les directives del gestor GRUB a la partició d'arrencada:
    Ventana de terminal
    sudo update-grub
  6. Reinicia el sistema operatiu de la màquina virtual per aplicar la reconfiguració del kernel:
    Ventana de terminal
    sudo reboot

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.

  1. Selecciona el teu contenidor LXC a l'arbre lateral esquerre de Proxmox.
  2. Navega a la pestanya Options.
  3. Selecciona l'opció Console mode i fes doble clic sobre ella.
  4. Modifica el valor de Default a Shell.
  5. Fes clic a OK.
  6. Reinicia el contenidor LXC per propagar els canvis lògics.

Un cop l'host de destinació s'hagi inicialitzat:

  1. Dirigeix-te a la barra de menú superior dreta de la màquina virtual o del contenidor i fes clic al botó desplegable Console.
  2. Com que la pantalla està configurada en mode sèrie, la consola web es connectarà automàticament a la terminal xterm.js.
  3. 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:).

  • ✓ 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.