Ir al contenido

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.

0Lesungen

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»
  1. Melden Sie sich an der Proxmox VE-Webkonsole an.
  2. Wählen Sie die virtuelle Maschine im linken Seitenmenü aus.
  3. Navigieren Sie zur Registerkarte Hardware.
  4. Klicken Sie auf die Dropdown-Schaltfläche Add und wählen Sie Serial Port.
  5. Fügen Sie den seriellen Anschluss hinzu, indem Sie den Index 0 (Serial 0) zuweisen.
  6. Wählen Sie die Grafikkarte Display im Hardware-Panel aus, klicken Sie auf Edit und ändern Sie den Treiber auf Serial terminal 0 (serial0).
  7. Klicken Sie auf OK.

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:

  1. Greifen Sie über eine temporäre SSH-Verbindung oder über die grafische noVNC-Konsole auf die virtuelle Maschine zu.
  2. Bearbeiten Sie die GRUB-Boot-Manager-Konfigurationsdatei:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Suchen Sie die Richtlinie GRUB_CMDLINE_LINUX_DEFAULT und fügen Sie die seriellen Konsolenparameter (tty0 und ttyS0 bei 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"
  4. Änderungen speichern (Strg + O, mit Enter bestätigen und mit Strg + X beenden).
  5. Aktualisieren Sie die GRUB-Manager-Richtlinien auf der Startpartition:
    Ventana de terminal
    sudo update-grub
  6. Starten Sie das Betriebssystem der virtuellen Maschine neu, um die Kernel-Rekonfiguration anzuwenden:
    Ventana de terminal
    sudo reboot

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.

  1. Wählen Sie Ihren LXC-Container im linken Seitenbaum von Proxmox aus.
  2. Navigieren Sie zur Registerkarte Options.
  3. Wählen Sie die Option Console mode und doppelklicken Sie darauf.
  4. Ändern Sie den Wert von Default in Shell.
  5. Klicken Sie auf OK.
  6. 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:

  1. Navigieren Sie zur oberen rechten Menüleiste der virtuellen Maschine oder des Containers und klicken Sie auf die Dropdown-Schaltfläche Console.
  2. Da der Bildschirm im seriellen Modus konfiguriert ist, verbindet sich die Webkonsole automatisch mit dem xterm.js-Terminal.
  3. 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.

  • ✓ 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.