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.
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»- Prihláste sa do webovej konzoly Proxmox VE.
- Vyberte virtuálny stroj v ľavom bočnom menu.
- Prejdite na kartu Hardware.
- Kliknite na rozbaľovací tlačidlo Add a vyberte Serial Port.
- Pridajte sériový port priradením indexu
0(Serial 0). - Vyberte grafickú kartu Display na hardwarovej table, kliknite na Edit a zmeňte ovládač na Serial terminal 0 (serial0).
- 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:
- Získajte prístup k virtuálnemu stroju cez dočasné pripojenie SSH alebo pomocou grafickej konzoly noVNC.
- Editujte konfiguračný súbor bootovacieho správcu GRUB:
Ventana de terminal sudo nano /etc/default/grub - Vyhľadajte direktívu
GRUB_CMDLINE_LINUX_DEFAULTa zahrňte parametre sériovej konzoly (tty0attyS0pri 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"
- Predchádzajúca konfigurácia:
- Uložte zmeny (Ctrl + O, potvrďte s Enter a ukončite s Ctrl + X).
- Aktualizujte direktívy bootovacieho správcu GRUB v bootovacej partícii:
Ventana de terminal sudo update-grub - Reštartujte operačný systém virtuálneho stroja pre aplikáciu rekonfigurácie jadra:
Ventana de terminal sudo reboot
2. Konfigurácia v kontajneroch LXC
Sección titulada «2. Configuración en Contenedores LXC»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.
Jedinečný postup v LXC
Sección titulada «Procedimiento Único en LXC»- Vyberte svoj kontajner LXC v ľavom bočnom strome Proxmox.
- Prejdite na kartu Options.
- Vyberte možnosť Console mode a dvojklikom na ňu kliknite.
- Zmeňte hodnotu Default na Shell.
- Kliknite na OK.
- Reštartujte kontajner LXC, aby ste rozšírili logické zmeny.
🚀 Prístup a interakcia s xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»Keď sa cieľový hostiteľ inicializuje:
- Prejdite do pravého horného menu lišty virtuálneho stroja alebo kontajnera a kliknite na rozbaľovací tlačidlo Console.
- Keď je obrazovka nakonfigurovaná v sériovom režime, webová konzola sa automaticky pripojí k terminálu xterm.js.
- 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=ttyS0configurado en el cargador GRUB y compilado con éxito. - ✓ Terminal LXC: Parámetro de consola de contenedor ajustado a modo Shell y reiniciado correctamente.

