Conhecendo o túnel seguro que facilita expor uma aplicação local na internet

Quando trabalhamos com APIs, webhooks, integrações externas ou demos rápidas para clientes, frequentemente precisamos expor um servidor local para a internet, sem publicar a aplicação em produção.

É exatamente aí que o ngrok brilha: ele cria um túnel seguro, temporário e auditável entre sua máquina e a web.

Com o presente artigo, você vai entender:

• O que é ngrok e por que utilizá-lo
• Casos de uso comuns no dia a dia de desenvolvimento
• Vantagens técnicas
• Instalação no Linux
• Exemplo prático: expondo um servidor local
• Boas práticas e dicas

O que é o ngrok?

O ngrok é um proxy reverso com tunelamento seguro.

Ele cria um endereço público (HTTP/HTTPS/TCP) que aponta diretamente para um serviço rodando na sua máquina.

Internet ➜ Ngrok ➜ Seu computador (localhost)

Sem reconfigurar roteadores, firewall ou DNS.

Por que usar ngrok?

1. Webhooks e integrações

Ferramentas como:

• Stripe
• GitHub
• WhatsApp API
• Telegram
• PagSeguro
• Mercado Pago

Exigem URLs públicas. Com ngrok, você recebe chamadas externas enquanto desenvolve localmente.

2. Demonstrações rápidas

Mostre um MVP para clientes ou colegas.

3. Debug e monitoramento

O ngrok oferece um painel com replay de requisições, essencial para entender comportamentos.

4. Trabalhar remotamente com times

Compartilhe um ambiente local com segurança, permitindo testes colaborativos.

Vantagens técnicas

Criptografia TLS nativa

Logs e replay de requisições

Subdomínios personalizados (em planos pagos)

Tunelamento para HTTP, HTTPS e TCP

Integrações com CI/CD

Não exige alterações na infraestrutura

Funciona em qualquer sistema operacional

Instalação do ngrok no Linux

Antes de tudo, crie ou acesse sua conta gratuita:

https://dashboard.ngrok.com

Copie seu authtoken, pois será necessário.

Debian, Ubuntu, Fedora

Baixe e instale:

wget https://bin.equinox.io/c/bNyj1mQVY4c/ngrok-v3-stable-linux-amd64.tgz

tar -xvzf ngrok-v3-stable-linux-amd64.tgz

sudo mv ngrok /usr/local/bin/ngrok

Adicione o token:

ngrok config add-authtoken SEU_TOKEN

Confirme: ngrok version

Usando o ngrok na prática

Expor uma aplicação local (porta 3000, por exemplo):

ngrok http 3000

Com o projeto em execução na sua máquina com a porta 80, execute:

ngrok http 80

Você verá algo parecido com:

Forwarding https://abcd-1234.ngrok-free.app -> http://localhost:3000

ou

Forwarding https://abcd-1234.ngrok-free.app -> http://localhost:80

Esse endereço pode ser usado por qualquer serviço externo.

Acessar o painel de inspeção

No browser acesse: http://127.0.0.1:4040

Nesse painel é possível:

• visualizar requisições
• responder novamente (replay)
• analisar headers e payloads

Excelente para testes de webhooks.

Dicas e boas práticas

Utilize versões atualizadas

O ngrok pode bloquear agentes antigos:

ngrok update

Evite múltiplas instalações

Se algo parecer estranho:

O comando a seguir mostra o caminho absoluto do binário do ngrok

which ngrok

Proteja endpoints sensíveis

Use autenticação básica:

ngrok http --basic-auth="user:senha" 3000

Anote URLs efêmeras

Em contas gratuitas, as URLs mudam a cada sessão.

Quando NÃO usar ngrok

• Para substituir deploy em produção
• Para expor serviços críticos por longos períodos
• Para aplicações que exigem SLA robusto e IP fixo

Nesses casos, considere VPN corporativa ou reverse proxies dedicados.

Considerações finais

O ngrok elimina fricção no desenvolvimento:

você testa webhooks, mostra MVPs, depura integrações e colabora com seu time, tudo sem precisar de uma VPS.

É uma ferramenta simples, poderosa e que rapidamente se torna indispensável no workflow de APIs e aplicações web.

Feito!