Ir al contenido

Konfigurácia Interaktívnej Konzoly xterm.js v Proxmox VE

Technická príručka na aktiváciu interaktívnych terminálov xterm.js optimalizovaných s podporou schránky a dynamickým prispôsobením rozlíšenia vo VM a kontajneroch LXC.

0lecturas

Povolenie konzoly založenej na xterm.js namiesto natívneho zobrazenia noVNC poskytuje plynulý interaktívny terminál s natívnou podporou kopírovania a vloženia do prehliadača, dynamickým zmenšovaním obrazovky a lepším výkonom vykresľovania.


1. Konfigurácia na virtuálnych strojoch (VM)

Sección titulada «1. Configuración en Máquinas Virtuales (VM)»

Aby virtuálne stroje (napríklad Ubuntu Server) smerovali svoj interaktívny výstup terminálu do webového rozhrania Proxmox, je povinné poskytnúť virtuálny sériový port v hardvéri stroja.

Krok A: Poskytnutie sériového portu v hypervizore

Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»
  1. Prihláste sa do webovej konzoly Proxmox VE.
  2. Vyberte virtuálny stroj v ľavom bočnom menu.
  3. Prejdite na kartu Hardware.
  4. Kliknite na rozbaľovací tlačidlo Add a vyberte Serial Port.
  5. Pridajte sériový port priradením indexu 0 (Serial 0).
  6. Vyberte grafickú kartu Display na hardwarovej table, kliknite na Edit a zmeňte ovládač na Serial terminal 0 (serial0).
  7. Kliknite na OK.

Krok B: Konfigurácia v hosťovskom operačnom systéme (Guest OS)

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

Ak sa virtuálny sériový port pridá v Proxmox, ale nie je povolený v bootovacom načítavači hosťovského systému, obrazovka konzoly xterm.js sa zobrazí čierna. Je nevyhnutné poučiť jadro Linuxu, aby replikovalo svoj výstup:

  1. Získajte prístup k virtuálnemu stroju cez dočasné pripojenie SSH alebo pomocou grafickej konzoly noVNC.
  2. Editujte konfiguračný súbor bootovacieho správcu GRUB:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Vyhľadajte direktívu GRUB_CMDLINE_LINUX_DEFAULT a zahrňte parametre sériovej konzoly (tty0 a ttyS0 pri rýchlosti 115200 baudov):
    • Predchádzajúca konfigurácia:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity"
    • Zmenená konfigurácia:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
  4. Uložte zmeny (Ctrl + O, potvrďte s Enter a ukončite s Ctrl + X).
  5. Aktualizujte direktívy bootovacieho správcu GRUB v bootovacej partícii:
    Ventana de terminal
    sudo update-grub
  6. Reštartujte operačný systém virtuálneho stroja pre aplikáciu rekonfigurácie jadra:
    Ventana de terminal
    sudo reboot

V prostrediach kontajnerov LXC (ako bezpečnostná brána lxc-portelcore-vpn-01), nie je nutné pridávať virtuálny sériový hardvér, pretože Proxmox spravuje komunikáciu priamo cez natívne rozhrania TTY.

  1. Vyberte svoj kontajner LXC v ľavom bočnom strome Proxmox.
  2. Prejdite na kartu Options.
  3. Vyberte možnosť Console mode a dvojklikom na ňu kliknite.
  4. Zmeňte hodnotu Default na Shell.
  5. Kliknite na OK.
  6. Reštartujte kontajner LXC, aby ste rozšírili logické zmeny.

Keď sa cieľový hostiteľ inicializuje:

  1. Prejdite do pravého horného menu lišty virtuálneho stroja alebo kontajnera a kliknite na rozbaľovací tlačidlo Console.
  2. Keď je obrazovka nakonfigurovaná v sériovom režime, webová konzola sa automaticky pripojí k terminálu xterm.js.
  3. Ak sa monitor zobrazí neaktívny alebo čaká, stlačte Enter raz, aby ste prinútili službu autentifikácie Linuxu, aby rozbalila výzvu na prihlásenie (w-server-login:).

⚡ Kontrolný zoznam operácií 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=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.