tva
← Artículos

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

  1. Diagnóstico rápido: ¿Qué problema tiene?
  2. Comprensión de los dos problemas principales
  3. Corrección #1: Error de datos de ejecución demasiado grandes
  4. Corrección #2: Problemas con las URL de webhooks
  5. Configuración completa de producción con Traefik
  6. Requisito 2025: Ejecutores de tareas
  7. Referencia de variables de entorno
  8. Ejemplos de Docker Compose
  9. Prueba de su configuración
  10. 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 servidorN8N_PAYLOAD_SIZE_MAXValor que debe configurar (MiB)Porcentaje de RAM
2 GB o menos64 MB64~3 %
4 GB128 MB128~3 %
8 GB256 MB256~3 %
16 GB+512 MB512~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ónUso de memoriaDiferencia
Predeterminado (sin correcciones)315 MBLínea de base
Con corrección del tamaño de la carga útil + modo sistema de archivos211 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:

  1. Número de puerto incluido (:5678) – los servicios externos típicamente no pueden alcanzar puertos no estándar
  2. Protocolo incorrecto (http frente a https) – muchos servicios requieren HTTPS
  3. 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_URL en 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 https para producción (con SSL/TLS)
  • Establecer en http solo 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.com no https://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 1 cuando está detrás de un proxy inverso
  • Establecer en 2 si 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

  1. Inicie sesión en n8n
  2. Cree un nuevo flujo de trabajo
  3. Añada un nodo Webhook
  4. 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ónMemoriaCPUProcesos
Sin ejecutores de tareas214 MB0,14 %3
Con ejecutores de tareas289 MB0,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

VariableTipoPredeterminadoPropósitoPrioridad
Variables críticas
WEBHOOK_URLCadena–URL pública de webhookRequerido con proxy inverso
N8N_PAYLOAD_SIZE_MAXNúmero16 (MiB)Tamaño máximo de la carga útil de solicitud en MiB, incluidos los datos de ejecución parcialRequerido para datos grandes
N8N_RUNNERS_ENABLEDBooleanofalseHabilitar ejecutores de tareasRecomendado en 1.x (no es necesario desde n8n 2.0)
N8N_TRUST_PROXY_HEADER––No figura entre las variables documentadas de n8nNo es necesario; use N8N_PROXY_HOPS
Configuración de webhooks
N8N_EDITOR_BASE_URLCadena–URL de la interfaz del editorRecomendado
N8N_PROTOCOLCadenahttpProtocolo (http/https)Producción
N8N_HOSTCadenalocalhostNombre de host públicoProducción
N8N_PORTNúmero5678Puerto internoOpcional
N8N_PROXY_HOPSNúmero0Número de proxies inversosEstablecer en 1 con proxy
Rendimiento
N8N_DEFAULT_BINARY_DATA_MODECadenadefaultModo de almacenamiento binarioRecomendado
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_MODECadenainternalModo de ejecutor de tareasSi los ejecutores están habilitados
N8N_RUNNERS_MAX_CONCURRENCYNúmero10Máximo de tareas concurrentes por ejecutorOpcional

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)

EscenarioMemoriaCPUProcesosDescripción
Predeterminado315 MB0,00 %3Sin correcciones, línea de base
Corrección del tamaño de la carga útil211 MB0,00 %3Carga útil + modo de sistema de archivos
Corrección de webhook215 MB0,14 %3Solo configuración de webhook
Producción289 MB0,29 %4Todas 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

  1. Inicie sesión en la interfaz web de n8n
  2. Cree un nuevo flujo de trabajo
  3. Añada un nodo Webhook
  4. 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:

  1. 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
  2. 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
  3. Correo electrónico inválido en configuración de Traefik: Edite traefik/traefik.yml, actualice certificatesResolvers.letsencrypt.acme.email a 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:

  1. 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
  2. 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:

  1. Variable no aplicada (contenedor no recreado): Vuelva a crear el contenedor para aplicar los cambios: docker compose up -d n8n (docker compose restart no aplica los valores de entorno modificados). Verifique después: docker exec n8n env | grep PAYLOAD
  2. 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
  3. 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:

  1. 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
  2. Acumulación de ejecuciones antiguas: Reduzca el período de retención: EXECUTIONS_DATA_MAX_AGE=168 (7 días en lugar de 14) y EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
  3. 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:

  1. ✅ Error de datos de ejecución demasiado grandes – Corregido con N8N_PAYLOAD_SIZE_MAX y modo binario de sistema de archivos
  2. ✅ Problemas con URL de webhooks – Corregido con WEBHOOK_URL y configuración adecuada de proxy inverso

Más estas adiciones críticas:

  1. ✅ Configuración completa de Traefik – Configuración lista para producción con soporte WebSocket
  2. ✅ Configuración de ejecutores de tareas – Requisito de 2025 para compatibilidad futura
  3. ✅ Mejores prácticas de producción – Límites de recursos, verificaciones de salud, encabezados de seguridad, monitoreo
  4. ✅ 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=256 para problemas de datos de ejecución (256 MB para 8 GB+ RAM)
  • Establezca WEBHOOK_URL=https://your-domain.com para problemas de webhooks
  • Establezca N8N_RUNNERS_ENABLED=true para 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ísticaPublicaciones junio 2025Esta 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

  1. 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)
  2. 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
  3. 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
  4. 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

Recursos relacionados

De junio de 2025:

Documentación oficial de n8n:

¿Preguntas o problemas?

Si encuentra problemas no cubiertos en esta guía:

  1. Revise nuestras publicaciones detalladas de solución de problemas de junio de 2025 para obtener orientación adicional
  2. Consulte la documentación oficial de n8n para conocer las funciones más recientes
  3. Busque en los foros de la comunidad n8n problemas similares
  4. Consulte la sección de Solución de Problemas anterior para problemas comunes
  5. 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