Console VM en el navegador
El console OpenFactory incluye una pantalla en navegador basada en noVNC para máquinas virtuales en ejecución. Puede mostrar salida de arranque y escritorios gráficos y reenviar entrada de teclado y puntero sin exponer un puerto VNC en bruto al navegador.
Abrir un console
Abre una VM en ejecución desde la topología o la lista de VM, luego elige Console. La UI autoriza el WebSocket para el usuario y la VM actuales antes de hacer proxy al endpoint VNC local del host.
No hay un contrato documentado estable de deep link para un diálogo de console. Usa los controles VM de la aplicación en lugar de construir una URL.
Controles disponibles
El console de escritorio actual proporciona:
- entrada de teclado y ratón;
- teclado en pantalla;
- Ctrl+Alt+Del;
- escalado fit-to-viewport;
- reconectar;
- pantalla completa; y
- cerrar.
La vista móvil proporciona controles de puntero táctil, clic izquierdo/derecho, joystick y teclado software del dispositivo. VNC móvil es solo visualización en la capa noVNC; los controles móviles separados envían entrada.
La sincronización del portapapeles, modos de calidad seleccionables, cambios de resolución impulsados por el guest, controles de audio, menús de teclas especiales arbitrarios y una UI de console serial no forman parte del componente VNC actual. No confíes en esos comportamientos.
Estados de conexión
El diálogo distingue estados connecting, connected, reconnecting/booting y disconnected/error. Un handshake WebSocket exitoso puede ocurrir antes de que el guest haya dibujado su primer fotograma no negro, así que el console muestra una superposición de arranque y reintenta con backoff acotado.
Si la VM no tiene pantalla VNC, está detenida, falta o otra sesión exclusiva impide la conexión, el backend cierra el WebSocket con una razón específica y el diálogo presenta estado de reintento o error.
Límite de seguridad
- La conexión del navegador en producción usa WebSocket autenticado sobre TLS.
- El backend verifica acceso a la VM antes de abrir el proxy VNC.
- El proxy conecta solo al puerto VNC resuelto en el host de virtualización.
- Cerrar el diálogo del navegador termina esa sesión del navegador; no detiene la VM.
El acceso al console equivale a acceso físico a la pantalla y teclado del guest. Evita exponer secretos en pantalla, bloquea el guest al terminar y cierra consoles que no uses.
Solución de problemas
Conectado pero pantalla negra
El guest puede seguir arrancando. Espera la superposición de arranque antes de forzar reconexión. Si no aparece ningún fotograma tras la ventana de reintento, confirma que la VM está en ejecución y tiene dispositivo gráfico VNC.
La entrada no llega al guest
Haz clic en el viewport para enfocarlo. En móvil, usa los controles explícitos de puntero y teclado del console. Si el guest está bloqueado, envía Ctrl+Alt+Del donde el SO guest lo admita.
Desconexiones repetidas
Cierra otra sesión de console para la misma VM, verifica que la VM sigue en ejecución y reintenta. Los fallos persistentes deben reportarse con el ID de VM, marca de tiempo, estado de conexión y error mostrado; nunca incluyas tokens de sesión.
Pantalla lenta
Reduce la resolución de pantalla del guest y comprueba carga del host/red. El componente actual siempre usa escalado fit-to-viewport y no expone selector de calidad.