Konfiguration der interaktiven xterm.js-Konsole in Proxmox VE
Technischer Leitfaden zur Aktivierung optimierter interaktiver xterm.js-Terminals mit Clipboard-Unterstützung und dynamischer Auflösungsanpassung in VMs und LXC-Containern.
Die Aktivierung der auf xterm.js basierenden Konsole anstelle des nativen nonVNC-Visualizers bietet eine flüssige interaktive Terminal mit nativer Kopier- und Einfügeunterstützung im Browser, dynamischer Bildschirmgrößenänderung und überlegenem Renderingsleistung.
1. Konfiguration in virtuellen Maschinen (VM)
Sección titulada «1. Configuración en Máquinas Virtuales (VM)»Damit VMs (z. B. Ubuntu Server) ihre interaktive Terminalausgabe an die Proxmox-Weboberfläche weiterleiten, ist es zwingend erforderlich, eine virtuelle serielle Schnittstelle in der Hardware der Maschine bereitzustellen.
Schritt A: Bereitstellung des seriellen Ports im Hypervisor
Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»- Melden Sie sich an der Proxmox VE-Webkonsole an.
- Wählen Sie die virtuelle Maschine im linken Seitenmenü aus.
- Navigieren Sie zur Registerkarte Hardware.
- Klicken Sie auf die Dropdown-Schaltfläche Add und wählen Sie Serial Port.
- Fügen Sie den seriellen Anschluss hinzu, indem Sie den Index
0(Serial 0) zuweisen. - Wählen Sie die Grafikkarte Display im Hardware-Panel aus, klicken Sie auf Edit und ändern Sie den Treiber auf Serial terminal 0 (serial0).
- Klicken Sie auf OK.
Schritt B: Konfiguration im Gastbetriebssystem (Guest OS)
Sección titulada «Paso B: Configuración en el Sistema Operativo Invitado (Guest OS)»Wenn der virtuelle serielle Port in Proxmox hinzugefügt, aber im Bootloader des Gastsystems nicht aktiviert wird, bleibt der Bildschirm der xterm.js-Konsole schwarz. Es ist zwingend erforderlich, den Linux-Kernel anzuweisen, seine Ausgabe zu replizieren:
- Greifen Sie über eine temporäre SSH-Verbindung oder über die grafische noVNC-Konsole auf die virtuelle Maschine zu.
- Bearbeiten Sie die GRUB-Boot-Manager-Konfigurationsdatei:
Ventana de terminal sudo nano /etc/default/grub - Suchen Sie die Richtlinie
GRUB_CMDLINE_LINUX_DEFAULTund fügen Sie die seriellen Konsolenparameter (tty0undttyS0bei einer Geschwindigkeit von 115200 Baud) hinzu:- Vorherige Konfiguration:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity" - Geänderte Konfiguration:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
- Vorherige Konfiguration:
- Änderungen speichern (Strg + O, mit Enter bestätigen und mit Strg + X beenden).
- Aktualisieren Sie die GRUB-Manager-Richtlinien auf der Startpartition:
Ventana de terminal sudo update-grub - Starten Sie das Betriebssystem der virtuellen Maschine neu, um die Kernel-Rekonfiguration anzuwenden:
Ventana de terminal sudo reboot
2. Konfiguration in LXC-Containern
Sección titulada «2. Configuración en Contenedores LXC»In LXC-Container-Umgebungen (wie dem Security Gateway lxc-portelcore-vpn-01) ist es nicht erforderlich, virtualisierte serielle Hardware hinzuzufügen, da Proxmox die Kommunikation direkt über native TTY-Schnittstellen verwaltet.
Einziges Verfahren bei LXC
Sección titulada «Procedimiento Único en LXC»- Wählen Sie Ihren LXC-Container im linken Seitenbaum von Proxmox aus.
- Navigieren Sie zur Registerkarte Options.
- Wählen Sie die Option Console mode und doppelklicken Sie darauf.
- Ändern Sie den Wert von Default in Shell.
- Klicken Sie auf OK.
- Starten Sie den LXC-Container neu, um die logischen Änderungen zu übernehmen.
🚀 Zugriff und Interaktion mit xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»Sobald der Ziel-Host initialisiert wurde:
- Navigieren Sie zur oberen rechten Menüleiste der virtuellen Maschine oder des Containers und klicken Sie auf die Dropdown-Schaltfläche Console.
- Da der Bildschirm im seriellen Modus konfiguriert ist, verbindet sich die Webkonsole automatisch mit dem xterm.js-Terminal.
- Wenn der Monitor als inaktiv oder im Standby angezeigt wird, drücken Sie einmal Enter, um den Linux-Authentifizierungsdienst dazu zu zwingen, die Login-Aufforderung (
w-server-login:) anzuzeigen.
⚡ xterm.js Betriebs-Checkliste
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.

