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

O ServBay é um ambiente local de desenvolvimento Web projetado especialmente para macOS, integrando múltiplas linguagens como PHP, Node.js, Python, Go, Java, além de bancos de dados como MySQL, PostgreSQL, MongoDB, Redis, entre outros. Além de hospedar projetos de código local, o ServBay também oferece um poderoso recurso de proxy reverso. Com o proxy reverso, você pode mapear facilmente sites hospedados em redes internas, máquinas virtuais, containers ou até mesmo servidores remotos para o seu ambiente local ServBay, simplificando o fluxo de desenvolvimento, depuração e acesso.

Este artigo fornece um guia detalhado sobre como configurar o proxy reverso no ServBay, ajudando você a gerenciar e depurar de forma eficiente sites hospedados em redes internas ou outros endereços acessíveis.

Visão Geral

Um servidor proxy reverso recebe solicitaçõ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ê deseja proxyar). O ServBay utiliza seu servidor web integrado (Caddy ou Nginx) para realizar essa função.

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

• Ponto de acesso unificado: Acesse todos os recursos internos ou externos usando um domínio local do ServBay, sem precisar lembrar IPs e portas complexas.
• Configuração de SSL simplificada: Aproveite o gerenciamento de SSL do ServBay (como ServBay CA ou ACME) para fornecer acesso HTTPS ao site proxyado, mesmo que o backend suporte apenas HTTP.
• Depuração local facilitada: Depure facilmente aplicações web internas ou remotas diretamente no seu navegador local.
• Superação de restrições da rede: Em certos casos, é possível acessar recursos de redes internas da empresa ou redes restritas localmente (desde que a máquina com ServBay tenha acesso ao destino).

Pré-requisitos

Antes de começar a configurar o proxy reverso, certifique-se de que você atenda aos seguintes requisitos:

1. ServBay instalado e em execução: Garanta que o ServBay esteja corretamente instalado e rodando em seu sistema macOS.
2. Site de destino acessível: O site interno ou remoto que você deseja proxyar já deve estar em funcionamento, e a máquina macOS rodando o ServBay deve conseguir acessar diretamente o IP/domínio e a porta desse site pela rede. Por exemplo, se o destino for 192.168.1.100:8080, o macOS deve conseguir dar ping em 192.168.1.100 e acessar 192.168.1.100:8080.

Passos para Adicionar um Site de Proxy Reverso

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

Passo 1: Abra a Interface de Gerenciamento do ServBay

Localize o ícone ServBay na sua pasta de aplicativos do macOS e clique duas vezes para iniciar o aplicativo.

Passo 2: Navegue para Gerenciamento de Sites

Após iniciar o ServBay, você verá a interface principal. No menu de navegação à esquerda, clique em Sites. Você será levado à página de gerenciamento de sites do ServBay, onde pode administrar todos os sites locais e de proxy reverso.

Passo 3: Adicione um Novo Site

Na parte inferior da página de gerenciamento de sites, localize e clique no botão +. Após clicar, uma nova área de formulário será exibida à direita para você configurar o novo site.

Passo 4: Configure as Opções do Proxy Reverso do Site

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

1. Nome (Name): Dê um nome facilmente identificável ao seu site proxy reverso. Exemplo: Internal Backend Proxy.
2. Domínio (Domain): Informe o domínio pelo qual você deseja acessar o site proxyado localmente. Exemplo: backend.servbay.demo ou proxy.to.local. O ServBay normalmente adiciona automaticamente esse domínio no arquivo hosts do seu sistema, apontando para 127.0.0.1 ou ::1.
3. Protocolo (Protocol): Escolha qual protocolo o site irá suportar. Geralmente, selecione HTTP/HTTPS para suportar ambos. O ServBay irá lidar com o SSL automaticamente.
4. Método de solicitação do certificado SSL (SSL Certificate Request Method):
   • ServBay CA (Recomendado para desenvolvimento local): O ServBay usará sua CA interna para gerar e gerenciar automaticamente o certificado SSL para seu domínio. É prático, mas você deve confiar no certificado raiz do ServBay CA no navegador ou sistema para evitar alertas de segurança.
   • ACME (Let's Encrypt): Para domínios públicos acessíveis via internet, você pode optar pelo Let's Encrypt para solicitar um certificado SSL gratuito.
   • Manual: Se você já possui arquivos de certificado SSL (.crt, .key, .ca-bundle), pode carregar e configurar manualmente. Para desenvolvimento local e proxy de recursos internos, recomenda-se fortemente o uso do ServBay CA.
5. Tipo de site (Website Type): Selecione Proxy reverso (Reverse Proxy). Esta é a configuração essencial para ativar o proxy.
6. Destino do proxy (Proxy Target): Insira o endereço completo do site interno ou remoto que você quer proxyar. Pode ser no formato IP:Port ou uma URL completa com protocolo.
   • Exemplo 1 (IP:Port): 192.168.1.100:8080
   • Exemplo 2 (URL com protocolo): http://192.168.1.100:8080
   • Exemplo 3 (hostname interno): backend.internal:8443 (desde que o ServBay consiga resolver esse nome)
   • Exemplo 4 (URL remota): https://api.example.com Certifique-se de inserir um endereço que a máquina do ServBay consiga acessar diretamente.

Passo 5: Finalize e Salve a Configuração

Depois de preencher todas as informações necessárias, clique no botão Adicionar (Add) no final do formulário. O ServBay irá salvar sua configuração e gerar automaticamente as regras de proxy reverso no seu servidor web (Caddy ou Nginx).

Depois de salvo, o novo site proxy reverso aparecerá na lista de sites.

Passo 6: Acesse o Site Proxyado

Com a configuração pronta, basta digitar no navegador o domínio definido no Passo 4 (por exemplo, proxy.to.local ou backend.servbay.demo) para acessar o site interno ou remoto através do proxy local.

Se você usou o ServBay CA e escolheu HTTPS, pode ser necessário lidar com alertas de certificado na primeira visita (caso ainda não tenha confiado no certificado raiz do ServBay CA).

Passo 7: Ações Rápidas do Site

O ServBay oferece botões de ação rápida para cada site, facilitando o gerenciamento:

1. Abrir diretório raiz no IDE: Esta opção geralmente não se aplica a sites proxy reverso, pois não há um diretório local.
2. Abrir site no navegador: Acesse rapidamente o site no navegador padrão.
3. Ver logs do site: Consulte os logs de acesso e erro do servidor web do ServBay (Caddy/Nginx), ferramenta essencial para depuração.
4. Pausar/Ativar site: Ative ou desative temporariamente o proxy reverso.
5. Excluir site: Remova a configuração de proxy reverso do ServBay.

Dúvidas Frequentes e Soluções (FAQ)

Q: O site não está acessível e o navegador exibe um erro.

• Verifique o estado do ServBay: Confirme se o próprio ServBay está rodando e se o servidor web (Caddy/Nginx) foi iniciado.
• Verifique a resolução do domínio: Assegure-se de que o domínio digitado está correto e resolvendo para o IP do ServBay (normalmente o ServBay ajusta o arquivo hosts, mas cheque manualmente se necessário).
• Confira os logs do site no ServBay: Clique em “Ver logs” na lista de sites para examinar os registros do servidor web do ServBay. Eles registram informações de solicitação dos clientes, tentativas de conexão ao destino proxy e eventuais erros, oferecendo o caminho mais direto para identificar problemas.
• Cheque firewall/antivírus: Certifique-se de que firewalls ou softwares de segurança do macOS não estão bloqueando as portas 80 ou 443 nem impedindo conexões do ServBay ao destino.

Q: A máquina do ServBay acessa o destino, mas ocorre erro ao acessar pelo domínio do ServBay no navegador.

• Verifique o formato do destino do proxy: Garanta que o endereço configurado como “destino” no ServBay está correto e que a máquina com ServBay consegue acessar esse endereço. Teste via terminal com curl [endereço-do-destino].
• Cheque configuração do servidor de destino: Alguns servidores backend verificam o cabeçalho Host. O ServBay, por padrão, repassa o cabeçalho original do cliente ao backend. Se o backend precisar de um Host específico (como um domínio interno), e você estiver acessando via outro domínio, isso pode causar problemas. Nas configurações avançadas do ServBay, é possível ajustar os headers (pode ser necessário editar o Caddyfile ou config do Nginx manualmente, fora da interface principal).
• Confira firewall do servidor de destino: Mesmo que o ServBay acesse o IP/porta do destino, o firewall do servidor pode restringir conexões a certos IPs. Certifique-se de que o servidor de destino aceita conexões do IP do ServBay.

Q: Aparece alerta de certificado ao acessar o site proxy reverso via HTTPS.

• ServBay CA em uso: É esperado, já que a ServBay CA é uma autoridade privada e navegadores não a confiam por padrão. Instale o certificado raiz do ServBay CA no seu sistema/aplicativo para eliminar alertas.
• Usando ACME (Let's Encrypt): Confirme que seu domínio está apontando corretamente para o IP do ServBay e que você solicitou o certificado ACME. Consulte os logs do ServBay para mensagens de erro detalhadas do processo.

Q: Como proxyar para destinos que exigem headers ou cookies específicos?

A configuração básica do proxy reverso do ServBay normalmente repassa a maioria das informações da solicitação. Para cenários mais avançados — por exemplo, adicionar headers personalizados, modificar headers de resposta, manipular cookies ou reescrever caminhos — pode ser preciso usar as configurações avançadas do ServBay, editando manualmente o Caddyfile ou o arquivo de configuração do Nginx para regras mais detalhadas de proxy reverso. Esta etapa normalmente requer algum conhecimento da sintaxe do Caddy ou Nginx.

Resumo

Com o proxy reverso do ServBay, você integra facilmente sites internos, VMs, containers ou servidores remotos ao seu ambiente de desenvolvimento local. Isso oferece um ponto de acesso centralizado, facilita a depuração local e simplifica a configuração de SSL. Basta seguir os passos descritos neste guia para configurar e começar a usar sites de proxy reverso rapidamente. Aliados aos recursos robustos de visualização de logs e técnicas de solução de problemas do ServBay, você garante estabilidade ao site proxyado e aumenta significativamente sua produtividade no desenvolvimento.