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:

  1. Vaya a la sección Roles
  2. Seleccione el rol requerido
  3. Encuentre el campo access_vnc y marque las casillas de Lectura y Actualización
  4. Guarde

(Si no tiene derechos para editar roles, contacte al administrador)

Uso de VNC#

Método 1: Conectarse al robot desde la tabla#

  1. Vaya a la sección Robots
  2. En la fila del robot requerido, haga clic en el icono del monitor (columna más a la derecha)
  3. 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#

  1. Abra en el navegador: https://SU_ORCHESTRATOR/main/vnc-viewer

  2. Complete 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