VNC#
Uso de VNC#
VNC (Virtual Network Computing) es una tecnología de escritorio remoto. Permite ver la pantalla del equipo del robot y controlarlo con el ratón y el teclado a través del navegador.
Cómo funciona#
Navegador del usuario
│ WebSocket (puerto 6080-6100)
▼
orchestrator-vnc-proxy (websockify)
│ TCP (puerto VNC, normalmente 5900)
▼
Servidor VNC en el equipo del robot
El usuario hace clic en el botón → el Orchestrator crea una conexión proxy a través de websockify → el navegador se conecta a la pantalla del robot.
Preparación#
1. Cada robot debe tener un servidor VNC#
Instale un servidor VNC en el equipo del robot.
- La configuración de la contraseña y el puerto se realiza en los ajustes del Asistente, en la pestaña "Ejecución/Servidor VNC"
Campos que completar en el Asistente:
- Puerto VNC del Robot
- Contraseña VNC
- Casilla "Iniciar servidor VNC al iniciar el robot"
- Casilla "Iniciar automáticamente el servidor VNC al iniciar el robot Unattended"
Asegúrese de que el servidor VNC esté en ejecución, el puerto 5900 esté abierto en el firewall del equipo del robot y la contraseña VNC esté establecida.
2. Complete los datos VNC en la ficha del robot#
En el Orchestrator, abra la ficha del robot (edición) y complete los campos:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Machine IP | Dirección IP del equipo del robot. Si el servidor VNC no está en el puerto 5900, indique el puerto separado por dos puntos | 192.168.1.100 o 192.168.1.100:5901 |
| Machine Login | Inicio de sesión para VNC (si el servidor VNC lo requiere) | admin |
| Machine Password | Contraseña del servidor VNC en el robot (¡no confundir con la contraseña del Orchestrator ni con la contraseña de la cuenta de Windows!) | vnc_pass_123 |
Dónde obtener la contraseña: La contraseña se establece al instalar el servidor VNC en el equipo del robot. Es una contraseña VNC independiente, NO la contraseña del usuario de Windows ni la contraseña de la cuenta en el Orchestrator.
3. Permisos de acceso de usuarios#
El rol del usuario debe tener el permiso VNC (access_vnc) con derechos de Lectura y Actualización:
- Vaya a la sección Roles
- Seleccione el rol requerido
- Encuentre el campo access_vnc y marque las casillas de Lectura y Actualización
- Guarde
(Si no tiene derechos para editar roles, contacte al administrador)
Uso de VNC#
Método 1: Conectarse al robot desde la tabla#
- Vaya a la sección Robots
- En la fila del robot requerido, haga clic en el icono del monitor (columna más a la derecha)
- Se abrirá una nueva pestaña con la pantalla del robot
Si los campos Machine IP, Machine Login y Machine Password están completos en la ficha del robot, la conexión se realizará automáticamente. En caso contrario, aparecerá un formulario para la entrada manual.
Método 2: Conectarse manualmente mediante VNC Viewer#
Abra en el navegador:
https://SU_ORCHESTRATOR/main/vnc-viewerComplete el formulario:
Campo Qué ingresar VNC Server (host:port) Dirección IP del robot y puerto VNC (por ejemplo, 192.168.1.100:5900)Contraseña Contraseña VNC Inicio de sesión (opcional) Inicio de sesión, si el servidor VNC lo requiere
Desconexión#
- Haga clic en el botón rojo "Desconectar" en la esquina superior izquierda
- O simplemente cierre la pestaña del navegador
El servicio proxy se detendrá automáticamente y liberará el puerto.
Variables de entorno VNC (.env)#
| Variable | Por defecto | Descripción |
|---|---|---|
VNC_HOST |
orchestrator-vnc-proxy |
Dirección del servicio proxy VNC |
VNC_PORT |
5000 |
Puerto API del proxy VNC |
VNC_LOG_LEVEL |
INFO |
Nivel de registro |
VNC_START_PORT |
6080 |
Puerto inicial para conexiones proxy |
VNC_MAX_PORTS |
100 |
Máximo de conexiones simultáneas |
Lista de puertos#
| Puerto | Propósito |
|---|---|
| 5000 | API del proxy VNC (interno, contenedor a contenedor) |
| 6080-6100 | Proxy WebSocket para sesiones VNC (navegador → websockify) |
| 5900 | Puerto estándar del servidor VNC en el robot |
Posibles problemas#
| Problema | Causa | Solución |
|---|---|---|
| El icono del monitor está en gris | Sin permiso access_vnc | Conceda permisos en la sección Roles |
| "API del proxy VNC no encontrado" | orchestrator-vnc-proxy no iniciado | Verifique el estado del contenedor vnc docker-compose ps |
| "Error de seguridad VNC: contraseña incorrecta" | Contraseña VNC incorrecta | Verifique el campo Machine Password en la ficha del robot |
| "El servidor VNC no responde" | El robot está apagado o VNC no está en ejecución | Verifique el robot y el servidor VNC en él |
| Pantalla negra tras la conexión | La pantalla del robot está bloqueada | Verifique si la sesión gráfica está activa |