Edge Proxy
- Visão Geral
O Edge Proxy é um componente do ecossistema Presto que resolve um problema crítico de acesso: alguns tribunais e sistemas jurídicos validam o IP de origem da requisição de login, exigindo que ele seja o mesmo da rede do usuário ou do escritório.
Ao instalar o Edge na máquina do colaborador (ou em um servidor da rede do escritório), o Presto consegue rotear o tráfego pelo IP correto, garantindo que o acesso ao tribunal ocorra com o mesmo endereço IP do usuário.
Figura 1 — Arquitetura do Edge Proxy: roteamento pelo IP do colaborador
|
Importante: Como o Edge roda na mesma máquina (ou na mesma rede) do usuário, o Presto acessa o tribunal com o mesmo IP do colaborador. Isso funciona tanto no escritório quanto em home office, pois o Edge acompanha a conexão do usuário. |
2. Pré-Requisitos
Antes de instalar o Edge Proxy, certifique-se de que os seguintes requisitos estão atendidos:
|
Requisito |
Detalhe |
|
Sistema Operacional |
Windows 10 ou superior, macOS, ou Linux |
|
Virtualização habilitada na BIOS/UEFI |
Obrigatório para WSL2 — deve ser verificado e habilitado antes de qualquer instalação |
|
WSL2 com Ubuntu 24.04 |
Obrigatório para Windows — deve ser instalado antes do Docker Desktop |
|
Docker Desktop |
Versão mais recente — instalado como Administrador após o WSL2 |
|
Inicialização automática |
Docker Desktop configurado para iniciar com o Windows |
|
Permissão de Administrador |
Necessária para instalação e configuração do Docker Desktop |
|
Conexão com a Internet |
Necessária para download da imagem do container do Edge |
|
Acesso ao Console Presto |
Conta com acesso a console.presto.oystr.com.br para obter o comando de instalação |
3. Passo 0 — Verificar e Habilitar a Virtualização (Windows)
O WSL2 e o Docker Desktop dependem do recurso de virtualização de hardware da CPU. Antes de iniciar a instalação, é necessário confirmar que este recurso está habilitado no Windows e na BIOS/UEFI da máquina.
|
Este passo é necessário apenas para Windows. Usuários de macOS e Linux podem pular para a Seção 5. |
3.1 Verificar se a Virtualização está Habilitada
Para checar rapidamente se a virtualização já está ativa na máquina:
1. Pressione Ctrl + Shift + Esc para abrir o Gerenciador de Tarefas.
2. Clique na aba Desempenho e selecione CPU no painel esquerdo.
3. No painel direito, verifique o campo Virtualização: se estiver como Habilitada, está tudo certo — pule para a Seção 4.
4. Se estiver como Desabilitada, siga os passos da Seção 3.2 para habilitar.
Alternativamente, você pode verificar via PowerShell executando o comando:
|
systeminfo | findstr /I "Virtualization" |
Se o resultado mostrar A hypervisor has been detected, a virtualização já está ativa.
3.2 Habilitar a Virtualização pela BIOS/UEFI
Caso a virtualização esteja desabilitada, é necessário acessar a BIOS/UEFI da máquina para ativá-la. O processo varia conforme o fabricante:
|
Fabricante |
Tecla de Acesso à BIOS |
Onde encontrar a opção |
|
Dell |
F2 ou F12 |
Advanced > CPU Configuration > Virtualization Technology |
|
HP |
F10 ou Esc |
Advanced > System Options > Virtualization Technology (VTx) |
|
Lenovo |
F1, F2 ou Delete |
Security > Virtualization ou Advanced > CPU Setup |
|
ASUS |
Delete ou F2 |
Advanced > CPU Configuration > Intel Virtualization Technology |
|
Acer |
F2 ou Delete |
Main > Virtualization Technology |
|
MSI |
Delete |
OC > CPU Features > Intel Virtualization Tech |
|
Atenção: A tecla de acesso à BIOS deve ser pressionada imediatamente ao ligar o computador, antes do Windows começar a carregar. O nome exato da opção pode variar mesmo entre modelos do mesmo fabricante. |
3.3 Passo a passo para acessar a BIOS/UEFI
5. Reinicie o computador.
6. Pressione repetidamente a tecla de acesso à BIOS do seu fabricante (consulte a tabela acima) assim que a tela do fabricante aparecer.
7. Dentro da BIOS, navegue até a seção de Advanced, CPU Configuration ou equivalente.
8. Localize a opção Virtualization Technology, Intel VT-x, AMD-V ou similar.
9. Altere o valor para Enabled.
10. Salve as alterações (geralmente F10) e reinicie o computador.
3.4 Habilitar Virtualização pelo Windows (Plataforma de Máquina Virtual)
Além da BIOS, é necessário garantir que o recurso Plataforma de Máquina Virtual esteja ativado no próprio Windows:
11. Pressione Win + R, digite optionalfeatures e pressione Enter.
12. Na janela Recursos do Windows, localize e marque as seguintes opções:
◦ Plataforma de Máquina Virtual (Virtual Machine Platform)
◦ Subsistema do Windows para Linux (Windows Subsystem for Linux)
13. Clique em OK e aguarde a instalação. Reinicie o computador quando solicitado.
|
Dica: Se ao tentar instalar o WSL você receber um erro como 'WSL 2 requires an update to its kernel component' ou '0x80370102', é sinal de que a virtualização ainda está desabilitada na BIOS ou que o recurso Plataforma de Máquina Virtual não foi ativado. |
4. Passo 1 — Instalar o Ubuntu 24.04 via WSL (Windows)
O Edge Proxy roda dentro de um container Docker que utiliza o WSL2 (Windows Subsystem for Linux) como base. Por isso, antes de instalar o Docker Desktop, é necessário instalar o Ubuntu 24.04 via WSL no Windows.
|
Este passo é necessário apenas para Windows. Usuários de macOS e Linux podem pular para a Seção 4. |
3.1 Como instalar o Ubuntu 24.04 via WSL
14. Abra o PowerShell como Administrador (clique com o botão direito no menu Iniciar > Windows PowerShell (Admin)).
15. Execute o comando abaixo para instalar o WSL com Ubuntu 24.04:
|
wsl --install -d Ubuntu-24.04 |
16. Aguarde o download e a instalação. O sistema poderá solicitar uma reinicialização.
17. Após reiniciar, o Ubuntu abrirá automaticamente — defina um nome de usuário e senha quando solicitado.
18. Para verificar se a instalação foi bem-sucedida, execute no PowerShell:
|
wsl --list --verbose |
O Ubuntu-24.04 deve aparecer na lista com status Running e versão 2.
Para um passo a passo visual completo, assista: Instalação do Ubuntu 24.04 via WSL no Windows (YouTube)
5. Passo 2 — Instalar o Docker Desktop
Com o WSL2 e o Ubuntu 24.04 instalados, o próximo passo é instalar o Docker Desktop. O Edge é um container Docker e o Docker Desktop é o ambiente que o executa no Windows.
4.1 Download e Instalação
19. Acesse o site oficial: https://docs.docker.com/desktop/setup/install/windows-install/
20. Execute o instalador como Administrador (clique com o botão direito > Executar como Administrador).
21. Durante a instalação, mantenha marcada a opção de iniciar o Docker Desktop ao iniciar o Windows.
22. Ao final, abra o Docker Desktop > Settings > General e confirme que Use the WSL 2 based engine está ativado.
23. Verifique se o ícone do Docker aparece na barra de tarefas com status Engine running.
|
Atenção: O Docker Desktop deve ser instalado obrigatoriamente como Administrador. Caso contrário, o container do Edge não conseguirá iniciar corretamente. |
Para um passo a passo visual completo, assista: Instalação do Docker Desktop no Windows (YouTube)
6. Passo 3 — Obter o Comando no Console Presto
O comando para iniciar o container do Edge é personalizado por usuário/máquina e deve ser obtido diretamente no Console do Presto. Cada proxy possui um identificador único (EDGE_NAME) que vincula o container ao usuário correto.
5.1 Acessando a lista de Proxies
24. Acesse console.presto.oystr.com.br/proxies e faça login com sua conta Presto.
25. Na tela de Proxies, localize o proxy correspondente à sua máquina ou usuário.
26. Se não existir um proxy cadastrado para você, clique em Adicionar novo proxy para criar um.
Figura 2 — Tela de listagem de Proxies no Console Presto
5.2 Copiando o Comando Docker
27. Clique no botão Configuração ao lado do proxy desejado.
28. No painel Detalhes do proxy, localize o campo Config — ele contém o comando Docker completo e personalizado para aquele proxy.
29. Clique em copiar para copiar o comando para a área de transferência.
Figura 3 — Painel de detalhes do proxy com o comando Docker personalizado
O comando tem o seguinte formato, onde EDGE_NAME é o identificador único daquele proxy:
|
docker run -d --name presto-edge --restart unless-stopped --env EDGE_NAME=<nome_do_proxy> leandrocruz/edge-proxy:v0.0.1 |
|
IMPORTANTE: O EDGE_NAME deve ser único. Nunca execute o mesmo comando (com o mesmo EDGE_NAME) em mais de uma máquina simultaneamente. Isso causará conflito na identificação do proxy e pode impedir o funcionamento correto do Presto. |
7. Passo 4 — Executar o Comando no Terminal Ubuntu
Com o comando copiado do Console, execute-o no terminal do Ubuntu (WSL) para iniciar o container do Edge.
6.1 Abrindo o Terminal Ubuntu
30. Pressione Win + S e pesquise por Ubuntu.
31. Abra o aplicativo Ubuntu 24.04 instalado via WSL.
32. Cole o comando copiado do Console e pressione Enter.
6.2 Verificando se o Container Subiu
33. Abra o Docker Desktop.
34. Clique em Containers no menu lateral esquerdo.
35. Localize o container presto-edge — o indicador deve estar verde, indicando que está ativo.
Figura 4 — Painel de Containers do Docker Desktop com o presto-edge ativo
8. Gerenciamento do Edge via Docker Desktop
Após a instalação, é possível monitorar e gerenciar o Edge diretamente pelo Docker Desktop.
7.1 Visualizando Logs e Status
Clique no nome do container presto-edge para acessar a tela de detalhes. Nesta tela é possível:
• Visualizar os logs em tempo real do Edge
• Verificar o status da conexão com a infraestrutura Presto
• Identificar eventuais erros de conectividade (exibidos em amarelo nos logs)
Figura 5 — Tela de logs do container presto-edge no Docker Desktop
|
Dica: Linhas de log em amarelo indicam dificuldade de conexão com a infraestrutura. Neste caso, utilize o botão de restart (destacado na imagem) para reconectar. |
7.2 Reiniciando o Container
Caso o Edge apresente falhas de conexão, o primeiro passo é reiniciá-lo:
36. Acesse a tela de detalhes do container presto-edge no Docker Desktop.
37. Clique no botão de Restart (ícone circular com seta) no canto superior direito da tela.
38. Aguarde alguns segundos e observe os logs — o Edge deverá reconectar à infra automaticamente.
39. Após reconectar, teste a conexão usando o botão Testar VPN na extensão do Presto.
9. Botão Testar VPN
O botão Testar VPN está disponível no diálogo de login da extensão do Presto e serve para validar a configuração do proxy antes de realizar o login no tribunal.
Figura 6 — Diálogo de login da extensão Presto com o botão Testar VPN
8.1 O que é testado
Ao clicar em Testar VPN, o sistema valida automaticamente os seguintes pontos:
40. Configuração: Verifica se o Edge (ou VPN) está instalado e configurado na máquina do usuário.
41. Funcionamento: Confirma se o Edge/VPN tem acesso ativo à internet.
42. Equivalência de IP: Verifica se o IP do Edge/VPN é o mesmo IP do usuário.
|
Nota: A igualdade de IP é exigida apenas em alguns tribunais. Na maioria dos casos, o Presto funciona mesmo que os IPs sejam diferentes. |
8.2 Resultado do Teste
Quando os 3 testes passam, o botão fica com indicação visual de sucesso. Se o IP for diferente, o botão sinaliza a divergência — mas isso não impede o funcionamento do Presto na maioria dos tribunais.
Quando o cliente não possui VPN ou Edge configurado, o tráfego cai na VPN/Proxy compartilhada da Oystr (IP: 177.220.183.60). Neste caso, se houver dificuldade de acesso, recomenda-se adotar uma das soluções descritas na seção 10.
10. Cenários de Implantação Recomendados
A instalação do Edge pode ser feita de diferentes formas dependendo do tamanho e perfil do cliente. A tabela abaixo resume as recomendações:
|
Perfil do Cliente |
Recomendação |
Observação |
|
Clientes menores |
Edge instalado em todos os computadores dos usuários do Presto |
Solução mais simples e robusta para equipes pequenas |
|
Clientes maiores |
Container/VPN centralizado + Edge nas máquinas dos colaboradores |
Garante redundância e continuidade mesmo com oscilações |
|
Clientes corajosos |
1 ou mais Edges em máquinas fixas do escritório |
Funciona apenas se a máquina com o Edge estiver ligada e com o mesmo IP do usuário |
7.1 Edge por Colaborador vs. Edge Centralizado
Uma dúvida comum é se basta instalar 1 único Edge para toda a empresa ou se é necessário 1 Edge por colaborador. Veja as considerações a seguir:
• O Presto busca automaticamente qualquer Edge associado à conta do usuário que esteja com o mesmo IP.
• Se ao menos 1 Edge for encontrado com o IP correto, o acesso funciona.
• Um Edge centralizado não funciona em home office (sem VPN), pois o IP do colaborador será diferente do IP do Edge.
• Depender de apenas 1 Edge centralizado é arriscado — oscilações de conexão entre o Edge e a infraestrutura podem interromper o serviço.
• O cenário ideal é 1 Edge instalado em cada máquina de colaborador que usa o Presto.
11. Opções para Resolver Problemas de IP
Quando um usuário apresenta dificuldade de acesso por divergência de IP, existem 3 opções para resolver o problema:
43. Configuração de VPN dedicada com a Oystr — recomendado para clientes maiores que necessitam de um IP fixo e estável.
44. Container Docker centralizado — implantação de um container Edge em servidor centralizado da empresa, conectado à infraestrutura da Oystr.
45. Instalação do Edge na máquina do colaborador — solução mais prática e indicada para a maioria dos cenários.
12. Solução de Problemas (Troubleshooting)
|
Problema |
Causa Provável |
Solução |
|
Edge não aparece na lista de containers |
Docker Desktop não foi iniciado |
Abra o Docker Desktop e aguarde o status "Engine running" |
|
Logs exibem linhas em amarelo |
Falha de conexão com a infraestrutura Presto |
Clique no botão Restart do container no Docker Desktop |
|
Botão "Testar VPN" indica IP diferente |
Usuário em home office sem Edge instalado localmente |
Instalar o Edge na máquina do colaborador ou configurar VPN |
|
Container para após reiniciar o PC |
Parâmetro --restart always não foi usado na criação |
Recrie o container com o parâmetro --restart always |
|
Edge instalado mas login no tribunal falha |
Tribunal exige IP específico e o Edge não está naquela rede |
Verificar junto ao suporte Oystr a necessidade de VPN dedicada |
13. Suporte
Em caso de dúvidas ou problemas não resolvidos pelo troubleshooting acima, entre em contato com a equipe de suporte Presto/Oystr para verificação dos logs e avaliação da melhor estratégia de implantação para o seu ambiente.
|
Este documento é de uso interno e deve ser compartilhado com os responsáveis técnicos de TI do cliente para realização da instalação. |