Guia de Configuração do Serviço de Proxy Reverso Ngrok no ServBay

Ngrok é uma ferramenta de túnel seguro baseada em tecnologia de proxy reverso, capaz de penetrar em firewalls para mapear serviços locais para a internet. Este guia irá detalhar como implantar o serviço Ngrok no ambiente ServBay, permitindo o acesso à internet para serviços Web locais.

Princípio Técnico

Ngrok cria uma conexão de túnel criptografado, mapeando serviços locais implantados atrás de NAT/firewalls para um domínio público. No cenário do ServBay, essa solução permite que desenvolvedores publiquem serviços Web em tempo real em um ambiente local, facilitando a colaboração da equipe e testes remotos.

Preparação do Ambiente

1. Instalação do Cliente Ngrok

Siga os passos abaixo para concluir a implantação da ferramenta CLI do Ngrok:

1. Acesse a página de download oficial para obter o pacote de instalação apropriado para seu sistema.
2. Extraia e implante no diretório PATH do sistema (exemplo utilizando macOS ARM):

   sudo unzip ~/Downloads/ngrok-v3-stable-darwin-arm64.zip -d /usr/local/bin

3. Verifique a integridade da instalação:

   ngrok version
   # ngrok version 3.5.0

Prática de Configuração de Túnel

Descrição dos Parâmetros Principais

A estrutura do comando padrão para mapear o serviço é a seguinte:

ngrok http --domain=<NGROK_DOMAIN> <LOCAL_ENDPOINT> \
  --request-header-add='host: <VIRTUAL_HOST>'

Componente do parâmetro	Descrição da funcionalidade
http	Declara um túnel do protocolo HTTP
--domain	Especifica o domínio fixo atribuído pelo Ngrok (deve ser substituído pelo domínio real)
<LOCAL_ENDPOINT>	Endereço do serviço ServBay local (padrão https://servbay.host)
--request-header-add	Reescreve o cabeçalho Host para garantir o roteamento correto das requisições

Exemplo de Configuração

Suponha que você precise mapear o serviço local servbay.local para o domínio público cunning-lacewing-fresh.ngrok-free.app, execute o comando:

ngrok http --domain=cunning-lacewing-fresh.ngrok-free.app https://servbay.local \
  --request-header-add='host: servbay.local'

Após a execução bem-sucedida, o terminal exibirá informações de status do túnel, incluindo o endereço de acesso público e monitoramento de tráfego em tempo real.

Validação do Serviço

Após a configuração, siga os passos para validar:

4. Acesse o domínio Ngrok no navegador:

   https://cunning-lacewing-fresh.ngrok-free.app

5. Resultados esperados:
   • Exibir conteúdo Web que corresponde ao serviço local
   • Sinal de segurança da conexão HTTPS válido
   • Tempo de resposta em um intervalo razoável (geralmente <500ms)

Ilustração: Página acessada através do Ngrok

Dicas Avançadas

6. Gerenciamento de Domínios:

   • Solicite um domínio personalizado no Painel de Controle do Ngrok
   • Usuários empresariais podem vincular domínios próprios (exige atualização para um plano pago)

7. Mapeamento de Múltiplos Serviços:

   # Mapeie serviços HTTP/HTTPS simultaneamente
   ngrok http --domain=your-domain.ngrok.app 80
   ngrok tls --domain=your-domain.ngrok.app 443

8. Comandos de Diagnóstico:

   ngrok config check    # Verifica o arquivo de configuração
   ngrok logs            # Exibe logs em tempo real

Resolução de Problemas

Fenômeno	Solução
Conexão expirada	Verifique o status do serviço ServBay e as ocupações de porta
Erro de certificado HTTPS	Confirme a configuração correta do parâmetro --request-header-add
Desconexões intermitentes	Verifique a estabilidade da rede, recomenda-se usar conexão com fio

Resumo da Solução

Através do plano de proxy reverso do Ngrok, desenvolvedores podem rapidamente estabelecer um canal de acesso seguro à internet no ambiente ServBay. Esta configuração oferece as seguintes vantagens:

• Zero modificação de código para expor serviços
• Suporte a monitoramento e análise de tráfego em tempo real
• Fornece proteção de segurança em nível empresarial (necessita configuração de políticas de acesso)

Recomenda-se o uso do plano pago do Ngrok em ambientes produtivos para garantir um serviço mais estável.