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.
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.
1. Configurazione su Macchine Virtuali (VM)
Sección titulada «1. Configuración en Máquinas Virtuales (VM)»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»- Accedi alla console web di Proxmox VE.
- Seleziona la macchina virtuale nel menu laterale sinistro.
- Naviga alla scheda Hardware.
- Fai clic sul pulsante a discesa Add e seleziona Serial Port.
- Aggiungi la porta seriale assegnando l'indice
0(Serial 0). - Seleziona la scheda video Display nel pannello hardware, fai clic su Edit e cambia il driver in Serial terminal 0 (serial0).
- 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:
- Accedi alla macchina virtuale tramite una connessione SSH temporanea o mediante la console grafica noVNC.
- Modifica il file di configurazione del gestore di avvio GRUB:
Ventana de terminal sudo nano /etc/default/grub - Localizza la direttiva
GRUB_CMDLINE_LINUX_DEFAULTe incorpora i parametri di console serie (tty0ettyS0a 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"
- Configurazione precedente:
- Salva le modifiche (Ctrl + O, conferma con Enter e esci con Ctrl + X).
- Aggiorna le direttive del gestore GRUB nella partizione di avvio:
Ventana de terminal sudo update-grub - Riavvia il sistema operativo della macchina virtuale per applicare la riconfigurazione del kernel:
Ventana de terminal sudo reboot
2. Configurazione nei Container LXC
Sección titulada «2. Configuración en Contenedores LXC»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.
Procedura Unica in LXC
Sección titulada «Procedimiento Único en LXC»- Seleziona il tuo container LXC nell'albero laterale sinistro di Proxmox.
- Naviga fino alla scheda Options.
- Seleziona l'opzione Console mode e fai doppio clic su di essa.
- Modifica il valore da Default a Shell.
- Clicca su OK.
- Riavvia il container LXC per propagare le modifiche logiche.
🚀 Accesso e Interazione con xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»Una volta che l'host di destinazione si è inizializzato:
- Dirigiti verso la barra dei menu in alto a destra della macchina virtuale o del contenitore e clicca sul pulsante a discesa Console.
- Poiché lo schermo è configurato in modalità seriale, la console web si connetterà automaticamente al terminale xterm.js.
- 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:).
⚡ Checklist operativa di 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=ttyS0configurado en el cargador GRUB y compilado con éxito. - ✓ Terminal LXC: Parámetro de consola de contenedor ajustado a modo Shell y reiniciado correctamente.

