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:
- Acesse a seção Funções
- Selecione a função desejada
- Localize o campo access_vnc e marque as caixas de Leitura e Atualização
- 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#
- Acesse a seção Robôs
- Na linha do robô desejado, clique no ícone do monitor (coluna mais à direita)
- 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#
Abra no navegador:
https://SEU_ORCHESTRATOR/main/vnc-viewerPreencha 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 |