Skip to Content
Vm ManagementБраузерна консоль VM

Браузерна консоль VM

OpenFactory console includes noVNC-based browser display for running virtual machines. It can show boot output and graphical desktops and forward keyboard and pointer input without exposing raw VNC port to browser.

Open a console

Open running VM from topology or VM list, then choose Console. UI authorizes WebSocket for current user and VM before proxying to host-local VNC endpoint.

No documented stable deep-link contract for console dialog. Use VM controls in application rather than constructing URL.

Available controls

Current desktop console provides:

  • keyboard and mouse input;
  • on-screen keyboard;
  • Ctrl+Alt+Del;
  • fit-to-viewport scaling;
  • reconnect;
  • fullscreen; and
  • close.

Mobile view provides touch pointer controls, left/right click, joystick, and device software keyboard. Mobile VNC is view-only at noVNC layer; separate mobile controls send input.

Clipboard synchronization, selectable quality modes, guest-driven resolution changes, audio controls, arbitrary special-key menus, and serial-console UI are not part of current VNC component. Do not rely on those behaviors.

Connection states

Dialog distinguishes connecting, connected, reconnecting/booting, and disconnected/error states. Successful WebSocket handshake can occur before guest drawn first non-black frame, so console shows booting overlay and retries with bounded backoff.

If VM has no VNC display, is stopped, is missing, or another exclusive session prevents connection, backend closes WebSocket with specific reason and dialog presents retry or error state.

Security boundary

  • Production browser connection uses authenticated WebSocket over TLS.
  • Backend verifies VM access before opening VNC proxy.
  • Proxy connects only to VNC port resolved on virtualization host.
  • Closing browser dialog ends that browser session; it does not stop VM.

Console access equivalent to physical access to guest display and keyboard. Avoid exposing secrets on screen, lock guest when finished, close consoles you are not using.

Troubleshooting

Connected but black

Guest may still be booting. Wait for boot overlay before forcing reconnect. If no frame appears after retry window, confirm VM running and has VNC graphics device.

Input does not reach the guest

Click viewport to focus. On mobile use console explicit pointer and keyboard controls. If guest locked send Ctrl+Alt+Del where guest OS supports it.

Repeated disconnects

Close another console session for same VM, verify VM still running, retry. Persistent failures report with VM ID, timestamp, connection state, displayed error; never include session tokens.

Slow display

Reduce guest display resolution and check host/network load. Current component always uses fit-to-viewport scaling and does not expose quality selector.

Мережева топологія