Console VM browser
La console OpenFactory include un display browser basato su noVNC per macchine virtuali in esecuzione. Può mostrare output boot e desktop grafici e inoltrare input tastiera e puntatore senza esporre una porta VNC raw al browser.
Apri una console
Apri una VM in esecuzione dalla topologia o lista VM, poi scegli Console. L’UI autorizza il WebSocket per utente e VM correnti prima di fare proxy verso l’endpoint VNC locale host.
Non c’è un contratto deep-link documentato stabile per un dialog console. Usa i controlli VM nell’applicazione invece di costruire un URL.
Controlli disponibili
La console desktop corrente fornisce:
- input tastiera e mouse;
- tastiera on-screen;
- Ctrl+Alt+Del;
- scaling fit-to-viewport;
- reconnect;
- fullscreen; e
- close.
La vista mobile fornisce controlli puntatore touch, click sinistro/destro, joystick e tastiera software del dispositivo. VNC mobile è view-only al layer noVNC; i controlli mobile separati inviano input.
Sincronizzazione clipboard, modalità qualità selezionabili, cambi risoluzione guidati guest, controlli audio, menu tasti speciali arbitrari e UI console seriale non fanno parte del componente VNC corrente. Non affidarti a quei comportamenti.
Stati connessione
Il dialog distingue stati connecting, connected, reconnecting/booting e disconnected/error. Un handshake WebSocket riuscito può avvenire prima che il guest abbia disegnato il primo frame non nero, quindi la console mostra overlay booting e riprova con backoff delimitato.
Se la VM non ha display VNC, è fermata, manca o un’altra sessione esclusiva impedisce connessione, il backend chiude il WebSocket con motivo specifico e il dialog presenta stato retry o errore.
Confine sicurezza
- La connessione browser produzione usa WebSocket autenticato su TLS.
- Il backend verifica accesso VM prima di aprire il proxy VNC.
- Il proxy si connette solo alla porta VNC risolta sull’host virtualizzazione.
- Chiudere il dialog browser termina quella sessione browser; non ferma la VM.
Accesso console equivale ad accesso fisico a display e tastiera guest. Evita di esporre segreti a schermo, blocca il guest al termine e chiudi console che non usi.
Risoluzione problemi
Connesso ma nero
Il guest può essere ancora in boot. Attendi l’overlay boot prima di forzare reconnect. Se nessun frame appare dopo la finestra retry, conferma che la VM sia in esecuzione e abbia dispositivo graphics VNC.
L’input non raggiunge il guest
Clicca il viewport per focalizzarlo. Su mobile, usa controlli puntatore e tastiera espliciti della console. Se il guest è bloccato, invia Ctrl+Alt+Del dove il SO guest lo supporta.
Disconnessioni ripetute
Chiudi un’altra sessione console per la stessa VM, verifica che la VM sia ancora in esecuzione e riprova. Fallimenti persistenti vanno segnalati con ID VM, timestamp, stato connessione ed errore mostrato; non includere mai token sessione.
Display lento
Riduci risoluzione display guest e controlla carico host/rete. Il componente corrente usa sempre scaling fit-to-viewport e non espone selettore qualità.