Guía completa de solución de problemas de n8n autoalojado 2025: tamaño de los datos de ejecución y webhooks con Traefik
Última actualización: 15 de octubre de 2025
Autoalojar n8n ofrece ejecuciones ilimitadas de flujos de trabajo, control completo de los datos y ahorros significativos en comparación con los planes en la nube. Pero en realidad, las instancias autoalojadas presentan dificultades que los usuarios de n8n Cloud normalmente no tienen que gestionar; en concreto, al manejar grandes volúmenes de datos y la configuración de webhooks con proxies inversos.
En junio de 2025, publicamos dos guías de solución de problemas que abordaban estos asuntos por separado. El problema es que no existe una guía integral para despliegues de n8n en producción con el proxy inverso Traefik que aborde ambos problemas habituales de forma conjunta.
Esta guía combina ambas correcciones originales, proporciona una configuración completa de Traefik con soporte WebSocket, incluye los nuevos requisitos de 2025 para los ejecutores de tareas y ofrece archivos docker-compose preparados para producción que puede desplegar de inmediato.
Índice de contenidos
- Diagnóstico rápido: ¿Qué problema tiene?
- Comprensión de los dos problemas principales
- Corrección #1: Error de datos de ejecución demasiado grandes
- Corrección #2: Problemas con las URL de webhooks
- Configuración completa de producción con Traefik
- Requisito 2025: Ejecutores de tareas
- Referencia de variables de entorno
- Ejemplos de Docker Compose
- Prueba de su configuración
- Solución de problemas comunes
Diagnóstico rápido: ¿qué problema tiene?
Síntoma: "existing execution data is too large"
Este error aparece cuando:
- Hace clic en "Execute Node" durante el desarrollo de flujos de trabajo
- Prueba flujos de trabajo con grandes conjuntos de datos o muchos elementos
- Usa el modo de ejecución parcial (probando nodos individuales)
- Procesa transformaciones complejas con múltiples ramas
Necesita: Corrección #1: Tamaño de datos de ejecución
Síntoma: los webhooks muestran URL incorrectas o no funcionan
Esto ocurre cuando:
- Las URL de webhooks se muestran con números de puerto (p. ej.,
:5678) - Los servicios externos (Slack, GitHub, Stripe) no pueden alcanzar sus webhooks
- Los webhooks funcionan en modo de prueba pero fallan en producción
- Está usando un proxy inverso (Nginx, Traefik, Caddy)
Necesita: Corrección #2: Configuración de URL de webhooks
Síntoma: advertencias de obsolescencia sobre ejecutores de tareas
Ve registros que dicen:
Running n8n without task runners is deprecated. Task runners will be
turned on by default in a future version.
Necesita: Configuración de ejecutores de tareas
Síntoma: quiere una configuración completa y lista para producción
Necesita:
- Ambas correcciones aplicadas correctamente
- Proxy inverso Traefik con HTTPS automático
- Mejores prácticas y seguridad de producción
- Límites de recursos y monitoreo adecuado
Ir a: Configuración completa de producción
Comprensión de los dos problemas principales
Por qué los usuarios de n8n Cloud rara vez afrontan estos problemas
En n8n Cloud, n8n gestiona por usted la configuración del servidor, como las URL de webhooks, el almacenamiento de datos binarios y las actualizaciones. Cuando autoaloja n8n, usted es responsable de estas configuraciones.
Las causas raíz
Problema #1: límite de tamaño de datos de ejecución
El límite predeterminado de 16 MiB para las cargas útiles de las solicitudes enviadas al backend, incluidos los datos de ejecución parcial genera errores al trabajar con grandes conjuntos de datos, muchas ramas de flujo de trabajo o transformaciones complejas. Esto dificulta el desarrollo de flujos de trabajo: no puede probar nodos individuales durante el desarrollo. La solución es directa: la variable de entorno N8N_PAYLOAD_SIZE_MAX.
Problema #2: generación de URL de webhooks
n8n intenta detectar automáticamente su URL pública, pero esta detección automática falla cuando está detrás de un proxy inverso. Los servicios externos reciben URL de webhook incorrectas con puertos o nombres de host internos – las integraciones fallan silenciosamente. La solución: la variable de entorno WEBHOOK_URL.
Corrección #1: error de datos de ejecución demasiado grandes
El problema en detalle
Cuando ejecuta solo una parte de un flujo de trabajo (haciendo clic en "Execute Node" en el editor), n8n necesita cargar los datos de ejecución anteriores para proporcionar contexto a ese nodo. Por defecto, n8n limita esta solicitud a 16 MiB (N8N_PAYLOAD_SIZE_MAX=16; el valor se expresa en MiB) para prevenir problemas de memoria en servidores más pequeños. Si la solicitud es mayor, n8n (o un proxy inverso con un límite inferior para el cuerpo de la solicitud) responde con HTTP 413 y el editor muestra este error.
El mensaje de error
Según la documentación oficial de n8n:
Please execute the whole workflow, rather than just the node.
(Existing execution data is too large.)
Este error aparece al procesar miles de elementos en un solo nodo, trabajar con grandes respuestas JSON de API, transformar grandes conjuntos de datos con nodos Code o usar flujos de trabajo con muchas ramas paralelas.
La solución: N8N_PAYLOAD_SIZE_MAX
La corrección es sencilla, pero requiere conocer los recursos disponibles de su servidor.
Configuraciones recomendadas por RAM del servidor
| RAM del servidor | N8N_PAYLOAD_SIZE_MAX | Valor que debe configurar (MiB) | Porcentaje de RAM |
|---|---|---|---|
| 2 GB o menos | 64 MB | 64 | ~3 % |
| 4 GB | 128 MB | 128 | ~3 % |
| 8 GB | 256 MB | 256 | ~3 % |
| 16 GB+ | 512 MB | 512 | ~3 % |
Regla general: Use menos del 20 % de su RAM disponible para mantener el sistema estable bajo carga.
Implementación con Docker Compose
version: '3.8'
services:
n8n:
image: n8nio/n8n:latest
container_name: n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_PORT=5678
# Payload size fix (256MB for 8GB+ RAM servers; value in MiB)
- N8N_PAYLOAD_SIZE_MAX=256
# Binary data optimization (highly recommended)
- N8N_DEFAULT_BINARY_DATA_MODE=filesystem
- N8N_BINARY_DATA_TTL=1440 # 24 hours
volumes:
- n8n_data:/home/node/.n8n
# Resource limits (adjust based on your server)
deploy:
resources:
limits:
memory: 2G
reservations:
memory: 1G
volumes:
n8n_data:
Comprensión del modo de datos binarios
Predeterminado: almacenamiento en memoria (no recomendado)
# This is the default - DON'T use in production
N8N_DEFAULT_BINARY_DATA_MODE=default
Problemas: Almacena archivos (imágenes, PDF, etc.) en RAM, desperdicia memoria valiosa, no es adecuado para cargas de trabajo de producción, limita cuántos archivos puede procesar.
Según nuestras pruebas, el modo predeterminado usó ~315 MB de RAM en reposo frente a 211 MB con el modo de sistema de archivos, lo que supone ~100 MB menos de memoria en reposo.
Recomendado: almacenamiento en sistema de archivos
N8N_DEFAULT_BINARY_DATA_MODE=filesystem
N8N_BINARY_DATA_TTL=1440 # Clean up after 24 hours (value in minutes)
Beneficios: Almacena archivos en disco en lugar de RAM, rendimiento significativamente mejor con archivos grandes, listo para producción y recomendado por n8n. N8N_BINARY_DATA_TTL no tiene efecto desde n8n 1.9.0: n8n elimina los datos binarios cuando depura las ejecuciones, por lo que los ajustes de depuración de ejecuciones controlan el uso del disco.
Importante: Si usa el modo de cola (ejecución distribuida basada en Redis), tenga en cuenta que n8n no admite el modo de sistema de archivos en ese caso. A octubre de 2026, la documentación de n8n recomienda el modo database para el modo de cola.
Impacto en un entorno real
De nuestras pruebas en Docker en octubre de 2025 con n8n versión 1.115.2:
| Configuración | Uso de memoria | Diferencia |
|---|---|---|
| Predeterminado (sin correcciones) | 315 MB | Línea de base |
| Con corrección del tamaño de la carga útil + modo sistema de archivos | 211 MB | -104 MB |
Hallazgo clave: En nuestras mediciones en reposo, la configuración con el ajuste de carga útil y el modo binario de sistema de archivos usó menos memoria que la predeterminada. No medimos la memoria bajo carga con solicitudes grandes, donde el uso depende de sus flujos de trabajo.
Corrección #2: problemas con las URL de webhooks
El problema en detalle
Cuando n8n genera URL de webhook para mostrar en el editor y registrar con servicios externos, intenta detectar automáticamente su URL pública. Detrás de un proxy inverso, esta detección automática falla por completo.
Lo que verá (las URL incorrectas)
http://n8n.yourdomain.com:5678/webhook/abc123
Problemas con esta URL:
- Número de puerto incluido (
:5678) – los servicios externos típicamente no pueden alcanzar puertos no estándar - Protocolo incorrecto (http frente a https) – muchos servicios requieren HTTPS
- Nombre de host interno – podría ser el nombre del contenedor Docker en lugar del dominio público
Por qué fallan los servicios externos
Servicios como GitHub, Slack, Stripe, Zoom, Google Sheets y cientos más intentan enviar webhooks a estas URL incorrectas y fallan silenciosamente. Configura la integración, parece correcta en la interfaz, pero las notificaciones nunca llegan.
La solución: variable de entorno WEBHOOK_URL
Según la documentación oficial de n8n:
«La variable de entorno WEBHOOK_URL se usa para establecer manualmente la URL del webhook para que n8n pueda mostrarla en la interfaz del editor y registrar las URL de webhook correctas con servicios externos. Al ejecutar n8n detrás de un proxy inverso, es importante establecer esta variable».
Configuración básica
environment:
- WEBHOOK_URL=https://n8n.yourdomain.com
- N8N_EDITOR_BASE_URL=https://n8n.yourdomain.com
- N8N_PROTOCOL=https
- N8N_HOST=n8n.yourdomain.com
- N8N_TRUST_PROXY_HEADER=true
- N8N_PROXY_HOPS=1
Qué hace cada variable
WEBHOOK_URL (LA MÁS IMPORTANTE)
- La URL pública para todos los endpoints de webhook
- Se usa al registrar webhooks con servicios externos
- Debe coincidir exactamente con su configuración de Traefik/proxy inverso
- Nota de versión: Renombrada de
WEBHOOK_TUNNEL_URLen v0.227.0, nombre antiguo eliminado en n8n 1.0
N8N_EDITOR_BASE_URL
- La URL para acceder a la interfaz web de n8n
- Generalmente la misma que WEBHOOK_URL
- Se muestra en la barra de direcciones del navegador y en invitaciones por correo
N8N_PROTOCOL
- Establecer en
httpspara producción (con SSL/TLS) - Establecer en
httpsolo para pruebas locales - Debe coincidir con la terminación de la conexión en su proxy inverso
N8N_HOST
- Solo su nombre de dominio público
- No incluya protocolo (
https://) ni puerto - Ejemplo:
n8n.yourdomain.comnohttps://n8n.yourdomain.com:443
N8N_TRUST_PROXY_HEADER
- No es una variable documentada de n8n: no aparece en la referencia de variables de entorno de n8n, por lo que configurarla no tiene ningún efecto documentado
- La confianza en los encabezados del proxy (para las direcciones IP reales del cliente) se controla mediante
N8N_PROXY_HOPS - Puede omitirla en los ejemplos de esta guía
N8N_PROXY_HOPS
- Establecer en
1cuando está detrás de un proxy inverso - Establecer en
2si está detrás de dos proxies (raro) - Indica a n8n en cuántas capas de proxy debe confiar
Prueba de URL de webhooks
Antes de la corrección
En la interfaz de n8n, cree un nodo Webhook y verifique la URL mostrada:
http://n8n.example.com:5678/webhook/abc123 ❌ Incorrecto
Después de la corrección
El mismo nodo Webhook ahora muestra:
https://n8n.example.com/webhook/abc123 ✅ Correcto
Diferencia crítica: Los servicios externos ahora pueden alcanzar esta URL porque usa el puerto HTTPS estándar 443 (manejado por su proxy inverso) en lugar del puerto interno 5678.
Configuración completa de producción con Traefik
¿Por qué Traefik?
Traefik es un proxy inverso moderno muy adecuado para despliegues con Docker – HTTPS automático a través de Let's Encrypt sin gestión manual de certificados, descubrimiento de servicios que detecta automáticamente contenedores a través de etiquetas Docker, soporte nativo de WebSocket para la conexión en vivo del editor de n8n, configuración fácil con solo etiquetas Docker en lugar de archivos de configuración complejos, y un panel integrado para monitorear el enrutamiento y los certificados en tiempo real.
Descripción general de la arquitectura
Internet
↓
[Traefik Reverse Proxy]
↓ HTTPS (Let's Encrypt)
↓ WebSocket Support
[Contenedor n8n]
↓ Red interna
[Base de datos PostgreSQL]
Soporte de WebSocket
Traefik actúa como proxy de conexiones WebSocket de forma nativa, incluida la conexión en vivo del editor de n8n, por lo que no necesita middleware adicional. Los webhooks son solicitudes HTTPS normales y no dependen de WebSocket. El ejemplo de producción siguiente incluye etiquetas opcionales de encabezados WebSocket; puede omitirlas.
Docker Compose completo de producción
Esta configuración combina ambas correcciones, incluye Traefik con soporte WebSocket adecuado y sigue las mejores prácticas de producción:
version: '3.8'
networks:
traefik-net:
external: true
n8n-internal:
internal: true
services:
# PostgreSQL Database
postgres:
image: postgres:16-alpine
container_name: n8n-postgres
restart: unless-stopped
networks:
- n8n-internal
environment:
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=${DB_PASSWORD}
- POSTGRES_DB=n8n
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U n8n"]
interval: 10s
timeout: 5s
retries: 5
deploy:
resources:
limits:
memory: 512M
# n8n Application
n8n:
image: n8nio/n8n:latest
container_name: n8n
restart: unless-stopped
depends_on:
postgres:
condition: service_healthy
networks:
- traefik-net
- n8n-internal
# Traefik Configuration Labels
labels:
# Enable Traefik for this container
- "traefik.enable=true"
- "traefik.docker.network=traefik-net"
# Router configuration
- "traefik.http.routers.n8n.rule=Host(`${N8N_DOMAIN}`)"
- "traefik.http.routers.n8n.entrypoints=websecure"
- "traefik.http.routers.n8n.tls.certresolver=letsencrypt"
# Service configuration
- "traefik.http.services.n8n.loadbalancer.server.port=5678"
# Middleware: Request size limit in bytes (256MB, matches N8N_PAYLOAD_SIZE_MAX)
- "traefik.http.middlewares.n8n-buffering.buffering.maxRequestBodyBytes=268435456"
# Middleware: WebSocket headers (optional; Traefik proxies WebSockets natively)
- "traefik.http.middlewares.n8n-websocket.headers.customrequestheaders.Upgrade=websocket"
- "traefik.http.middlewares.n8n-websocket.headers.customrequestheaders.Connection=Upgrade"
# Middleware: Security headers
- "traefik.http.middlewares.n8n-security.headers.customResponseHeaders.X-Robots-Tag=noindex,nofollow"
- "traefik.http.middlewares.n8n-security.headers.sslProxyHeaders.X-Forwarded-Proto=https"
# Apply ALL middlewares
- "traefik.http.routers.n8n.middlewares=n8n-buffering,n8n-websocket,n8n-security"
environment:
# Database Configuration
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=${DB_PASSWORD}
# FIX #2: Webhook URL Configuration
- WEBHOOK_URL=https://${N8N_DOMAIN}
- N8N_EDITOR_BASE_URL=https://${N8N_DOMAIN}
- N8N_PROTOCOL=https
- N8N_HOST=${N8N_DOMAIN}
- N8N_PORT=5678
- N8N_TRUST_PROXY_HEADER=true
- N8N_PROXY_HOPS=1
# FIX #1: Payload Size Configuration
- N8N_PAYLOAD_SIZE_MAX=256 # 256 MiB
# Binary Data Management
- N8N_DEFAULT_BINARY_DATA_MODE=filesystem
- N8N_BINARY_DATA_TTL=1440 # 24 hours
# 2025 Requirement: Task Runners
- N8N_RUNNERS_ENABLED=true
- N8N_RUNNERS_MODE=internal
- N8N_RUNNERS_MAX_CONCURRENCY=5
# Production Optimizations
- NODE_ENV=production
- EXECUTIONS_DATA_MAX_AGE=168 # 7 days
- EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
- N8N_LOG_LEVEL=info
- N8N_LOG_OUTPUT=console
# Timezone (adjust to your location)
- GENERIC_TIMEZONE=America/New_York
- TZ=America/New_York
# Security
- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
volumes:
- n8n_data:/home/node/.n8n
# Resource Limits (8GB+ RAM server)
deploy:
resources:
limits:
memory: 2G
cpus: '2.0'
reservations:
memory: 1G
cpus: '1.0'
# Health Check
healthcheck:
test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:5678/healthz"]
interval: 30s
timeout: 10s
retries: 3
start_period: 40s
volumes:
n8n_data:
postgres_data:
Configuración de Traefik
Si aún no tiene Traefik ejecutándose, aquí está la configuración completa:
Paso 1: crear la red de Traefik
docker network create traefik-net
Paso 2: crear la configuración de Traefik
Cree traefik/traefik.yml:
api:
dashboard: true
entryPoints:
web:
address: ":80"
http:
redirections:
entryPoint:
to: websecure
scheme: https
websecure:
address: ":443"
providers:
docker:
endpoint: "unix:///var/run/docker.sock"
exposedByDefault: false
network: traefik-net
certificatesResolvers:
letsencrypt:
acme:
email: [email protected] # CHANGE THIS
storage: /letsencrypt/acme.json
httpChallenge:
entryPoint: web
log:
level: INFO
accessLog: {}
Paso 3: crear Docker Compose de Traefik
Cree traefik/docker-compose.yml:
version: '3.8'
networks:
traefik-net:
external: true
services:
traefik:
image: traefik:v2.10
container_name: traefik
restart: unless-stopped
security_opt:
- no-new-privileges:true
networks:
- traefik-net
ports:
- "80:80"
- "443:443"
- "8080:8080" # Dashboard (secure this in production!)
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- ./traefik.yml:/traefik.yml:ro
- ./letsencrypt:/letsencrypt
labels:
- "traefik.enable=true"
Paso 4: crear archivo de entorno
Cree .env en su directorio de n8n:
# Domain Configuration
N8N_DOMAIN=n8n.yourdomain.com
# Database Password (generate secure password)
DB_PASSWORD=your_secure_db_password_here
# n8n Encryption Key (generate random string)
N8N_ENCRYPTION_KEY=your_encryption_key_here
Genere valores seguros:
# For DB_PASSWORD
openssl rand -base64 32
# For N8N_ENCRYPTION_KEY
openssl rand -hex 32
Paso 5: lanzar todo
# Start Traefik first
cd traefik
docker compose up -d
# Wait a few seconds, then start n8n
cd ../n8n
docker compose up -d
# Watch logs to verify startup
docker compose logs -f n8n
Verificación de su configuración
Verificar el panel de Traefik
Visite http://your-server-ip:8080. Esto solo funciona si también establece api.insecure: true en traefik.yml (solo para pruebas); de lo contrario, configure un enrutador para el panel (api@internal) en su propio dominio.
Debería mostrar:
- ✅ Router de n8n activo con estado verde
- ✅ Certificado obtenido de Let's Encrypt
- ✅ Servicio marcado como saludable
Verificar acceso a n8n
Visite https://n8n.yourdomain.com
Debería mostrar:
- ✅ HTTPS funcionando con certificado válido de Let's Encrypt
- ✅ Sin advertencias de seguridad del navegador
- ✅ Página de inicio de sesión/configuración de n8n aparece correctamente
Verificar URL de webhooks
- Inicie sesión en n8n
- Cree un nuevo flujo de trabajo
- Añada un nodo Webhook
- Verifique la "URL de Producción" mostrada
Esperado:
https://n8n.yourdomain.com/webhook/abc123
No esto (significa que la configuración es incorrecta):
http://n8n.yourdomain.com:5678/webhook/abc123 ❌
Requisito 2025: ejecutores de tareas
¿Qué son los ejecutores de tareas?
Los ejecutores de tareas (task runners) ejecutan el código definido en los nodos Code dentro de procesos aislados en lugar del proceso principal de n8n. Esto proporciona mejor seguridad a través de entornos aislados, mayor estabilidad, ya que los errores de código no provocan la caída del proceso principal, y compatibilidad futura, puesto que serán obligatorios en próximas versiones de n8n.
Por qué esto importa ahora
De la documentación oficial de n8n:
«Ejecutar n8n sin ejecutores de tareas está obsoleto. Los ejecutores de tareas se activarán por defecto en una versión futura. Se aconseja a los usuarios establecer N8N_RUNNERS_ENABLED=true ahora para evitar posibles problemas en el futuro».
De nuestros registros de prueba (octubre de 2025):
There are deprecations related to your environment variables:
- N8N_RUNNERS_ENABLED -> Running n8n without task runners is deprecated.
Configuración
Modo interno (recomendado para servidor único)
environment:
- N8N_RUNNERS_ENABLED=true
- N8N_RUNNERS_MODE=internal
- N8N_RUNNERS_MAX_CONCURRENCY=5
n8n lanza el ejecutor de tareas como proceso hijo – la configuración más sencilla, sin necesidad de infraestructura adicional, adecuada para la mayoría de los despliegues autoalojados y con una carga adicional mínima. A octubre de 2026, la documentación de n8n describe el modo interno como inseguro por diseño y lo declara obsoleto a partir de n8n 3.0.
Modo externo (para configuraciones distribuidas)
environment:
- N8N_RUNNERS_ENABLED=true
- N8N_RUNNERS_MODE=external
- N8N_RUNNERS_AUTH_TOKEN=your_secure_token
Los contenedores independientes de ejecutores de tareas proporcionan un mejor aislamiento de recursos para flujos de trabajo de alto volumen, permiten escalado horizontal en múltiples servidores, y se ejecutan como un contenedor sidecar a partir de la imagen n8nio/runners, cuya versión debe coincidir con la de su imagen de n8n. Una configuración con Docker Compose es suficiente; no se requieren Docker Swarm ni Kubernetes.
Verificación de ejecutores de tareas
Verificar lista de procesos
docker exec n8n ps aux
Sin ejecutores de tareas (3 procesos):
PID USER TIME COMMAND
1 node 0:00 tini -- /docker-entrypoint.sh
7 node 0:12 node /usr/local/bin/n8n
Con ejecutores de tareas (4 procesos):
PID USER TIME COMMAND
1 node 0:00 tini -- /docker-entrypoint.sh
7 node 0:16 node /usr/local/bin/n8n
18 node 0:10 node [...]/task-runner/dist/start.js
Evidencia: Proceso de ejecutor de tareas visible con PID 18.
Verificar registros
docker logs n8n | grep -i runner
Debería ver:
n8n Task Broker ready on 127.0.0.1, port 5679
Registered runner "JS Task Runner" (zCWpF0Eb_LJsqWYvLm5t1)
Impacto en el uso de recursos
De nuestras pruebas en Docker (octubre de 2025, n8n versión 1.115.2):
| Configuración | Memoria | CPU | Procesos |
|---|---|---|---|
| Sin ejecutores de tareas | 214 MB | 0,14 % | 3 |
| Con ejecutores de tareas | 289 MB | 0,29 % | 4 |
| Diferencia | +75 MB | +0,15 % | +1 |
La carga adicional es mínima. Los beneficios —seguridad, estabilidad y compatibilidad futura— superan ampliamente el pequeño costo de recursos.
Referencia de variables de entorno
Lista completa de variables
| Variable | Tipo | Predeterminado | Propósito | Prioridad |
|---|---|---|---|---|
| Variables críticas | ||||
WEBHOOK_URL | Cadena | – | URL pública de webhook | Requerido con proxy inverso |
N8N_PAYLOAD_SIZE_MAX | Número | 16 (MiB) | Tamaño máximo de la carga útil de solicitud en MiB, incluidos los datos de ejecución parcial | Requerido para datos grandes |
N8N_RUNNERS_ENABLED | Booleano | false | Habilitar ejecutores de tareas | Recomendado en 1.x (no es necesario desde n8n 2.0) |
N8N_TRUST_PROXY_HEADER | – | – | No figura entre las variables documentadas de n8n | No es necesario; use N8N_PROXY_HOPS |
| Configuración de webhooks | ||||
N8N_EDITOR_BASE_URL | Cadena | – | URL de la interfaz del editor | Recomendado |
N8N_PROTOCOL | Cadena | http | Protocolo (http/https) | Producción |
N8N_HOST | Cadena | localhost | Nombre de host público | Producción |
N8N_PORT | Número | 5678 | Puerto interno | Opcional |
N8N_PROXY_HOPS | Número | 0 | Número de proxies inversos | Establecer en 1 con proxy |
| Rendimiento | ||||
N8N_DEFAULT_BINARY_DATA_MODE | Cadena | default | Modo de almacenamiento binario | Recomendado |
N8N_BINARY_DATA_TTL | – | – | Sin efecto desde n8n 1.9.0 (los datos binarios se depuran con las ejecuciones) | Se puede eliminar |
| Ejecutores de tareas | ||||
N8N_RUNNERS_MODE | Cadena | internal | Modo de ejecutor de tareas | Si los ejecutores están habilitados |
N8N_RUNNERS_MAX_CONCURRENCY | Número | 10 | Máximo de tareas concurrentes por ejecutor | Opcional |
Configuraciones predefinidas por escenario
Escenario a: desarrollo (máquina local)
environment:
- N8N_PORT=5678
Usar cuando: Pruebas locales, sin proxy inverso, sin requisitos de producción
Escenario b: detrás de proxy inverso (sin datos grandes)
environment:
- N8N_PORT=5678
- WEBHOOK_URL=https://n8n.yourdomain.com
- N8N_EDITOR_BASE_URL=https://n8n.yourdomain.com
- N8N_PROTOCOL=https
- N8N_HOST=n8n.yourdomain.com
- N8N_TRUST_PROXY_HEADER=true
- N8N_PROXY_HOPS=1
- N8N_RUNNERS_ENABLED=true
Usar cuando: Instancia pública de n8n, webhooks necesarios, flujos de trabajo más pequeños
Escenario c: configuración completa de producción
environment:
# Database
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=${DB_PASSWORD}
# Webhooks
- WEBHOOK_URL=https://n8n.yourdomain.com
- N8N_EDITOR_BASE_URL=https://n8n.yourdomain.com
- N8N_PROTOCOL=https
- N8N_HOST=n8n.yourdomain.com
- N8N_PORT=5678
- N8N_TRUST_PROXY_HEADER=true
- N8N_PROXY_HOPS=1
# Performance
- N8N_PAYLOAD_SIZE_MAX=256 # 256 MiB
- N8N_DEFAULT_BINARY_DATA_MODE=filesystem
- N8N_BINARY_DATA_TTL=1440
# Task Runners
- N8N_RUNNERS_ENABLED=true
- N8N_RUNNERS_MODE=internal
- N8N_RUNNERS_MAX_CONCURRENCY=5
# Production
- NODE_ENV=production
- EXECUTIONS_DATA_MAX_AGE=168 # 7 days
- EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
- N8N_LOG_LEVEL=info
# Security
- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
Usar cuando: Despliegue de producción con todas las funciones, flujos de trabajo grandes, acceso público
Ejemplos de Docker Compose
Los cuatro escenarios de nuestro entorno de pruebas están disponibles. Estas configuraciones han sido validadas con n8n versión 1.115.2 en octubre de 2025. Los ejemplos usan la etiqueta de imagen latest; fije n8nio/n8n:1.115.2 para reproducir la versión probada.
Comparación de uso de recursos (de nuestras pruebas)
| Escenario | Memoria | CPU | Procesos | Descripción |
|---|---|---|---|---|
| Predeterminado | 315 MB | 0,00 % | 3 | Sin correcciones, línea de base |
| Corrección del tamaño de la carga útil | 211 MB | 0,00 % | 3 | Carga útil + modo de sistema de archivos |
| Corrección de webhook | 215 MB | 0,14 % | 3 | Solo configuración de webhook |
| Producción | 289 MB | 0,29 % | 4 | Todas las correcciones + ejecutores de tareas |
Hallazgo clave: En reposo, la configuración de producción con todas las correcciones usó menos memoria que la predeterminada en nuestras pruebas. Son mediciones en reposo, no resultados bajo carga con solicitudes grandes.
Prueba de su configuración
Lista de verificación previa al despliegue
1. configuración DNS
# Verify DNS points to your server
nslookup n8n.yourdomain.com
# Should return your server's public IP
2. disponibilidad de puertos
# Check if required ports are free
sudo netstat -tlnp | grep -E '(80|443|5678)'
# Should show nothing or only Traefik on 80/443
3. instalación de Docker
# Verify Docker
docker --version
# Verify Docker Compose
docker compose version
4. variables de entorno
# Verify .env file exists
cat .env
# Should show N8N_DOMAIN, DB_PASSWORD, N8N_ENCRYPTION_KEY
Pasos de despliegue
# Step 1: Create Traefik network
docker network create traefik-net
# Step 2: Start Traefik
cd traefik
docker compose up -d
# Step 3: Wait for Traefik to be ready
sleep 10
# Step 4: Start n8n
cd ../n8n
docker compose up -d
# Step 5: Watch logs for any errors
docker compose logs -f n8n
Pruebas posteriores al despliegue
Prueba 1: acceso HTTPS
curl -I https://n8n.yourdomain.com
Esperado: HTTP/2 200 (o HTTP/1.1 200)
Prueba 2: redirección HTTP a HTTPS
curl -I http://n8n.yourdomain.com
Esperado: HTTP/1.1 308 Permanent Redirect con Location: https://n8n.yourdomain.com
Prueba 3: salud del contenedor
docker ps
Esperado: Tanto n8n como n8n-postgres mostrando estado (healthy)
Prueba 4: formato de URL de webhook
- Inicie sesión en la interfaz web de n8n
- Cree un nuevo flujo de trabajo
- Añada un nodo Webhook
- Verifique la URL de Producción mostrada
Formato esperado:
https://n8n.yourdomain.com/webhook/abc123
No esperado (error de configuración):
http://n8n.yourdomain.com:5678/webhook/abc123 ❌
Prueba 5: ejecutores de tareas activos
docker logs n8n | grep -i runner
Salida esperada:
Registered runner "JS Task Runner"
Prueba 6: variables de entorno aplicadas
docker exec n8n env | grep N8N_PAYLOAD_SIZE_MAX
Esperado: N8N_PAYLOAD_SIZE_MAX=256
Solución de problemas comunes
Problema: HTTPS no funciona
Síntomas: El navegador muestra advertencia "No seguro", mensajes de error de certificado, no puede acceder vía HTTPS
Diagnóstico:
# Check Traefik logs for errors
docker logs traefik | grep -i error
# Check certificate file exists
ls -la traefik/letsencrypt/acme.json
# Verify DNS resolution
nslookup n8n.yourdomain.com
Soluciones:
- DNS no apunta al servidor: Actualice su registro DNS A para apuntar a la IP pública del servidor, espere la propagación DNS (hasta 24 horas, generalmente mucho más rápido), pruebe desde otra red:
dig n8n.yourdomain.com +short - Puerto 80 bloqueado: Let's Encrypt necesita el puerto 80 para el desafío HTTP. Verifique el firewall:
sudo ufw status. Permita si está bloqueado:sudo ufw allow 80/tcp && sudo ufw allow 443/tcp - Correo electrónico inválido en configuración de Traefik: Edite
traefik/traefik.yml, actualicecertificatesResolvers.letsencrypt.acme.emaila una dirección válida, reinicie Traefik:docker compose restart
Problema: los webhooks devuelven 404
Síntomas: Los servicios externos reportan fallos en los webhooks, las URL de webhook parecen correctas pero no funcionan, el modo de prueba funciona pero el modo de producción falla
Diagnóstico:
# Test webhook directly
curl -v https://n8n.yourdomain.com/webhook/test
# Check Traefik routing logs
docker logs traefik | grep webhook
# Verify n8n sees requests
docker logs n8n | grep webhook
Soluciones:
- WEBHOOK_URL no configurada correctamente: Verifique la variable de entorno:
docker exec n8n env | grep WEBHOOK_URL. Debe coincidir exactamente con su dominio:WEBHOOK_URL=https://n8n.yourdomain.com - Configuración de red incorrecta: Verifique que n8n está en traefik-net:
docker inspect n8n | grep -A 5 Networks. Debe mostrar "traefik-net" en la salida
Problema: "execution data too large" sigue apareciendo
Síntomas: El error sigue ocurriendo después de establecer N8N_PAYLOAD_SIZE_MAX, los flujos de trabajo grandes fallan en "Execute Node"
Diagnóstico:
# Verify variable is set
docker exec n8n env | grep PAYLOAD
# Should show N8N_PAYLOAD_SIZE_MAX=256
Soluciones:
- Variable no aplicada (contenedor no recreado): Vuelva a crear el contenedor para aplicar los cambios:
docker compose up -d n8n(docker compose restartno aplica los valores de entorno modificados). Verifique después:docker exec n8n env | grep PAYLOAD - Necesita un límite mayor para su flujo de trabajo: Para servidores de 16 GB+ RAM, aumente a 512 MB:
N8N_PAYLOAD_SIZE_MAX=512 - Tamaño de solicitud de Traefik demasiado pequeño: También aumente el límite de Traefik (en bytes) para que coincida:
"traefik.http.middlewares.n8n-buffering.buffering.maxRequestBodyBytes=536870912"
Problema: alto uso de memoria
Síntomas: El contenedor usa >1,5 GB de RAM en reposo, el uso de memoria crece con el tiempo, errores de falta de memoria
Diagnóstico:
# Monitor memory
docker stats n8n
# Check binary data mode
docker exec n8n env | grep BINARY_DATA_MODE
Soluciones:
- No se utiliza el modo de sistema de archivos: Añada al entorno:
N8N_DEFAULT_BINARY_DATA_MODE=filesystem. Impacto: ~100 MB menos de memoria en reposo en nuestras pruebas - Acumulación de ejecuciones antiguas: Reduzca el período de retención:
EXECUTIONS_DATA_MAX_AGE=168(7 días en lugar de 14) yEXECUTIONS_DATA_PRUNE_MAX_COUNT=1000 - Límite del contenedor demasiado bajo: Aumente si el servidor tiene capacidad. Cambie el límite de memoria de 2G a 4G en la sección de recursos del despliegue
Conclusión
Lo que hemos resuelto
Esta guía integral aborda los dos problemas más comunes de n8n autoalojado:
- ✅ Error de datos de ejecución demasiado grandes – Corregido con
N8N_PAYLOAD_SIZE_MAXy modo binario de sistema de archivos - ✅ Problemas con URL de webhooks – Corregido con
WEBHOOK_URLy configuración adecuada de proxy inverso
Más estas adiciones críticas:
- ✅ Configuración completa de Traefik – Configuración lista para producción con soporte WebSocket
- ✅ Configuración de ejecutores de tareas – Requisito de 2025 para compatibilidad futura
- ✅ Mejores prácticas de producción – Límites de recursos, verificaciones de salud, encabezados de seguridad, monitoreo
- ✅ Configuraciones validadas – Todos los archivos docker-compose probados con n8n 1.115.2 en octubre de 2025
Puntos clave
Para correcciones rápidas:
- Establezca
N8N_PAYLOAD_SIZE_MAX=256para problemas de datos de ejecución (256 MB para 8 GB+ RAM) - Establezca
WEBHOOK_URL=https://your-domain.compara problemas de webhooks - Establezca
N8N_RUNNERS_ENABLED=truepara eliminar advertencias de obsolescencia - Use
N8N_DEFAULT_BINARY_DATA_MODE=filesystem(unos 100 MB menos de memoria en reposo en nuestras pruebas)
Para despliegue en producción:
- Use nuestro docker-compose.yml completo con configuración de Traefik
- No necesita middleware WebSocket – Traefik actúa como proxy de WebSocket de forma nativa y los webhooks son solicitudes HTTPS normales
- Incluya PostgreSQL para mejorar el rendimiento bajo carga
- Establezca límites de recursos apropiados según la capacidad de su servidor
- Implemente verificaciones de salud para que el monitoreo y los servicios dependientes detecten fallos (Docker por sí solo marca el contenedor como no saludable, pero no lo reinicia)
Para usuarios de Traefik (crítico):
- Traefik gestiona WebSocket sin middleware adicional; los webhooks necesitan un enrutador correcto y
WEBHOOK_URL - Establezca el límite de tamaño del cuerpo de solicitud para igualar o superar el tamaño de la carga útil
- Configure encabezados de seguridad (X-Robots-Tag, X-Forwarded-Proto)
- Asegúrese de que el DNS apunte a su servidor antes de iniciar Traefik (requisito de Let's Encrypt)
Novedades respecto a las publicaciones de junio de 2025
| Característica | Publicaciones junio 2025 | Esta guía |
|---|---|---|
| Corrección de datos de ejecución | ✅ Detallada | ✅ Incluida + mediciones de recursos |
| Corrección de webhook | ✅ Detallada | ✅ Incluida + integración con Traefik |
| Configuración de Traefik | ❌ No cubierta | ✅ Configuración completa |
| Soporte WebSocket | ❌ No cubierto | ✅ Enfatizado |
| Ejecutores de tareas | ❌ No cubiertos | ✅ Requisito 2025 |
| Docker-compose combinado | ❌ Separados | ✅ Listo para producción |
| Mediciones de recursos | ❌ Teóricas | ✅ Datos reales de pruebas |
| Variables de entorno | ✅ Cubiertas | ✅ Referencia completa |
Pruebas y validación
Nuestro entorno de pruebas (octubre de 2025):
- ✅ n8n versión 1.115.2
- ✅ Contenedores Docker ejecutándose durante 2+ horas
- ✅ Todas las variables de entorno verificadas en contenedores en ejecución
- ✅ Uso de recursos medido con
docker stats - ✅ Proceso de ejecutor de tareas confirmado en lista de procesos
- ✅ Endpoints HTTP probados y accesibles
- ✅ Configuraciones validadas como funcionales
Próximos pasos
- Elija su escenario:
- Desarrollo: Configuración mínima
- Detrás de proxy inverso: Corrección de webhook + ejecutores de tareas
- Producción: configuración completa con Traefik (recomendado)
- Despliegue:
- Copie el docker-compose.yml apropiado
- Cree el archivo .env con su dominio y contraseñas seguras
- Inicie Traefik primero, luego n8n
- Ejecute las pruebas posteriores al despliegue
- Valide:
- Verifique que HTTPS funciona con certificado válido
- Compruebe que las URL de webhook muestran el formato correcto
- Pruebe con un gran conjunto de datos (si es necesario)
- Confirme que los ejecutores de tareas están registrados
- Monitoree:
- Observe el uso de recursos con
docker stats - Configure alertas de verificación de salud (monitoreo externo)
- Implemente rotación de registros para evitar que el disco se llene
- Planifique copias de seguridad regulares de los volúmenes de datos
- Observe el uso de recursos con
Recursos relacionados
De junio de 2025:
- Solución del error "Existing execution data is too large" de n8n – Guía detallada de solución de problemas
- Corrección de problemas de webhooks en n8n – Guía completa de depuración de webhooks
Documentación oficial de n8n:
- Configuración de URL de webhooks
- Referencia de variables de entorno
- Ejecutores de tareas
- Gestión de datos binarios
- Escalado de datos de ejecución
¿Preguntas o problemas?
Si encuentra problemas no cubiertos en esta guía:
- Revise nuestras publicaciones detalladas de solución de problemas de junio de 2025 para obtener orientación adicional
- Consulte la documentación oficial de n8n para conocer las funciones más recientes
- Busque en los foros de la comunidad n8n problemas similares
- Consulte la sección de Solución de Problemas anterior para problemas comunes
- Contacte a tva para soporte profesional de implementación
Pruebas reproducibles
Todas las configuraciones en esta guía pueden reproducirse en su propio entorno – los archivos Docker Compose están listos para producción, las variables de entorno están documentadas y verificadas, se proporcionan comandos de prueba para validación, y las salidas esperadas están claramente especificadas. Puede validar cada afirmación en esta guía desplegando las configuraciones usted mismo y ejecutando las pruebas proporcionadas.
¿Necesita ayuda con la implementación?
Si desea que tva se encargue de su despliegue de n8n o necesita asistencia con la configuración de producción, póngase en contacto con nosotros. Implementamos estas configuraciones para organizaciones que buscan infraestructura n8n fiable y lista para producción.
Publicado: 15 de octubre de 2025
Probado con: n8n v1.115.2, Docker Compose v3.8, Traefik v2.10
Requisitos del servidor: 4 GB+ RAM, 2+ núcleos de CPU recomendados para producción
Basado en: Documentación oficial de n8n, pruebas validadas en Docker y mejores prácticas de la comunidad
Artículos relacionados
Resolver problemas de webhooks en n8n: guía completa para instancias autoalojadas
Cómo resolver el error «Existing execution data is too large» de n8n: solución completa para instancias autoalojadas
n8n 2.x autoalojado: diagnostique los límites de los datos de ejecución y amplíe el payload con seguridad