Ir al contenido

Configurazione della Console Interattiva xterm.js in Proxmox VE

Guida tecnica per abilitare terminali interattivi xterm.js ottimizzati con supporto per l'appunti e regolazione dinamica della risoluzione in VM e container LXC.

0letture

Abilitare la console basata su xterm.js al posto del visualizzatore nativo nonVNC fornisce un terminale interattivo fluido con supporto nativo di copia e incolla nel browser, ridimensionamento dinamico dello schermo e prestazioni di rendering superiori.


Affinché le VM (ad esempio, Ubuntu Server) incanalino il loro output del terminale interattivo verso l'interfaccia web di Proxmox, è obbligatorio effettuare il provisioning di un'interfaccia di porta seriale virtuale nell'hardware della macchina.

Passo A: Provisioning della Porta Seriale nell'Hypervisor

Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»
  1. Accedi alla console web di Proxmox VE.
  2. Seleziona la macchina virtuale nel menu laterale sinistro.
  3. Naviga alla scheda Hardware.
  4. Fai clic sul pulsante a discesa Add e seleziona Serial Port.
  5. Aggiungi la porta seriale assegnando l'indice 0 (Serial 0).
  6. Seleziona la scheda video Display nel pannello hardware, fai clic su Edit e cambia il driver in Serial terminal 0 (serial0).
  7. Clicca su OK.

Passo B: Configurazione nel Sistema Operativo Guest (Guest OS)

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

Se la porta seriale virtuale viene aggiunta in Proxmox ma non abilitata nel bootloader del sistema guest, lo schermo della console xterm.js verrà visualizzato in nero. È imperativo istruire il kernel Linux affinché replichi il suo output:

  1. Accedi alla macchina virtuale tramite una connessione SSH temporanea o mediante la console grafica noVNC.
  2. Modifica il file di configurazione del gestore di avvio GRUB:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Localizza la direttiva GRUB_CMDLINE_LINUX_DEFAULT e incorpora i parametri di console serie (tty0 e ttyS0 a una velocità di 115200 baudi):
    • Configurazione precedente:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity"
    • Configurazione modificata:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
  4. Salva le modifiche (Ctrl + O, conferma con Enter e esci con Ctrl + X).
  5. Aggiorna le direttive del gestore GRUB nella partizione di avvio:
    Ventana de terminal
    sudo update-grub
  6. Riavvia il sistema operativo della macchina virtuale per applicare la riconfigurazione del kernel:
    Ventana de terminal
    sudo reboot

In ambienti di container LXC (come il gateway di sicurezza lxc-portelcore-vpn-01), non è necessario aggiungere hardware seriale virtualizzato, poiché Proxmox gestisce la comunicazione direttamente attraverso interfacce TTY native.

  1. Seleziona il tuo container LXC nell'albero laterale sinistro di Proxmox.
  2. Naviga fino alla scheda Options.
  3. Seleziona l'opzione Console mode e fai doppio clic su di essa.
  4. Modifica il valore da Default a Shell.
  5. Clicca su OK.
  6. Riavvia il container LXC per propagare le modifiche logiche.

Una volta che l'host di destinazione si è inizializzato:

  1. Dirigiti verso la barra dei menu in alto a destra della macchina virtuale o del contenitore e clicca sul pulsante a discesa Console.
  2. Poiché lo schermo è configurato in modalità seriale, la console web si connetterà automaticamente al terminale xterm.js.
  3. Se il monitor risulta inattivo o in standby, premi Enter una volta per forzare il servizio di autenticazione Linux a visualizzare il prompt di 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.