# O webhook do n8n mostra localhost:5678 | Nuvits

Fonte: [https://nuvits.net/blog/webhook-n8n-localhost-5678](https://nuvits.net/blog/webhook-n8n-localhost-5678)

Publicado em 2026-11-19, por Fernando Chagas.

O nó Webhook do n8n, atrás de um proxy, mostra a URL de produção como `http://localhost:5678/webhook/...`. O serviço externo que receber esse endereço chama a própria máquina dele, onde `localhost:5678` não é o seu n8n, e o evento não chega.

O teste foi feito em 19/11/2026 com o n8n `2.48.6` (`docker.n8n.io/n8nio/n8n:2.48.6`) e o Caddy `2.11.9` na frente, no Ubuntu 24.04. O n8n usava PostgreSQL `18.7` e o runner `n8nio/runners:2.48.6`. O proxy era o mesmo do guia [n8n e Evolution API na mesma VPS](https://nuvits.net/blog/n8n-evolution-api-mesma-vps). Cada bloco abaixo é uma subida separada, com o resto do Compose igual.

## O que o editor mostra

Sem `N8N_HOST`, `N8N_PROTOCOL`, `N8N_WEBHOOK_URL` e `N8N_PROXY_HOPS`, o log de inicialização foi:

```text
Editor is now accessible via:
http://localhost:5678
```

Depois da conta de owner, `GET /rest/settings` devolveu `urlBaseWebhook` e `urlBaseEditor` como `http://localhost:5678/`. O nó Webhook, publicado com o caminho `whatsapp`, mostrou a URL de produção `http://localhost:5678/webhook/whatsapp`:

![Nó Webhook do n8n com a URL de produção em http://localhost:5678/webhook/whatsapp](https://nuvits.net/blog/webhook-n8n-localhost-5678/webhook-mostrando-localhost-5678.webp)

O site em si abria em `https://n8n.example.com`. O proxy estava certo. A URL que o n8n monta para o webhook é outra conta, feita com variáveis, não com o endereço que o navegador usou.

## Por que a porta 5678 entra na URL

A [documentação do n8n](https://docs.n8n.io/deploy/host-n8n/configure-n8n/basic-configuration/configuration-examples/configure-webhook-urls-with-reverse-proxy) descreve a montagem: sem uma URL de webhook definida, o n8n junta `N8N_PROTOCOL`, `N8N_HOST` e `N8N_PORT`. O padrão é `http`, `localhost` e `5678`. O proxy publica 443. O processo continua em 5678. As duas pontas não coincidem.

No n8n 2.48.6, medir uma variável de cada vez deu isto. O valor é o `urlBaseWebhook` autenticado:

| Variáveis                                                  | urlBaseWebhook                  |
| ---------------------------------------------------------- | ------------------------------- |
| nenhuma                                                    | `http://localhost:5678/`        |
| `N8N_HOST=n8n.example.com` e `N8N_PROTOCOL=https`          | `https://n8n.example.com:5678/` |
| as duas acima e `N8N_WEBHOOK_URL=https://n8n.example.com/` | `https://n8n.example.com/`      |
| as três acima e `N8N_PROXY_HOPS=1`                         | `https://n8n.example.com/`      |

`N8N_HOST` e `N8N_PROTOCOL` trocam o nome e o esquema, e a porta 5678 continua. Quem tira a porta é `N8N_WEBHOOK_URL`. A barra no final importa: o valor testado foi `https://n8n.example.com/`, e a URL do nó ficou `https://n8n.example.com/webhook/whatsapp`.

`N8N_PROXY_HOPS` não muda essa string. Ele liga o `trust proxy` do Express na quantidade de proxies. Com o Caddy mandando `X-Forwarded-For` e o hops em zero, o log do n8n 2.48.6 foi:

```text
ValidationError: The 'X-Forwarded-For' header is set but the Express 'trust proxy' setting is false (default). This could indicate a misconfiguration which would prevent express-rate-limit from accurately identifying users.
```

Com `N8N_PROXY_HOPS=1`, o mesmo pedido através do Caddy não gerou essa linha. A execução do webhook passou a registrar `x-forwarded-proto` como `https`. Um proxy só: o valor é 1. Dois proxies em série: o valor é 2, que este teste não montou.

`N8N_WEBHOOK_URL` existe desde o n8n 2.30.0. A variável antiga `WEBHOOK_URL` ainda funciona no 2.48.6 e também produz `https://n8n.example.com/`, mas a inicialização avisa:

```text
WEBHOOK_URL -> Use N8N_WEBHOOK_URL instead, which sets the base URL for both test and production webhooks.
```

A documentação marca `WEBHOOK_URL` como obsoleta a partir do 2.35.0. Use o nome novo.

## A correção

No serviço `n8n` do Compose, as quatro linhas testadas:

```yaml
services:
  n8n:
    environment:
      - N8N_HOST=${N8N_DOMAIN}
      - N8N_PROTOCOL=https
      - N8N_WEBHOOK_URL=https://${N8N_DOMAIN}/
      - N8N_PROXY_HOPS=1
```

`N8N_DOMAIN` no `.env` é só o host, `n8n.example.com`, sem esquema e sem porta. Recrie o contêiner. O processo que já está rodando não lê as variáveis novas:

```bash
cd ~/whatsapp
sudo docker compose up -d n8n
sudo docker compose logs n8n
```

O log passa a dizer:

```text
Editor is now accessible via:
https://n8n.example.com
```

O Caddy deste teste usava certificado interno. O `curl` confia na raiz que o Caddy gravou:

```bash
sudo docker compose cp caddy:/data/caddy/pki/authorities/local/root.crt ./caddy-root.crt
curl --cacert ./caddy-root.crt -fsS https://n8n.example.com/healthz
```

Com certificado público, apague o `--cacert ./caddy-root.crt`. O health responde `{"status":"ok"}`.

## Como conferir

Entre no editor, abra o nó Webhook e a aba Production URL. O endereço começa com `https://` e com o domínio, e não tem `:5678`.

Pela API, depois do login, `GET /rest/settings` traz `urlBaseWebhook` igual a `https://n8n.example.com/`. Foi o campo usado na tabela acima.

Publique o workflow e chame a URL de produção pelo proxy. No teste, com o caminho `whatsapp`:

```bash
curl --cacert ./caddy-root.crt -fsS -X POST https://n8n.example.com/webhook/whatsapp \
  -H "Content-Type: application/json" \
  -d '{"event":"messages.upsert","data":{"message":{"conversation":"oi do teste"}}}'
```

A resposta foi `{"message":"Workflow was started"}`. Na execução, `webhookUrl` ficou `https://n8n.example.com/webhook/whatsapp`. Se a resposta for 404 dizendo que o webhook não está registrado, o workflow não está publicado. A URL certa com o workflow em rascunho continua sem receber evento.

> **A URL de teste não substitui a de produção.** A aba Test URL usa `/webhook-test/` e só responde enquanto o editor está escutando. Um serviço que chama o n8n o tempo todo usa `/webhook/`.

O mesmo sintoma, com a variável certa já no Compose, está resolvido no guia [n8n e Evolution API na mesma VPS](https://nuvits.net/blog/n8n-evolution-api-mesma-vps). A instalação do zero, com Postgres e runner, está em [Como instalar o n8n com Docker numa VPS](https://nuvits.net/blog/como-instalar-n8n-docker-vps). A VPS em que esse n8n roda está em [VPS para n8n](https://nuvits.net/vps-para-n8n).
