Console de VM no navegador
O console OpenFactory inclui display no navegador baseado em noVNC para máquinas virtuais em execução. Pode mostrar saída de boot e desktops gráficos e encaminhar teclado e ponteiro sem expor porta VNC raw ao navegador.
Abrir um console
Abra VM em execução pela topologia ou lista de VMs, depois escolha Console. A UI autoriza WebSocket para usuário e VM atuais antes de fazer proxy ao endpoint VNC local do host.
Não há contrato documentado estável de deep-link para diálogo de console. Use controles de VM na aplicação em vez de construir URL.
Controles disponíveis
O console desktop atual fornece:
- input de teclado e mouse;
- teclado na tela;
- Ctrl+Alt+Del;
- scaling fit-to-viewport;
- reconnect;
- fullscreen; e
- close.
A view mobile fornece controles de ponteiro touch, clique esquerdo/direito, joystick e teclado software do dispositivo. VNC mobile é view-only na camada noVNC; controles mobile separados enviam input.
Sincronização de clipboard, modos de qualidade selecionáveis, mudanças de resolução driven pelo guest, controles de áudio, menus arbitrários de teclas especiais e UI de console serial não fazem parte do componente VNC atual. Não dependa desses comportamentos.
Estados de conexão
O diálogo distingue connecting, connected, reconnecting/booting e disconnected/error. Handshake WebSocket bem-sucedido pode ocorrer antes do guest desenhar primeiro frame não preto; o console mostra overlay de booting e retries com backoff limitado.
Se VM não tem display VNC, está stopped, está missing ou outra sessão exclusiva impede conexão, backend fecha WebSocket com motivo específico e diálogo apresenta retry ou estado de erro.
Limite de segurança
- Conexão de navegador em produção usa WebSocket autenticado sobre TLS.
- Backend verifica acesso à VM antes de abrir proxy VNC.
- Proxy conecta só à porta VNC resolvida no host de virtualização.
- Fechar diálogo no navegador encerra aquela sessão de navegador; não para a VM.
Acesso ao console equivale a acesso físico ao display e teclado do guest. Evite expor segredos na tela, bloqueie guest ao terminar e feche consoles que não está usando.
Solução de problemas
Conectado mas tela preta
Guest pode ainda estar booting. Aguarde overlay de boot antes de forçar reconnect. Se nenhum frame aparecer após janela de retry, confirme que VM está running e tem dispositivo gráfico VNC.
Input não chega ao guest
Clique no viewport para focar. No mobile, use controles explícitos de ponteiro e teclado do console. Se guest está locked, envie Ctrl+Alt+Del onde SO guest suporta.
Desconexões repetidas
Feche outra sessão de console para mesma VM, verifique que VM ainda está running e tente de novo. Falhas persistentes devem ser reportadas com ID da VM, timestamp, estado de conexão e erro exibido; nunca inclua session tokens.
Display lento
Reduza resolução de display do guest e verifique carga de host/rede. Componente atual sempre usa scaling fit-to-viewport e não expõe seletor de qualidade.