Skip to Content
Vm ManagementBrowser-VM-Konsole

Browser-VM-Konsole

Die OpenFactory-Konsole enthält ein noVNC-basiertes Browser-Display für laufende virtuelle Maschinen. Es kann Boot-Ausgabe und grafische Desktops zeigen und Tastatur- sowie Pointer-Eingabe weiterleiten, ohne einen rohen VNC-Port dem Browser zu exposen.

Konsole öffnen

Laufende VM aus Topologie oder VM-Liste öffnen, dann Console wählen. Die UI authorisiert das WebSocket für aktuellen User und VM, bevor es zum host-local VNC endpoint proxied wird.

Es gibt keinen dokumentierten stabilen Deep-Link-Contract für einen Console-Dialog. VM-Controls in der Anwendung nutzen statt URLs zu konstruieren.

Verfügbare Controls

Die aktuelle Desktop-Konsole bietet:

  • Tastatur- und Maus-Eingabe;
  • On-Screen-Keyboard;
  • Ctrl+Alt+Del;
  • Fit-to-viewport scaling;
  • reconnect;
  • fullscreen; und
  • close.

Die Mobile-Ansicht bietet Touch-Pointer-Controls, left/right click, Joystick und Software-Tastatur des Geräts. Mobile VNC ist auf noVNC-Layer view-only; separate Mobile-Controls senden Input.

Clipboard sync, wählbare Quality modes, guest-driven resolution changes, Audio-Controls, arbitrary special-key menus und Serial-Console-UI sind nicht Teil der aktuellen VNC-Komponente. Verlassen Sie sich nicht auf dieses Verhalten.

Verbindungszustände

Der Dialog unterscheidet connecting, connected, reconnecting/booting und disconnected/error. Ein erfolgreicher WebSocket-Handshake kann eintreten, bevor der Gast den ersten Non-Black-Frame zeichnet; die Konsole zeigt Booting-Overlay und retries mit bounded backoff.

Hat die VM kein VNC display, ist stopped, fehlt oder verhindert eine exclusive session die Verbindung, schließt das Backend das WebSocket mit spezifischem Grund und der Dialog zeigt retry oder error state.

Sicherheitsgrenze

  • Die produktive Browser-Verbindung nutzt authenticated WebSocket over TLS.
  • Das Backend verifiziert VM-Zugriff vor Öffnen des VNC-Proxy.
  • Der Proxy verbindet nur zum auf dem Virtualization host aufgelösten VNC-Port.
  • Schließen des Browser-Dialogs beendet diese Browser-Session; stoppt die VM nicht.

Konsolen-Zugriff entspricht physischem Zugriff auf Gast-Display und Tastatur. Keine Geheimnisse on screen exposen, Gast sperren wenn fertig, ungenutzte Konsolen schließen.

Fehlerbehebung

Connected but black

Der Gast bootet ggf. noch. Boot-Overlay abwarten vor forced reconnect. Erscheint nach Retry-Fenster kein Frame, bestätigen, dass VM läuft und VNC graphics device hat.

Input erreicht Gast nicht

Viewport klicken zum Fokussieren. Auf Mobile explizite Pointer- und Keyboard-Controls der Konsole nutzen. Ist Gast locked, Ctrl+Alt+Del senden, wo das Gast-OS es unterstützt.

Wiederholte Disconnects

Andere Console-Session für dieselbe VM schließen, VM läuft noch verifizieren, retry. Persistente Failures mit VM-ID, Timestamp, connection state und angezeigtem Fehler melden; nie Session-Tokens einschließen.

Langsames Display

Gast-Auflösung reduzieren und Host/Network-Load prüfen. Die aktuelle Komponente nutzt immer fit-to-viewport scaling und exposiert keinen Quality selector.

Netzwerk-Topologie