Ir para o conteúdo
Promovaweb

O webhook mostra localhost ou a porta 5678 em vez do seu domínio

Revisado em

Sintomas

  • URL do webhook aparece com localhost
  • URL do webhook com porta 5678
  • serviço externo não consegue registrar o webhook
  • webhook com http em vez de https

Antes de começar

Fazer o n8n mostrar e registrar a URL pública dos webhooks.

  • Acesso às variáveis de ambiente da instância.
  • Acesso à configuração do proxy reverso.

O n8n monta a URL dos webhooks a partir de protocolo, host e porta internos. Atrás de um proxy reverso, como Traefik ou Nginx, o n8n roda na porta 5678 e o público acessa pela 443. O resultado é uma URL que só funciona dentro do servidor.

Correção

Defina duas variáveis de ambiente na instância:

Terminal
N8N_WEBHOOK_URL=https://n8n.seudominio.com.br/
N8N_PROXY_HOPS=1

N8N_WEBHOOK_URL substitui a antiga WEBHOOK_URL, que gera aviso de descontinuação a partir da versão 2.35.0. Se a sua configuração ainda usa o nome antigo, troque.

No último proxy do caminho, repasse estes cabeçalhos:

  • X-Forwarded-For
  • X-Forwarded-Host
  • X-Forwarded-Proto

Confira na documentação do seu proxy se ele envia esses cabeçalhos.

Reinicie o n8n depois de mudar as variáveis.

Workflows que já usavam a URL errada

Integrações que registraram o webhook com a URL antiga continuam apontando para ela. Despublique e publique de novo os workflows com triggers de aplicativos, para o n8n registrar a URL correta nos serviços externos.

Confira o resultado

O node Webhook mostra a URL com o seu domínio e https, e um serviço externo registra o webhook sem erro.

Fontes e conferência

Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.