Por qué n8n se desconecta en tu VPS
Distingue el aviso de websocket, los reinicios del contenedor, un kill por falta de memoria y una tarea programada que no se ejecuta en n8n.
Por qué n8n se desconecta: cuatro fallos, un síntoma
«n8n se desconecta» es una frase que engloba cuatro fallos distintos, y cada uno requiere una solución diferente. El editor muestra un aviso de pérdida de conexión mientras el contenedor funciona con normalidad. El contenedor se reinicia solo. El kernel termina el proceso de Node.js porque consume demasiada memoria. O el proceso no tiene ningún problema y un workflow activo simplemente nunca se ejecuta. Si cambia el ajuste equivocado, pasará todo un fin de semana resolviendo un problema que no existía.
Por tanto, determine qué fallo tiene antes de modificar la configuración. n8n ejecuta un proceso principal de Node.js, normalmente dentro de un contenedor Docker, detrás de un reverse proxy que termina TLS (seguridad de la capa de transporte). Los nodos de código también usan procesos de task runner: el modo interno inicia un proceso hijo, mientras que el modo externo los ejecuta por separado, normalmente en un contenedor sidecar. Cada capa falla de una forma distinta, y el navegador informa de los fallos de conexión con el mismo mensaje.
Diagnostique en este orden
Ejecute estos comandos en el VPS (servidor privado virtual) y lea los valores que muestra su propia máquina. No los compare con números de una publicación del foro. Los valores relevantes describen su servidor, no el de otra persona.
docker ps -a --filter name=n8n
docker logs --tail 200 --timestamps n8n
docker inspect n8n | grep -iE 'Status|Running|RestartCount|OOMKilled|ExitCode'
docker stats --no-streamLa columna STATUS de docker ps -a indica cuánto tiempo lleva el contenedor en su estado actual. Compárela con el momento en que empezó el problema. Si el contenedor lleva activo desde mucho antes de que apareciera el mensaje, eso descarta que se reiniciara en ese momento, pero no demuestra que n8n siguiera disponible. Compruebe /healthz para verificar la accesibilidad y /healthz/readiness para confirmar que la base de datos está conectada y migrada antes de pasar a la ruta de websocket que se explica en la sección siguiente.
RestartCount indica cuántas veces Docker ha reiniciado este contenedor. Anote el número, espere un minuto y vuelva a leerlo. Si el número aumenta mientras lo observa, hay un bucle de reinicios. Las líneas del registro inmediatamente anteriores a cada reinicio contienen la causa.
OOMKilled es un indicador con valor verdadero o falso. True significa que Docker registró la terminación del contenedor por falta de memoria. Léalo junto con los registros y los mensajes del kernel para determinar qué proceso terminó y si la presión procedía del límite del contenedor o de toda la máquina.
ExitCode es el código con el que salió el contenedor la última vez. No necesita memorizar el significado de cada código. Lea el suyo y, después, lea el final de docker logs correspondiente a la misma marca de tiempo. El final del registro y el indicador de falta de memoria, considerados conjuntamente, muestran lo que ocurrió. Cualquiera de los dos por separado puede inducir a error.
docker stats muestra el uso de memoria actual junto al límite aplicado. Déjelo ejecutándose en una segunda terminal, active el flujo de trabajo que provoca el problema y observe cómo cambia el número mientras se produce el fallo.
El aviso de pérdida de conexión suele indicar un problema en el reverse proxy
El editor de n8n mantiene abierta una conexión de larga duración con el backend para transmitir el progreso de las ejecuciones al lienzo. De forma predeterminada, esa conexión es un WebSocket, que es lo que selecciona N8N_PUSH_BACKEND, y su valor predeterminado es websocket. Un WebSocket comienza como una solicitud HTTP normal que incluye las cabeceras Connection: Upgrade y Upgrade: websocket. El servidor responde 101 Switching Protocols y, a partir de ese momento, ambos extremos usan el mismo socket TCP en las dos direcciones.
Dos problemas del proxy pueden interrumpir esa conexión. El proxy usa HTTP/1.0 hacia el upstream o elimina las cabeceras de actualización, por lo que la actualización nunca se completa y el editor intenta conectarse de nuevo indefinidamente. También puede ocurrir que la actualización se complete y que el proxy cierre el socket más adelante por falta de actividad, porque un WebSocket sin mensajes parece exactamente una conexión inactiva. n8n también rechaza las conexiones push cuando fallan la autenticación o la validación de la solicitud, por ejemplo si falta pushRef o el origen no es válido. El aviso indica que el navegador perdió el canal. No demuestra que el contenedor funcione correctamente.
Confírmelo en el navegador antes de modificar nada. Abra las herramientas de desarrollo, vaya a la pestaña Network, filtre por WS y vuelva a cargar el editor. La solicitud push debe llegar a 101 Switching Protocols y permanecer abierta. Si una solicitud push devuelve un código de estado normal o vuelve a aparecer cada pocos segundos, revise su respuesta y los registros de n8n para buscar errores del proxy, de autenticación o de origen.
Configuración de nginx para mantener conectado el editor
nginx no reenvía una actualización si no se lo indica. Connection y Upgrade son cabeceras salto a salto que nginx elimina al reenviar la solicitud, por lo que hay que volver a incluirlas. El protocolo ascendente depende de la versión de nginx: desde 1.29.7 (marzo de 2026), proxy_pass usa HTTP/1.1 con el backend de forma predeterminada; antes usaba HTTP/1.0, que no puede transportar ninguna actualización. Ejecute nginx -v para comprobar cuál tiene. La configuración siguiente mantiene proxy_http_version 1.1 explícito para que funcione con ambas versiones. En 1.29.7 y posteriores, esa línea simplemente repite el valor predeterminado. El bloque map va en el contexto http, no dentro de server. Si el resto del bloque de servidor siguiente no le resulta familiar, el recorrido línea por línea de un bloque de servidor de nginx explica qué hace cada directiva.
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}server {
listen 443 ssl;
http2 on;
server_name n8n.example.com;
location / {
proxy_pass http://127.0.0.1:5678;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_buffering off;
}
}proxy_read_timeout tiene un valor predeterminado de 60 segundos y también se aplica a un WebSocket actualizado. El tiempo se mide entre las lecturas del backend. n8n envía pings de mantenimiento cada 60 segundos, por lo que una instancia de flujo de trabajo inactiva no implica que el socket no transporte tráfico. Aumentar el tiempo de espera deja margen para que lleguen esos pings sin competir con el tiempo de espera predeterminado. Los marcos de ping periódicos también reinician el contador.
sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -iE 'proxy_http_version|upgrade|proxy_read_timeout'nginx -T prueba e imprime los archivos de configuración, incluidos los archivos incorporados, en lugar de inspeccionar la configuración que ya ha cargado el proceso en ejecución. Confirme también que la recarga se haya completado correctamente. Si la configuración está en un archivo que ninguna línea include incorpora, la corrección válida parecerá no tener ningún efecto.
Después, indique a n8n que está detrás de un proxy, porque genera las URL a partir de estos valores.
environment:
- N8N_HOST=n8n.example.com
- N8N_PROTOCOL=https
- N8N_PORT=5678
- N8N_PROXY_HOPS=1
- N8N_WEBHOOK_URL=https://n8n.example.com/N8N_PROXY_HOPS tiene un valor predeterminado de 0. Esto significa que n8n trata la dirección de conexión como la dirección del cliente e ignora X-Forwarded-For. Establézcalo en el número de proxies que hay delante del contenedor. Desde octubre de 2026, N8N_WEBHOOK_URL es el nombre actual. WEBHOOK_URL sigue funcionando, pero muestra un aviso de obsolescencia al iniciar.
Traefik reenvía WebSocket automáticamente
Traefik reenvía una solicitud de actualización a WebSocket sin middleware ni etiquetas adicionales. Sus valores predeterminados de tiempo de espera HTTP no establecen un tiempo de espera para un WebSocket actualizado. Los parámetros siguientes se configuran en el entryPoint: en octubre de 2026, en Traefik v3, idleTimeout tiene un valor predeterminado de 180 segundos para las conexiones HTTP keep-alive inactivas y readTimeout tiene un valor predeterminado de 60 segundos para leer la solicitud, incluido su cuerpo. El tiempo de espera de escritura de la respuesta excluye explícitamente las actualizaciones de protocolo. Este ejemplo cambia los tiempos de espera HTTP; no es una solución confirmada para un banner de WebSocket.
entryPoints:
websecure:
address: ":443"
transport:
respondingTimeouts:
readTimeout: 0
idleTimeout: 3600sCaddy gestiona la actualización automáticamente en reverse_proxy y no necesita ninguna directiva para ello. Si no puede cambiar el proxy porque pertenece a otra persona, cambie el canal de inserción mediante N8N_PUSH_BACKEND=sse. SSE (eventos enviados por el servidor) es una respuesta HTTP normal que permanece abierta, por lo que funciona con un proxy que rechaza las actualizaciones, aunque un tiempo de espera agresivo por inactividad también puede interrumpirla. Elegir el proxy es una decisión independiente, y la comparación entre nginx, Caddy y Traefik explica cuánto esfuerzo operativo requiere cada uno.
Cuando el contenedor realmente se reinicia
Si RestartCount aumenta, el contenedor falla y Docker lo vuelve a iniciar. Compare las marcas de tiempo de los registros con cada reinicio y lea lo que ocurrió inmediatamente antes. Entre las causas habituales se incluyen un error de configuración que impide el arranque, una base de datos a la que n8n no puede conectarse, un bloqueo después del arranque y una terminación por falta de memoria.
Empiece por el volumen, porque los permisos suelen pasar desapercibidos. La imagen oficial se ejecuta con el usuario sin privilegios node y guarda sus datos en /home/node/.n8n. Si un bind mount no permite escribir a ese usuario, el proceso falla cuando intenta guardar sus datos y una política de reinicio puede convertir el fallo en un bucle.
docker compose config
docker run --rm -it --entrypoint sh docker.n8n.io/n8nio/n8n -c 'id'
docker exec n8n ls -ld /home/node/.n8nUn volumen con nombre nuevo hereda la propiedad del directorio de la imagen cuando Docker lo rellena; un volumen existente aún requiere comprobar sus permisos. Si necesita un bind mount, chown el directorio del host al ID de usuario numérico que mostró el comando id. Conviene entender una vez cómo se asigna la propiedad entre el host y el contenedor, y la explicación de PUID y PGID describe cómo estas imágenes determinan quién escribe los archivos.
El cierre por falta de memoria que parece un bloqueo
Hay dos límites de memoria independientes por encima de un proceso de n8n, y cada uno falla de forma distinta. El límite del grupo de control del contenedor lo aplica el kernel: si el uso alcanza el límite y no se puede reducir, el kernel invoca al terminador OOM. El uso puede superar temporalmente ese límite. Un cierre por OOM no da al proceso afectado la oportunidad de escribir una entrada de registro final, y Docker lo registra en OOMKilled. El límite del heap de V8 se aplica dentro de Node.js: agotarlo produce un error fatal del heap y cierra el proceso sin que el kernel invoque al terminador OOM. Desde el navegador, ambos casos parecen iguales. Lea docker inspect junto con los registros para distinguirlos.
Establezca el límite del heap de Node por debajo del límite del contenedor y deje espacio para las asignaciones nativas, los búferes, otras regiones del heap y otros procesos del contenedor. Un límite de heap más alto aumenta el riesgo de que el kernel cierre el proceso por OOM antes de que V8 alcance su propio límite, pero no lo garantiza: se puede recuperar memoria o usar swap, y la carga de trabajo podría no agotar ninguno de los dos límites. Un límite de heap más bajo tampoco garantiza que se produzca un error del heap antes de que el contenedor se cierre por OOM.
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: unless-stopped
environment:
- NODE_OPTIONS=--max-old-space-size=<MiB, below the container limit>
deploy:
resources:
limits:
memory: <your container limit>Sustituya el marcador de posición del heap por un valor numérico en MiB, con el formato --max-old-space-size=SIZE. Elija ambos números según los recursos reales de su VPS y deje espacio para la base de datos, el proxy y el sistema operativo. docker stats --no-stream muestra el uso actual junto al límite aplicado, para que pueda comprobar que el límite escrito es el que Docker aplicó. Cómo se aplican los límites de memoria de Compose explica qué clave prevalece cuando se establecen varias.
Los datos de ejecución son lo que sigue creciendo en segundo plano
Una ejecución contiene la salida de todos los nodos mientras el flujo está en curso. Después, n8n almacena esos datos según la configuración de guardado de ejecuciones. De aquí se derivan dos consecuencias. La cantidad de datos y el trabajo que realiza cada nodo afectan al uso máximo de memoria. Por tanto, un flujo que procesa diez mil filas a la vez es un programa distinto del mismo flujo cuando procesa doscientas cada vez. Además, la copia almacenada sigue creciendo hasta que algo la elimina.
La depuración resuelve el segundo problema. En octubre de 2026, los valores predeterminados son la depuración habilitada, EXECUTIONS_DATA_MAX_AGE en 336 horas (14 días) y EXECUTIONS_DATA_PRUNE_MAX_COUNT en 10000. Son valores generosos para un VPS pequeño que ejecuta SQLite, donde un único archivo contiene todos los datos y el mismo proceso que sirve el editor tiene que leerlos y escribirlos.
environment:
- EXECUTIONS_DATA_PRUNE=true
- EXECUTIONS_DATA_MAX_AGE=72
- EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
- EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
- EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=falseEXECUTIONS_DATA_SAVE_ON_SUCCESS=none es la configuración más restrictiva. Deshabilita el guardado de ejecuciones correctas. Las ejecuciones fallidas se conservan si EXECUTIONS_DATA_SAVE_ON_ERROR mantiene su valor predeterminado de all, y la configuración individual de cada flujo puede sobrescribir estas opciones. Decídalo de forma deliberada, porque un flujo que haya producido una salida incorrecta sin generar un error no dejará nada que inspeccionar. La depuración también marca primero las filas como eliminadas y las elimina en una pasada posterior. Además, SQLite reutiliza las páginas liberadas en lugar de devolverlas, por lo que el archivo del disco no reduce su tamaño en cuanto cambia la configuración.
Para reducir el uso máximo en lugar del total almacenado, mueva menos datos en cada ejecución. Divida los trabajos grandes en subflujos que devuelvan resultados pequeños al flujo principal, use lotes con el nodo Loop Over Items y no cargue conjuntos de datos completos en el nodo Code.
Los archivos binarios no deben pasar por la memoria
N8N_DEFAULT_BINARY_DATA_MODE tiene el valor predeterminado default, que mantiene los datos binarios en la memoria de la ejecución en curso. Los archivos que descarga un flujo de trabajo aumentan ese consumo de memoria. Un solo flujo de trabajo que obtiene varios archivos adjuntos grandes puede hacer que el proceso supere un límite que las operaciones habituales con JSON nunca alcanzan. Por eso el error se produce con un flujo de trabajo concreto y no en un momento determinado.
environment:
- N8N_DEFAULT_BINARY_DATA_MODE=filesystemCon filesystem, los datos binarios se escriben en N8N_BINARY_DATA_STORAGE_PATH. De forma predeterminada, esta ruta se encuentra dentro de la carpeta de usuario de n8n y, por tanto, usa el mismo volumen que el resto de los datos. Compruebe que el volumen tenga espacio suficiente antes de cambiar esta opción. N8N_PAYLOAD_SIZE_MAX establece el tamaño máximo de la carga útil entrante de un webhook en MiB (mebibytes) y su valor predeterminado es 16. Al aumentarlo, permite recibir solicitudes más grandes, pero también acepta un mayor consumo de memoria.
El resto de los servicios que comparten el servidor compiten por la misma RAM. Si los procesos OOM empezaron después de añadir un contenedor de base de datos, ejecutar la base de datos en Docker o en el host es la decisión que debe tomar.
Política de reinicio y recuperación tras un reinicio
Un contenedor sin una política de reinicio permanece detenido después de salir y también después de que se reinicie el host. restart: unless-stopped lo inicia de nuevo en ambos casos, pero respeta los contenedores que detuvo manualmente. restart: always también reinicia un contenedor detenido deliberadamente cuando Docker vuelve a iniciarse.
n8n proporciona un endpoint de estado identificado por N8N_ENDPOINT_HEALTH, cuyo valor predeterminado es healthz. Compruébelo primero desde el host para confirmar que la ruta es correcta en su instancia.
curl -fsS http://127.0.0.1:5678/healthz
docker exec n8n which wget curl
sudo systemctl is-enabled dockerUn healthcheck por sí solo no reinicia nada. Compose marca el contenedor como no saludable y no realiza ninguna otra acción; una política de reinicio actúa cuando el contenedor termina, mientras que se necesita un monitor externo para reiniciar un contenedor específicamente porque no está saludable. Cómo escribir un healthcheck que realmente actúe y Cómo hacer que el stack vuelva a iniciarse tras un reinicio cubren ambas partes.
El flujo de trabajo que nunca se ejecuta aunque n8n funcione correctamente
Este caso no muestra ningún aviso ni provoca ningún reinicio. El contenedor está activo, el editor funciona y la ejecución esperada no aparece en la lista de ejecuciones. Compruebe estos cuatro puntos.
- El flujo de trabajo no está publicado. Guarde y publique un flujo de trabajo que use Schedule Trigger para que se ejecute según su programación de producción.
- La zona horaria no es la correcta. Schedule Trigger usa primero la zona horaria del flujo de trabajo y, si no se ha definido, la zona horaria de la instancia.
GENERIC_TIMEZONEusaAmerica/New_Yorkde forma predeterminada; defina la zona horaria del flujo de trabajo o cambie la zona horaria predeterminada de la instancia por la suya. - La ejecución superó su período de tolerancia. El planificador persistente está habilitado de forma predeterminada desde n8n 2.45.0 y registra en la base de datos las próximas ejecuciones. Las ejecuciones registradas se realizan con retraso después de un reinicio si este ocurre dentro de su período de tolerancia. Si se supera, la política de ejecuciones omitidas configurada determina si se omiten o si se crea una ejecución de recuperación. El planificador anterior, basado en memoria, omite las ejecuciones previstas durante el tiempo de inactividad.
- El flujo de trabajo se desactivó automáticamente.
N8N_WORKFLOW_AUTODEACTIVATION_ENABLEDestá desactivado de forma predeterminada. Cuando se activa, un flujo de trabajo que sigue fallando se despublica. Después, parece exactamente uno que nunca se activó.
Abra la lista de ejecuciones y filtre por ese flujo de trabajo. Una entrada con estado fallido indica un problema del flujo de trabajo. Si falló con un error 429 contra otro servicio alojado en el mismo servidor, el límite pertenece a ese servicio y no a n8n. La guía para diagnosticar errores 429 de SearXNG muestra cómo distinguir su propio limitador de tasa de los motores que bloquean la IP de su servidor. La ausencia total de entradas también se produce cuando el guardado de ejecuciones está desactivado o la limpieza automática ha eliminado el registro. Compruebe esos ajustes antes de considerarlo un problema del activador.
Qué cambiar primero
- Lea
STATUS,RestartCountyOOMKilleden su propio contenedor antes de editar cualquier archivo. - Si el contenedor siguió activo, compruebe la accesibilidad de n8n y que la base de datos esté lista. Después, revise la conexión push para detectar errores de proxy, autenticación, origen o tiempo de espera.
- Si
OOMKilledes verdadero, establezca deliberadamente un límite para el contenedor, deje margen por debajo de ese límite al definir el máximo del heap de Node y cambie los datos binarios afilesystem. - Si no se ejecutó nada, compruebe que el workflow esté publicado, que su zona horaria efectiva sea la suya y que la configuración del programador y de las ejecuciones perdidas coincida con lo esperado.
La mayor parte de esta configuración se establece una vez y después no requiere cambios, siempre que la instalación funcione. Si todavía está montando esa instalación, la guía para ejecutar n8n en Docker con HTTPS es la base a la que corresponden estos ajustes.
FAQ
¿Por qué el editor de n8n muestra un aviso de conexión perdida mientras el contenedor está en ejecución?
El editor mantiene abierto un WebSocket para transmitir el progreso de las ejecuciones. Si el proxy inverso no reenvía las cabeceras Connection: Upgrade y Upgrade: websocket, o no usa HTTP/1.1 con el backend, la actualización nunca se completa y el navegador intenta conectarse de nuevo indefinidamente mientras n8n sigue funcionando. En nginx necesita las dos líneas proxy_set_header y proxy_http_version 1.1 en versiones anteriores a 1.29.7; las versiones más recientes usan HTTP/1.1 de forma predeterminada. Aumentar proxy_read_timeout por encima de su valor predeterminado de 60 segundos deja margen para que lleguen los pings periódicos de n8n; los flujos de trabajo inactivos por sí solos no hacen que la conexión quede inactiva. n8n también rechaza las solicitudes push no válidas y los fallos de autenticación, por lo que debe revisar la respuesta y los registros de la aplicación. Compruebe los archivos de configuración con sudo nginx -T y confirme que la recarga se haya completado correctamente.
¿Cómo distingo una terminación por falta de memoria de un cierre inesperado normal?
Ejecute docker inspect n8n | grep -iE 'OOMKilled|ExitCode|RestartCount' y lea el indicador OOMKilled. El valor True significa que Docker registró una terminación por falta de memoria; el proceso afectado no puede escribir una entrada final en el registro, aunque los registros anteriores del contenedor todavía pueden ser útiles. El valor False, junto con un error de heap fatal al final de docker logs, indica que Node.js agotó el heap de V8. Configure NODE_OPTIONS=--max-old-space-size=SIZE con un tamaño numérico en MiB inferior al límite del contenedor y deje margen para otros usos de memoria. Esto limita el espacio antiguo de V8, pero no garantiza que se produzca un error de heap antes de una terminación OOM del kernel.
¿La depuración de los datos de ejecución libera espacio en disco de inmediato?
No. EXECUTIONS_DATA_PRUNE marca las ejecuciones antiguas para eliminarlas y una pasada posterior las elimina, según el calendario definido por EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL. Con SQLite, el archivo también reutiliza las páginas liberadas en lugar de devolverlas al sistema de archivos, por lo que el tamaño en disco permanece sin cambios durante un tiempo después de eliminar las filas. Configure EXECUTIONS_DATA_MAX_AGE y EXECUTIONS_DATA_PRUNE_MAX_COUNT con valores adecuados para su servidor y vuelva a comprobarlo al día siguiente, no inmediatamente.
¿Por qué no se ejecutó mi flujo de trabajo programado mientras n8n se reiniciaba?
El planificador persistente, habilitado de forma predeterminada desde n8n 2.45.0, guarda las próximas ejecuciones en la base de datos. Las ejecuciones registradas se inician con retraso cuando n8n vuelve a estar disponible dentro de su período de tolerancia. Después de ese período, la política de ejecuciones perdidas del disparador decide si omite las ejecuciones pendientes o realiza una ejecución de recuperación. Compruebe la versión, la configuración del planificador y las opciones de Schedule Trigger. Las instancias que usan el planificador en memoria antiguo omiten las ejecuciones previstas durante la interrupción.
¿Un healthcheck reiniciará n8n cuando deje de responder?
No por sí solo. Un healthcheck de Compose sólo marca el contenedor como healthy o unhealthy. Una política de reinicio actúa cuando el contenedor termina, por lo que restart: unless-stopped lo inicia de nuevo después de una terminación y después de reiniciar el host, siempre que no se haya detenido deliberadamente y Docker se inicie. Confírmelo con sudo systemctl is-enabled docker. Para actuar específicamente cuando el estado sea unhealthy, necesita un monitor externo a Docker que lea el estado y reinicie el servicio.