Solução de problemas
Correções para os problemas mais comuns: connection refused, host bloqueado no Vite, subdomínio não reservado, limites e mais.
2 min de leitura
A maioria dos problemas está no app local, não no túnel. Comece por estas verificações.
502 ou "connection refused"
O túnel está de pé, mas nada escuta na porta informada. Suba o app primeiro, confirme a porta e então inicie o túnel.
# Is anything listening on the port?lsof -i :3000# Start your app first, then the tunnelnpm run devrl-tunnel http 3000"Blocked request. This host is not allowed"
O Vite e alguns servidores de dev rejeitam hosts desconhecidos. A CLI já evita isso: por padrão ela envia ao seu app o host local (por exemplo localhost:3000), e o host público vai em X-Forwarded-Host. Redirects para o host local são reescritos de volta para a URL pública. Você só vê esse erro com --preserve-host; nesse caso libere o domínio do túnel:
Blocked request. This host ("dev-xyz.t.resolvelabs.com.br") is not allowed.// vite.config.tsexport default defineConfig({ server: { allowedHosts: [".t.resolvelabs.com.br"] },});"Subdomínio não reservado" ou em uso
O --subdomain só aceita nomes reservados na sua conta. Reserve no painel (os nomes são únicos entre as contas) e entre com rl-tunnel auth login. Rode rl-tunnel whoami para ver o que a sua conta tem.
"Limite de túneis simultâneos atingido"
Uma conta permite 10 túneis simultâneos. Feche túneis que não usa mais (Ctrl+C). Depois de uma queda de rede, a sessão antiga pode levar até meio minuto para ser liberada, e a CLI tenta de novo sozinha.
"Token inválido ou revogado"
O token foi revogado no painel ou digitado errado. Crie um novo, ou rode rl-tunnel auth login de novo. Confira se há um RL_TUNNEL_TOKEN antigo no ambiente: ele tem prioridade sobre o login salvo.
O navegador não abre no login
Use rl-tunnel auth login --no-browser, abra a URL impressa em qualquer dispositivo e confirme o código.
O app mostra o site errado ou redireciona para localhost
Seu app pode montar URLs absolutas a partir do header Host ou de uma variável de ambiente. Use --host-header, ou defina a URL pública (por exemplo APP_URL) com o endereço do túnel.
Ainda travado?
Rode com --debug para ver detalhes da conexão e inclua a saída ao falar com o suporte.
rl-tunnel http 3000 --debug