Presto Edge Visão Geral O Presto Edge  é 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 Presto 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 Presto Edge : roteamento pelo IP do colaborador Importante: Como o Presto 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 Presto Edge acompanha a conexão do usuário. 2. Pré-Requisitos Antes de instalar o Presto Edge , 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 Presto 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 Presto Edge 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 Presto 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 Presto Edge não conseguirá iniciar corretamente. É importante também que o Docker esteja configurado para iniciar junto com o Windows como na imagem abaixo:   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 Presto 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= 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 Presto 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 Presto Edge via Docker Desktop Após a instalação, é possível monitorar e gerenciar o Presto 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 Presto 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 Presto 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 Presto Edge (ou VPN) está instalado e configurado na máquina do usuário. 41. Funcionamento: Confirma se o Presto Edge/VPN tem acesso ativo à internet. 42. Equivalência de IP: Verifica se o IP do Presto 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 Presto 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 Presto 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 Presto 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 + Presto Edge nas máquinas dos colaboradores Garante redundância e continuidade mesmo com oscilações Clientes corajosos 1 ou mais Presto 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 Presto Edge por Colaborador vs. Presto Edge Centralizado Uma dúvida comum é se basta instalar 1 único Presto Edge para toda a empresa ou se é necessário 1  Presto Edge por colaborador . Veja as considerações a seguir: • O Presto busca automaticamente qualquer Presto Edge associado à conta do usuário que esteja com o mesmo IP. • Se ao menos 1 Presto Edge for encontrado com o IP correto, o acesso funciona. • Um Presto 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 Presto Edge centralizado é arriscado — oscilações de conexão entre o Presto Edge e a infraestrutura podem interromper o serviço. • O cenário ideal é 1 Presto 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 Presto Edge em servidor centralizado da empresa, conectado à infraestrutura da Oystr. 45. Instalação do Presto 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 Presto 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 Presto Edge instalado localmente Instalar o Presto 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 Presto Edge instalado mas login no tribunal falha Tribunal exige IP específico e o Presto 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.