Ir al contenido

Configuratie van interactieve xterm.js-console in Proxmox VE

Technische gids voor het inschakelen van geoptimaliseerde xterm.js interactieve terminals met klembordondersteuning en dynamische resolutieaanpassing in VM's en LXC-containers.

0lecturas

Het inschakelen van de console op basis van xterm.js in plaats van de standaard noVNC-viewer biedt een soepele interactieve terminal met native ondersteuning voor kopiëren en plakken in de browser, dynamische schermgrootte aanpassing en superieure rendering-prestaties.


Om ervoor te zorgen dat de VM's (bijvoorbeeld Ubuntu Server) hun interactieve terminaluitvoer naar de webinterface van Proxmox leiden, is het verplicht om een virtuele seriële poortinterface in de hardware van de machine te voorzien.

Stap A: De Seriële Poort in de Hypervisor Voorzien

Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»
  1. Log in op de webconsole van Proxmox VE.
  2. Selecteer de virtuele machine in het linkermenu.
  3. Navigeer naar het tabblad Hardware.
  4. Klik op de uitklapknop Add en selecteer Serial Port.
  5. Voeg de seriële poort toe door de index 0 toe te wijzen (Serial 0).
  6. Selecteer de videokaart Display in het hardwarepaneel, klik op Edit en wijzig de controller naar Serial terminal 0 (serial0).
  7. Klik op OK.

Stap B: Configuratie in het Gastbesturingssysteem (Guest OS)

Sección titulada «Paso B: Configuración en el Sistema Operativo Invitado (Guest OS)»

Als de virtuele seriële poort in Proxmox wordt toegevoegd maar niet wordt ingeschakeld in de bootloader van het gastsysteem, wordt het scherm van de xterm.js-console zwart weergegeven. Het is noodzakelijk om de Linux-kernel te instrueren om zijn uitvoer te repliceren:

  1. Krijg toegang tot de virtuele machine via een tijdelijke SSH-verbinding of via de grafische noVNC-console.
  2. Bewerk het configuratiebestand van de GRUB-bootloader:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Zoek de richtlijn GRUB_CMDLINE_LINUX_DEFAULT en voeg de serie-consoleparameters (tty0 en ttyS0 op een snelheid van 115200 baud) toe:
    • Vorige configuratie:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity"
    • Gewijzigde configuratie:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
  4. Sla de wijzigingen op (Ctrl + O, bevestig met Enter en sluit af met Ctrl + X).
  5. Update de richtlijnen van de GRUB-bootloader op de opstartpartitie:
    Ventana de terminal
    sudo update-grub
  6. Herstart het besturingssysteem van de virtuele machine om de kernel-reconfiguratie toe te passen:
    Ventana de terminal
    sudo reboot

In LXC-containeromgevingen (zoals de security gateway lxc-portelcore-vpn-01) is het niet nodig om gevirtualiseerde seriële hardware toe te voegen, aangezien Proxmox de communicatie rechtstreeks via native TTY-interfaces beheert.

  1. Selecteer uw LXC-container in de linkerzijboom van Proxmox.
  2. Navigeer naar het tabblad Options.
  3. Selecteer de optie Console mode en dubbelklik erop.
  4. Wijzig de waarde van Default naar Shell.
  5. Klik op OK.
  6. Start de LXC-container opnieuw op om de logische wijzigingen door te voeren.

Zodra de doelhost is geïnitialiseerd:

  1. Ga naar de menubalk rechtsboven in de virtuele machine of container en klik op de dropdown-knop Console.
  2. Omdat het scherm is geconfigureerd in serie-modus, wordt de webconsole automatisch verbonden met de xterm.js terminal.
  3. Als het scherm inactief is of in de wachtstand staat, druk dan eenmaal op Enter om de Linux-authenticatiedienst te dwingen de login-prompt weer te geven (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.