Clase 06 · Módulo 05
Exponer tu n8n local con cloudflared
Exponer tu n8n local con cloudflared
Qué logras en esta clase
Le das a tu n8n local una dirección pública temporal para que un servicio de internet pueda llamar tus webhooks.
- Abres un túnel rápido con un solo comando.
- Haces que n8n muestre la dirección pública en sus webhooks.
- Sabes qué riesgos abre un túnel y cuándo ya no alcanza.
02
localhost solo existe en tu computador
La dirección http://localhost:5678 significa «este mismo equipo». Para el resto de internet no lleva a ninguna parte.
03
Por qué nadie puede llamarte
Tu computador está detrás del router de tu casa u oficina. Puede salir a internet, pero internet no puede entrar a él: no tiene una dirección pública propia y el router bloquea lo que nadie pidió.
Eso te protege todos los días. También impide que un servicio de pagos o de mensajería entregue un evento en tu webhook local.
04
Qué hace un túnel
Un programa en tu computador abre una conexión hacia afuera, a la red de Cloudflare, y la mantiene. Cloudflare te asigna una dirección pública y reenvía por esa conexión todo lo que llegue a ella. No tocas el router.
05
cloudflared y sus alternativas
cloudflared es el programa de terminal de Cloudflare para crear túneles. Es gratuito para este uso.
La documentación de n8n menciona también ngrok y localtunnel, que hacen lo mismo. Aquí se usa cloudflared porque el mismo programa sirve después para el túnel permanente (módulo 14).
06
Dos tipos de túnel
| Túnel rápido | Túnel con nombre | |
|---|---|---|
| Cuenta de Cloudflare | No | Sí |
| Dominio propio | No | Sí |
| Dirección | Aleatoria, cambia cada vez | Fija, la eliges tú |
| Disponibilidad | Sin garantía | Pensado para uso real |
| Para qué | Probar | Operar |
Esta clase usa el rápido. Con él puedes terminar todas las pruebas de webhooks de la línea.
07
Instalar cloudflared
| Sistema | Cómo |
|---|---|
| macOS | brew install cloudflared |
| Windows | Instalador .msi o ejecutable .exe desde la página de descargas |
| Linux | Paquete .deb o .rpm, o el repositorio de paquetes de Cloudflare |
Los enlaces vigentes están en la página de descargas de Cloudflare (en fuentes). Comprueba la instalación con cloudflared --version.
08
Abrir el túnel rápido
- Deja n8n corriendo y confirma que abre en
http://localhost:5678. - Abre otra terminal.
- Ejecuta:
cloudflared tunnel --url http://localhost:5678- Busca en el texto que aparece una dirección que termina en
trycloudflare.com. - Ábrela en el navegador: deberías ver tu n8n.
Esa terminal debe quedar abierta. Al cerrarla, el túnel desaparece.
09
Llamar tu webhook desde afuera
La ruta del webhook no cambia; cambia la parte inicial de la dirección.
| Dirección | |
|---|---|
| Local | http://localhost:5678/webhook/pedidos |
| Pública | https://palabras-al-azar.trycloudflare.com/webhook/pedidos |
Para una prueba puntual basta reemplazar esa parte a mano y entregar la dirección pública al servicio externo.
10
Que n8n muestre la dirección pública
n8n arma las direcciones de sus webhooks con su protocolo, host y puerto: por eso muestra localhost. Detrás de un túnel hay que decirle cuál es la pública, con dos variables de entorno:
| Variable | Valor |
|---|---|
N8N_WEBHOOK_URL | La dirección del túnel, con https:// |
N8N_PROXY_HOPS | 1 |
Se definen como viste en el módulo 2, clase 6, y exigen reiniciar n8n.
11
Por qué importa esa variable
No es solo estética. Algunos nodos disparadores registran solos su webhook en el servicio externo, usando la dirección que n8n cree tener.
Con la variable definida, el nodo Webhook también muestra la dirección pública lista para copiar.
12
El nombre de la variable cambió
En tutoriales y archivos antiguos verás WEBHOOK_URL. Desde n8n 2.35.0 ese nombre está obsoleto y el vigente es N8N_WEBHOOK_URL. El antiguo sigue funcionando como alias, pero n8n lo advierte al arrancar.
13
El orden correcto con un túnel rápido
La dirección se conoce recién al abrir el túnel, así que el orden es:
- Abre el túnel y copia la dirección.
- Define
N8N_WEBHOOK_URLcon ella yN8N_PROXY_HOPSen1. - Inicia o reinicia n8n.
- Publica el flujo y registra el webhook en el servicio.
Cada vez que abras un túnel rápido nuevo, la dirección cambia y hay que repetir los pasos 2 a 4.
14
Los límites del túnel rápido
- Sin garantía de disponibilidad: puede caerse sin aviso.
- La dirección cambia en cada túnel nuevo.
- Hasta 200 peticiones en curso a la vez; las demás reciben un 429.
- No admite Server-Sent Events, una forma de enviar respuestas en flujo continuo. Las respuestas en modo streaming pueden no funcionar a través de él.
- Funciona solo mientras tu computador y esa terminal sigan encendidos.
15
Sirve para probar, no para operar
Un negocio no puede depender de una dirección que cambia y de una terminal abierta. El túnel rápido es una herramienta de construcción.
16
Lo que el túnel deja a la vista
El túnel no expone solo el webhook: expone todo lo que responde en el puerto 5678. Eso incluye la pantalla de inicio de sesión de tu n8n.
- Cualquiera con la dirección puede intentar entrar.
- La dirección es difícil de adivinar, pero no es secreta: queda en los paneles de los servicios donde la registres.
Mientras el túnel está abierto, tu n8n es un sitio de internet.
17
Reglas mientras el túnel está abierto
- Contraseña larga y única en tu cuenta de propietario de n8n.
- Autenticación en cada webhook publicado (clase 5).
- Despublica los flujos de prueba que no estés usando.
- Cierra el túnel con
Ctrl + Ccuando termines.
18
Cuando necesitas una dirección fija
El túnel con nombre da una dirección estable bajo tu propio dominio. Requiere una cuenta de Cloudflare y un dominio administrado en ella.
Los pasos cambian con la interfaz de Cloudflare: síguelos en su documentación vigente. El montaje completo, con arranque automático, se trabaja en el módulo 14, clase 3.
19
Qué camino conviene
| Situación | Camino |
|---|---|
| Estoy construyendo y probando webhooks | Túnel rápido |
| Uso real, con mi computador siempre encendido | Túnel con nombre |
| Uso real, sin depender de mi computador | Servidor o n8n Cloud (módulo 14) |
| Mi flujo solo consulta por horario | Ningún túnel |
Un flujo que solo hace llamadas hacia afuera no necesita que nadie lo alcance.
20
Errores comunes
- Cerrar la terminal del túnel y preguntarse por qué dejaron de llegar eventos.
- Registrar en el servicio la dirección de un túnel anterior.
- Apuntar cloudflared a un puerto distinto del que usa n8n.
- Copiar
WEBHOOK_URLdesde un tutorial sin revisar la versión. - Exponer n8n con una contraseña débil.
21
Lo que te llevas
- Un túnel conecta una dirección pública con tu
localhostsin tocar el router. cloudflared tunnel --url http://localhost:5678abre uno rápido, sin cuenta.N8N_WEBHOOK_URLyN8N_PROXY_HOPShacen que n8n use la dirección pública.- El túnel rápido cambia de dirección y no garantiza disponibilidad.
- Mientras está abierto, todo tu n8n queda en internet.
22
Hazlo ahora
En 15 minutos, con el flujo A de la clase anterior publicado:
- Instala cloudflared y abre un túnel rápido hacia el puerto 5678.
- En tu celular, con datos móviles, abre la dirección del túnel: debe aparecer el inicio de sesión de n8n.
- En el flujo B, reemplaza
http://localhost:5678por la dirección del túnel y ejecuta. Revisa la ejecución de A. - Cierra el túnel y ejecuta B otra vez: debe fallar.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Quick Tunnels (documentación de Cloudflare)developers.cloudflare.com ↗
- Downloads: cloudflared (documentación de Cloudflare)developers.cloudflare.com ↗
- Configure n8n webhooks with reverse proxy (documentación de n8n)docs.n8n.io ↗
- n8n v2.0 breaking changes (documentación de n8n)docs.n8n.io ↗
- Webhook (documentación de n8n)docs.n8n.io ↗
- n8n Docs — Variables de entorno de endpoints (N8N_WEBHOOK_URL)docs.n8n.io ↗