Configurando Proxy Reverso no ServBay: Mapeie Sites Internos ou Remotos para Depuração Local

O ServBay é um ambiente de desenvolvimento web local compatível com macOS e Windows, integrando diversos ambientes de linguagem como PHP, Node.js, Python, Go, Java, além de bancos de dados como MySQL, PostgreSQL, MongoDB e Redis. Além de hospedar projetos de código local, o ServBay oferece uma poderosa funcionalidade de proxy reverso. Por meio do proxy reverso, você pode facilmente mapear sites web hospedados na sua rede interna, máquinas virtuais, containers ou até servidores remotos em seu ambiente local ServBay, simplificando os processos de desenvolvimento, depuração e acesso.

Este artigo explica em detalhes como configurar o proxy reverso no ServBay, ajudando você a mapear sites internos ou de endereços acessíveis para acesso local, proporcionando gerenciamento centralizado e desenvolvimento eficiente.

Visão Geral

Um servidor de proxy reverso recebe as requisições do cliente (por exemplo, seu navegador) e as encaminha para um ou mais servidores de backend (neste caso, o site interno ou remoto que você quer mapear). O ServBay utiliza seu servidor web integrado (Caddy ou Nginx) para esta função.

No contexto de desenvolvimento local, as principais vantagens de configurar um proxy reverso incluem:

• Entrada de acesso unificada: Acesse todos os seus recursos internos ou externos usando um domínio do ServBay local, sem a necessidade de memorizar endereços IP complexos ou portas.
• Configuração simplificada de SSL: Utilize o gerenciamento SSL do ServBay (como ServBay CA ou ACME) para habilitar HTTPS nos sites mapeados, mesmo se o backend suportar apenas HTTP.
• Depuração local: Depure facilmente aplicações web hospedadas remotamente ou internamente, diretamente no seu navegador local.
• Superação de restrições de rede: Em alguns casos, acesse recursos de redes corporativas ou ambientes restritos diretamente do seu ambiente de trabalho local, desde que a máquina com ServBay tenha acesso ao endereço desejado.

Pré-requisitos

Antes de começar a configurar o proxy reverso, certifique-se dos seguintes pontos:

1. ServBay instalado e em execução: Confirme que o ServBay está corretamente instalado e rodando em seu sistema macOS.
2. Acessibilidade do site desejado: O site interno ou remoto que você deseja mapear está funcionando normalmente, e a máquina macOS que executa o ServBay consegue acessá-lo diretamente via IP/domínio e porta. Por exemplo, se o destino for 192.168.1.100:8080, assegure-se de que seu macOS consiga dar ping em 192.168.1.100 e acessar 192.168.1.100:8080.

Passos para Adicionar um Site de Proxy Reverso

Veja abaixo os passos detalhados para configurar um site de proxy reverso no ServBay:

Passo 1: Abra o painel de gerenciamento do ServBay

Localize o ícone do ServBay na pasta de aplicativos do seu macOS e dê um duplo clique para iniciar o aplicativo.

Passo 2: Acesse o gerenciador de sites

Ao iniciar o ServBay, você verá a interface principal. No menu de navegação à esquerda, clique em Sites. Isso levará você para a página de gerenciamento, onde pode administrar todos os sites locais e de proxy reverso.

Passo 3: Adicione um novo site

Na parte inferior da página de gerenciador de sites, localize e clique no botão +. Após clicar, uma nova seção se expande à direita, permitindo configurar os detalhes do novo site.

Passo 4: Configure as opções de proxy reverso

No formulário do novo site, preencha as informações essenciais para definir o comportamento do proxy reverso:

1. Nome: Dê um nome facilmente identificável ao proxy reverso. Exemplo: Proxy do Backend Interno.
2. Domínio: Informe o domínio que deseja usar localmente para acessar o site mapeado. Exemplo: backend.servbay.demo ou proxy.to.local. O ServBay geralmente adiciona automaticamente o domínio inserido ao arquivo hosts do sistema, direcionando para 127.0.0.1 ou ::1.
3. Protocolo: Escolha o protocolo suportado pelo site. Normalmente selecione HTTP/HTTPS para suportar ambos. O ServBay gerenciará SSL conforme necessário.
4. Método de requisição de certificado SSL:
   • ServBay CA (recomendado para desenvolvimento local): O ServBay usará sua Autoridade Certificadora interna para gerar e gerenciar certificados SSL automaticamente para o domínio. É necessário confiar no certificado raiz do ServBay CA no navegador/sistema para evitar avisos.
   • ACME (Let's Encrypt): Caso seu domínio seja público e acessível na internet, opte por Let’s Encrypt para solicitar certificados SSL gratuitos.
   • Manual: Se possuir arquivos de certificado SSL (.crt, .key, .ca-bundle), você pode subir e configurar manualmente. Para desenvolvimento local e recursos internos, recomenda-se fortemente utilizar ServBay CA.
5. Tipo de site: Escolha Proxy Reverso. Esta é a configuração chave para habilitar proxy.
6. Destino do proxy: Informe o endereço completo do site interno ou remoto que deseja mapear. Pode ser formato IP:Porta ou uma URL completa.
   • Exemplo 1 (IP:Porta): 192.168.1.100:8080
   • Exemplo 2 (URL): http://192.168.1.100:8080
   • Exemplo 3 (hostname interno): backend.internal:8443 (desde que a máquina ServBay o resolva)
   • Exemplo 4 (URL remota): https://api.example.com Certifique-se de que o endereço informado seja acessível diretamente pela máquina rodando ServBay.

Passo 5: Finalize e salve a configuração

Após preencher todas as informações obrigatórias, clique no botão Adicionar ao fim do formulário. O ServBay irá salvar automaticamente a configuração e gerar as regras de proxy reverso no servidor web (Caddy ou Nginx).

Após o sucesso, você verá o novo site de proxy reverso listado.

Passo 6: Acesse o site de proxy reverso

Com a configuração pronta, basta digitar o domínio definido no passo 4 (ex: proxy.to.local ou backend.servbay.demo) no seu navegador para acessar o site interno/remoto mapeado.

Se estiver usando ServBay CA e ativou HTTPS, talvez enfrente um alerta de certificado no primeiro acesso (caso o certificado raiz do ServBay CA ainda não esteja confiado).

Passo 7: Atalhos para gerenciamento rápido

O ServBay oferece botões práticos para gerenciar cada site:

1. Abrir diretório raiz no IDE: Para sites de proxy reverso, este botão geralmente é irrelevante pois não há diretório local.
2. Abrir site no navegador: Acesse rapidamente o site usando o navegador padrão.
3. Ver logs do site: Explore os registros de acesso e erros do servidor web (Caddy/Nginx) para o site — crucial para depuração.
4. Pausar/ativar site: Habilite ou desabilite temporariamente a configuração de proxy reverso.
5. Remover site: Exclua o site de proxy reverso do ServBay.

Perguntas Frequentes (FAQ)

P: Não consigo acessar o site; aparece erro no navegador.

• Verifique o status do ServBay: Certifique-se de que o ServBay está rodando e o servidor web (Caddy/Nginx) está ativo.
• Verifique a resolução do domínio: Confirme se está inserindo o domínio corretamente no navegador e se está sendo resolvido para o IP local do ServBay (geralmente o ServBay atualiza o arquivo hosts automaticamente, mas confira se necessário).
• Consulte os logs do site no ServBay: Clique em “Ver logs” na lista de sites para analisar os registros do servidor web. Estes logs mostram requisições do cliente, tentativas de conexão ao destino do proxy e possíveis erros — facilitando o diagnóstico.
• Verifique o firewall ou antivírus: Assegure-se de que o firewall do macOS ou outros programas de segurança não estão bloqueando as portas 80 ou 443, nem as conexões do ServBay ao destino do proxy.

P: A máquina ServBay acessa o destino do proxy, mas pelo domínio do proxy recebo erro no navegador.

• Cheque o formato do endereço do proxy: Certifique-se de que o campo “Destino do proxy” está corretamente preenchido e que a máquina ServBay realmente acessa o site por esse endereço. Teste via terminal com curl [endereço do proxy].
• Analise a configuração do servidor de destino: Alguns servidores de backend verificam o cabeçalho Host das requisições. Por padrão, o ServBay encaminha o mesmo Host do cliente ao backend. Se seu backend espera um Host específico (ex: domínio interno), mas o acesso via ServBay utiliza outro domínio, pode ocorrer erro. Nas configurações avançadas do ServBay, é possível ajustar os cabeçalhos (isso pode exigir edição manual do Caddyfile/Nginx, além da interface básica).
• Confira o firewall do servidor de destino: O servidor pode restringir conexões a faixas específicas de IP (ex: somente redes internas). Assegure-se de que conexões vindas do IP da máquina ServBay sejam permitidas.

P: Quero acessar o site de proxy via HTTPS mas aparece alerta de certificado.

• Está usando ServBay CA: Este comportamento é esperado, pois o ServBay CA é uma autoridade privada, não confiada por padrão pelos navegadores. Instale manualmente o certificado raiz do ServBay CA no sistema ou navegador para eliminar o aviso. Isso pode ser feito diretamente nas configurações do ServBay.
• Está usando ACME (Let’s Encrypt): Verifique se o domínio está apontando corretamente para o IP da máquina ServBay e que foi solicitado o certificado ACME no gerenciamento SSL do ServBay. Analise os logs para eventuais erros no processo de emissão ACME.

P: Como mapear sites que exigem cabeçalhos ou cookies personalizados?

Na configuração básica, o ServBay encaminha a maioria das informações das requisições do cliente. Para cenários mais avançados, como incluir cabeçalhos personalizados, modificar respostas, manipular cookies ou fazer reescrita de caminhos, será preciso acessar as configurações avançadas do ServBay e editar manualmente o Caddyfile/Nginx do site, criando regras mais precisas de proxy reverso. Para isso, é recomendado conhecimentos básicos das sintaxes desses servidores.

Conclusão

Com o proxy reverso do ServBay, você pode integrar facilmente sites hospedados em redes internas, máquinas virtuais, containers ou servidores remotos ao seu ambiente de desenvolvimento local. Isso proporciona um método prático e centralizado de acesso, além de facilitar depuração e configuração de SSL. Siga os passos deste guia para configurar rapidamente seus sites de proxy reverso. Com o suporte de logs detalhados e dicas de resolução de problemas do ServBay, você garante operações estáveis dos sites mapeados e melhora significativamente sua eficiência de desenvolvimento.