VNC#

Uso do VNC#

VNC (Virtual Network Computing) é uma tecnologia de área de trabalho remota. Permite visualizar a tela do computador do robô e controlá-lo com o mouse e o teclado pelo navegador.

Como funciona#

Navegador do usuário
    │ WebSocket (porta 6080-6100)
    ▼
orchestrator-vnc-proxy (websockify)
    │ TCP (porta VNC, geralmente 5900)
    ▼
Servidor VNC no computador do robô

O usuário clica no botão → o Orchestrator cria uma conexão proxy via websockify → o navegador se conecta à tela do robô.

Preparação#

1. Cada robô deve ter um servidor VNC#

Instale um servidor VNC no computador do robô.

  • A configuração de senha e porta é feita nas configurações do Assistente, na aba "Execução/Servidor VNC"

Campos para preencher no Assistente:

  • Porta VNC do Robô
  • Senha VNC
  • Caixa de seleção "Iniciar servidor VNC ao iniciar o robô"
  • Caixa de seleção "Iniciar automaticamente o servidor VNC ao iniciar o robô Unattended"

Certifique-se de que o servidor VNC esteja em execução, a porta 5900 esteja aberta no firewall do computador do robô e a senha VNC esteja definida.

2. Preencha os dados de VNC na ficha do robô#

No Orchestrator, abra a ficha do robô (edição) e preencha os campos:

Campo Descrição Exemplo
Machine IP Endereço IP do computador do robô. Se o servidor VNC não estiver na porta 5900, especifique a porta após dois-pontos 192.168.1.100 ou 192.168.1.100:5901
Machine Login Login para VNC (se o servidor VNC exigir) admin
Machine Password Senha do servidor VNC no robô (não confundir com a senha do Orchestrator nem com a senha da conta do Windows!) vnc_pass_123

Onde obter a senha: A senha é definida durante a instalação do servidor VNC no computador do robô. É uma senha VNC separada, NÃO a senha do usuário do Windows e NÃO a senha da conta no Orchestrator.

3. Permissões de acesso dos usuários#

A função do usuário deve ter a permissão VNC (access_vnc) com direitos de Leitura e Atualização:

  1. Acesse a seção Funções
  2. Selecione a função desejada
  3. Localize o campo access_vnc e marque as caixas de Leitura e Atualização
  4. Salve

(Se você não tiver direitos para editar funções, entre em contato com o administrador)

Uso do VNC#

Método 1: Conectar-se ao robô a partir da tabela#

  1. Acesse a seção Robôs
  2. Na linha do robô desejado, clique no ícone do monitor (coluna mais à direita)
  3. Uma nova aba será aberta com a tela do robô

Se os campos Machine IP, Machine Login e Machine Password estiverem preenchidos na ficha do robô, a conexão ocorrerá automaticamente. Caso contrário, será exibido um formulário para entrada manual.

Método 2: Conectar-se manualmente via VNC Viewer#

  1. Abra no navegador: https://SEU_ORCHESTRATOR/main/vnc-viewer

  2. Preencha o formulário:

    Campo O que inserir
    VNC Server (host:port) Endereço IP do robô e porta VNC (ex.: 192.168.1.100:5900)
    Senha Senha VNC
    Login (opcional) Login, se exigido pelo servidor VNC

Desconexão#

  • Clique no botão vermelho "Desconectar" no canto superior esquerdo
  • Ou simplesmente feche a aba do navegador

O serviço proxy será interrompido automaticamente e liberará a porta.

Variáveis de ambiente VNC (.env)#

Variável Padrão Descrição
VNC_HOST orchestrator-vnc-proxy Endereço do serviço proxy VNC
VNC_PORT 5000 Porta da API do proxy VNC
VNC_LOG_LEVEL INFO Nível de log
VNC_START_PORT 6080 Porta inicial para conexões proxy
VNC_MAX_PORTS 100 Máximo de conexões simultâneas

Lista de portas#

Porta Finalidade
5000 API do proxy VNC (interno, de contêiner para contêiner)
6080-6100 Proxy WebSocket para sessões VNC (navegador → websockify)
5900 Porta padrão do servidor VNC no robô

Possíveis problemas#

Problema Causa Solução
Ícone do monitor está cinza Sem permissão access_vnc Conceda permissões na seção Funções
"API do proxy VNC não encontrado" orchestrator-vnc-proxy não iniciado Verifique o status do contêiner vnc docker-compose ps
"Erro de segurança VNC: senha incorreta" Senha VNC incorreta Verifique o campo Machine Password na ficha do robô
"Servidor VNC não responde" Robô desligado ou VNC não está em execução Verifique o robô e o servidor VNC nele
Tela preta após a conexão Tela do robô bloqueada Verifique se a sessão gráfica está ativa