Cómo instalar N8N en Synology NAS con Docker

n8n es una herramienta de automatización de flujos de trabajo y creación de agentes de IA. En esta guía te enseño la instalación que uso en mi Synology DS1522+ con Container Manager, pero con una configuración más prudente que la de muchas guías: datos persistentes, versión fijada, acceso por VPN o HTTPS y sin ejecutar el contenedor como root.

La he revisado el 4 de octubre de 2026 contra la documentación oficial actual de n8n y Synology. Las capturas siguen siendo útiles para orientarte en DSM; si el nombre exacto de un botón cambia, conserva el criterio técnico que explico en cada paso.

¿Tienes problemas en algún paso? Explícamelo en los comentarios. Intentaré echarte una mano.

Si quieres conocer más formas de aumentar la productividad con tu NAS, no dejes de visitar este otro artículo.

Índice de contenidos

N8N es especialmente útil si eres SEO y quieres automatizar flujos de análisis y reporting con IA sin depender de servicios cloud de pago. Instalarlo en tu NAS local elimina el coste por ejecución y te da control total sobre tus datos.

Requisitos previos en el NAS

Modelo y sistema

Asegúrate de tener un Synology compatible con Docker. El mío es el DS1522+ (CPU AMD64), que soporta contenedores. Es recomendable que tengas DSM 7 o superior. Instala la aplicación Container Manager desde el Centro de Paquetes de Synology si aún no la has instalado.

Este es mi NAS y estoy encantado con él, pero haz tu propio research y busca el que mejor se adapte a tus circunstancias:

Synology DS1522+ NAS 5 EMP. 2.6/3.1GHz DualCore 8GB 4 LAN GbE USB3.2 eSATA 2emp M.2 NVMe

4,8 de 5 estrellas

Ver Oferta en Amazon

Privilegios

Necesitarás una cuenta con permisos para instalar y configurar Container Manager. Úsala solo durante el despliegue y vuelve después a tu cuenta habitual: n8n no necesita que mantengas una sesión administrativa abierta ni que el contenedor se ejecute como root o en modo privilegiado.

Almacenamiento

Crea o identifica un volumen de almacenamiento (por ejemplo, volume1) con suficiente espacio para los datos de n8n. Te recomiendo crear una carpeta dedicada, por ejemplo docker/n8n, donde se guardarán todos los datos persistentes de n8n.

Red y puertos

Verifica que el puerto interno 5678 esté libre, pero no lo abras ni lo redirijas desde Internet. Para acceder desde fuera de casa, mi primera opción es una VPN. Si necesitas webhooks públicos o acceso mediante dominio, publica únicamente HTTPS en el puerto 443 mediante el proxy inverso de DSM y un certificado válido (por ejemplo, Let’s Encrypt); el 5678 debe quedar limitado al NAS y a la red local de confianza.

Pasos detallados para instalar n8n en Docker (Container Manager)

1. Preparar Container Manager

Abre Container Manager en tu Synology. Si es la primera vez que lo usas, revisa la configuración predeterminada. Normalmente, la red en modo NAT/bridge por defecto es suficiente.

2. Descargar la imagen de n8n

En la pestaña Registro (Registry) de Container Manager, busca la imagen oficial de n8n (por ejemplo, escribe “n8n” o “n8nio/n8n”).
Selecciona la imagen oficial y pulsa Download.
Elige una versión estable explícita. A fecha de esta revisión, la estable es 2.41.6, así que descarga n8nio/n8n:2.41.6. No uses latest: fijar la etiqueta hace que una recreación o un rollback sea reproducible. Antes de instalar, comprueba en las releases oficiales de n8n que esta sigue siendo la versión estable que quieres desplegar.
Espera a que finalice la descarga.

3. Crear el contenedor

Ve a la pestaña Contenedor (Container) y haz clic en Crear.
Selecciona la imagen de n8n descargada.
Asígnale un nombre al contenedor (por ejemplo, “n8n”).

General

Marca la opción de reinicio automático para que n8n se inicie con el NAS (por ejemplo, “siempre” o “si falla”).

Configuración de CPU/RAM (opcional)

Puedes limitar los recursos si lo deseas, aunque para un rendimiento óptimo es mejor dejarlos por defecto.

Puertos

En Configuración de puertos/Port Settings, mapea el puerto interno 5678 a un puerto del host disponible. Limita su acceso con el firewall de DSM a la LAN o a tu red VPN. En el router no crees una redirección pública hacia ese puerto.

Nota: si usas el proxy inverso HTTPS, el destino será http://localhost:5678 y la única entrada pública será el 443. En DSM 7 encontrarás el proxy inverso en Panel de control → Portal de inicio de sesión → Avanzado → Proxy inverso. Asigna el certificado al hostname, activa WebSocket y sigue la configuración oficial de n8n para proxy inverso.

4. Configurar volúmenes (persistencia de datos)

Este paso es esencial para no perder tus flujos y configuraciones al actualizar. En la sección Volúmenes:

Añade un Mount Volume.
Selecciona la carpeta del NAS que creaste, por ejemplo volume1/docker/n8n.
Asigna el Mount path dentro del contenedor a /home/node/.n8n.

De esta forma, la base de datos SQLite de n8n, las credenciales cifradas y otros ajustes se guardarán de manera permanente en tu NAS.

Si la interfaz no te deja seleccionar /home/node/.n8n, escribe manualmente la ruta.

Si quieres separar distintos tipos de datos (por ejemplo, ficheros binarios o certificados), puedes crear subcarpetas en docker/n8n y montarlas en rutas como /files o similares.

Asegúrate de que el usuario no privilegiado del contenedor, node, tenga lectura y escritura únicamente sobre la carpeta dedicada que has montado. La imagen oficial de n8n termina su arranque como ese usuario, no como root.

Si aparece permission denied, revisa que el volumen esté marcado como lectura/escritura en Container Manager y que los permisos de File Station coincidan. Corrige solo la subcarpeta docker/n8n; no concedas permisos globales sobre la carpeta compartida, no uses chmod 777 y no cambies el contenedor a root o a modo privilegiado.

5. Variables de entorno

En Configuración de entorno/Environment, añade las siguientes variables para configurar n8n:

N8N_HOST: Dominio o subdominio que n8n usará para generar URLs (por ejemplo, n8n.tudominio.synology.me).
N8N_PORT: Puerto interno de n8n (normalmente 5678).
N8N_PROTOCOL: "http" para la conexión interna entre el proxy y el contenedor. El HTTPS público termina en el proxy inverso de DSM.
N8N_WEBHOOK_URL: URL pública HTTPS completa que usará n8n para registrar webhooks (por ejemplo, https://n8n.tudominio.synology.me/). Sustituye a WEBHOOK_URL, obsoleta desde n8n 2.35.0.
N8N_PROXY_HOPS: usa 1 cuando DSM sea el único proxy delante de n8n, para que confíe en una sola capa de cabeceras reenviadas.
GENERIC_TIMEZONE y TZ: Zona horaria (por ejemplo, "Europe/Madrid") para que tus flujos cron y registros coincidan con tu horario local.
NODE_ENV: Pon "production" para indicar que es un entorno de producción.

Variables de seguridad (recomendadas)

Autenticación: no añadas N8N_BASIC_AUTH_ACTIVE, N8N_BASIC_AUTH_USER ni N8N_BASIC_AUTH_PASSWORD. n8n retiró Basic Auth en la versión 1.0. El primer arranque muestra el alta de la cuenta propietaria; después, cada persona debe usar su propia cuenta.
N8N_ENCRYPTION_KEY: Clave de cifrado para credenciales. Si no la pones, n8n genera una al arrancar.
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS: Si la pones en "true", n8n aplica permisos estrictos al archivo de configuración.
N8N_SECURE_COOKIE: Pon "true" si accedes por HTTPS, para que las cookies de sesión sean seguras.
2FA: después del primer acceso, ve a Settings → Personal → Enable 2FA, escanea el QR con una app de autenticación y guarda los códigos de recuperación fuera del NAS. La guía oficial de 2FA detalla el flujo. Si administras varios usuarios en una versión que admita política global, puedes exigirla con N8N_SECURITY_POLICY_MANAGED_BY_ENV=true y N8N_MFA_ENFORCED_ENABLED=true.

(Opcional) Base de datos externa

Por defecto, n8n usa SQLite. Si necesitas un entorno más robusto (multiusuario o muchos flujos), considera desplegar PostgreSQL y configurar variables como DB_TYPE=postgresdb, DB_POSTGRESDB_HOST, DB_POSTGRESDB_DATABASE, etc. Si no, puedes seguir con SQLite.

(Opcional) Otros ajustes

n8n ofrece muchas más variables, como N8N_DIAGNOSTICS_ENABLED=false (para desactivar telemetría) o N8N_PERSONALIZATION_ENABLED=false (para desactivar sugerencias en la interfaz). Ajusta según tus preferencias.

6. Revisar y lanzar el contenedor

Comprueba en el resumen que los puertos, volúmenes y variables de entorno estén correctos. Haz clic en Aplicar/Guardar y enciende el contenedor.

7. Verificación inicial

Abre los registros (logs) del contenedor para confirmar que n8n arranca sin errores. Si todo va bien, verás que escucha en el puerto 5678.

8. Acceder a n8n

En red local: En tu navegador, pon http://IP_de_tu_NAS:5678 (o el puerto que configuraste).
Con dominio y HTTPS: si necesitas webhooks públicos, configura el Proxy Inverso en Panel de control → Portal de inicio de sesión → Avanzado para mapear tu dominio (por ejemplo, https://n8n.tudominio.synology.me) a http://localhost:5678. Habilita WebSocket y expón al router únicamente el 443.

9. Inicialización de n8n

Cuando entres por primera vez, n8n mostrará el alta de la cuenta propietaria. Crea una contraseña única y activa 2FA desde Settings → Personal. Los antiguos ajustes N8N_BASIC_AUTH_* ya no protegen versiones modernas de n8n y deben eliminarse del contenedor.

Configuración de volúmenes y persistencia de datos

Persistencia de flujos y datos

Como se explicó, es crucial montar la carpeta /home/node/.n8n en tu NAS para no perder los flujos y credenciales al actualizar. Verifica que, tras el primer arranque, se hayan creado archivos como database.sqlite (base de datos) y config (con la clave de cifrado) en la carpeta del NAS.

Permisos

Si aparecen errores de “permission denied” o no se guardan los datos, comprueba dos capas: que Container Manager monte la carpeta con lectura/escritura y que File Station permita esa escritura en la subcarpeta dedicada. Mantén el alcance en docker/n8n, no en toda la carpeta compartida. La imagen oficial ejecuta n8n como usuario node; no uses root, modo privilegiado ni permisos 777 como atajo.

Archivos binarios y certificados

Si tus flujos guardan archivos o quieres usar certificados TLS propios dentro de n8n, considera montar una carpeta extra en /files. Así cualquier archivo o certificado quedará en tu NAS.

Actualizaciones

Paso 1: Copia de Seguridad (¡CRUCIAL!)

Antes de tocar nada, anota la versión actual y asegura tus datos. Según la documentación oficial de backup y restauración, una copia completa incluye la carpeta persistente .n8n —base SQLite, configuración y clave de cifrado— y cualquier almacenamiento externo que uses. Si usas SQLite, detén el contenedor antes de copiar la carpeta para no obtener una base inconsistente.

Abre File Station en tu Synology.
Navega a la carpeta donde guardas los datos de n8n (ej. docker/n8n).
Con el contenedor detenido, copia la carpeta n8n a una ubicación de backup o inclúyela en una tarea versionada de Hyper Backup. También exporta la configuración del contenedor desde Container Manager.
- Por qué: Si la nueva versión de n8n intenta migrar la base de datos y falla, tendrás una copia exacta de antes de la actualización para restaurar.

Paso 2: Descargar la nueva imagen

Para actualizar, elige de antemano una versión estable concreta. Revisa las notas de versión y evita saltar varias versiones grandes de una vez; n8n recomienda actualizar con frecuencia y probar antes cuando sea posible.

Abre Container Manager.
Ve a la pestaña Registro (Registry).
Busca n8n.
Selecciona la misma imagen que usaste al instalar (generalmente n8nio/n8n o docker.io/n8nio/n8n).
Haz clic en Descargar (Download).
Cuando te pregunte la etiqueta, escribe la versión estable concreta que has revisado, por ejemplo 2.41.6 a fecha de esta guía. Conserva también el número de la versión anterior para el rollback.
- Nota: El sistema te avisará que la imagen ya existe. Confirma que quieres sobrescribirla. Espera a que termine la descarga (verás la notificación en el sistema).

Paso 3: Aplicar la actualización al contenedor

Aquí es donde muchos usuarios se confunden. No hace falta borrar el contenedor y crear uno nuevo desde cero. Usaremos la función «Restablecer» (Reset).

Ve a la pestaña Contenedor (Container).
Busca tu contenedor de n8n (que estará en estado «Running» o «Ejecutándose»).
Detén el contenedor: Selecciónalo y pulsa Detener (Stop).
Una vez detenido, haz clic derecho sobre el contenedor y selecciona Restablecer (Reset) (en versiones antiguas puede llamarse «Borrar» o «Limpiar», pero la opción correcta en Container Manager actual es Restablecer).
- ¿Qué hace esto? Recrea el contenedor a partir de la imagen seleccionada y debe conservar los datos porque están fuera del contenedor, en el volumen persistente. Antes de aceptar, verifica que siguen presentes los puertos, el volumen y variables como N8N_WEBHOOK_URL y N8N_PROXY_HOPS.
Una vez finalizado el restablecimiento, selecciona el contenedor y dale a Iniciar (Start).

Paso 4: Verificación y Limpieza

Espera un momento: n8n puede tardar un par de minutos en arrancar después de una actualización, ya que a menudo realiza migraciones de base de datos internas.
Comprueba los Logs: Haz clic en el contenedor > Detalles > Registros (Log). Busca mensajes que digan «Migrations executed successfully» o «n8n ready».
Accede a n8n: Entra en tu navegador. En la esquina inferior o en el menú de ayuda, deberías ver el número de la nueva versión.
Prueba antes de limpiar: abre un workflow, ejecuta uno no destructivo, comprueba credenciales, webhooks y logs. No borres la imagen anterior hasta terminar esta validación.
Rollback: si la nueva versión falla, detén el contenedor, restaura la copia coherente de .n8n y recrea el contenedor con la etiqueta exacta anterior. Volver solo a la imagen antigua después de que una versión nueva haya migrado la base de datos no es un rollback completo.
Limpieza de imágenes viejas (Opcional):
- Ve a la pestaña Imágenes. Si ves imágenes de n8n que dicen «None» o «<none>» en la etiqueta, son las versiones antiguas que han quedado huérfanas. Puedes borrarlas para liberar espacio en el NAS.

Posibles problemas y soluciones comunes

1. El contenedor se ejecuta pero pierdo mis workflows al reiniciar

Sucede si no has montado correctamente la carpeta de datos. Asegúrate de que la carpeta del NAS se mapee a /home/node/.n8n en el contenedor. Si no puedes usar esa ruta, define la variable N8N_USER_FOLDER a otra (por ejemplo, /data) y mapea allí el volumen.

2. No puedo mapear el volumen a `/home/node/.n8n`

La interfaz de Container Manager puede no mostrar rutas del sistema. Escribe manualmente la ruta en el campo de montaje o usa un archivo docker-compose para mayor control.

3. La interfaz de n8n no muestra el progreso de ejecución o fallan los webhooks

Generalmente es un problema de WebSocket, cabeceras reenviadas o URL. Revisa que DSM reenvíe X-Forwarded-For, X-Forwarded-Host y X-Forwarded-Proto, y que N8N_WEBHOOK_URL apunte a la URL HTTPS pública y N8N_PROXY_HOPS=1 cuando solo haya un proxy.

4. Obtengo la página por defecto de “Web Station” o error 400

Significa que tu petición está llegando al puerto web por defecto del NAS. Comprueba que el proxy inverso mapee tu dominio en el puerto 443 hacia http://localhost:5678. Asegúrate de haber asignado el certificado correcto en Seguridad > Certificado.

5. Errores de certificado o avisos de seguridad

Si no has configurado un certificado válido, el navegador mostrará alertas. Lo ideal es usar Let’s Encrypt o un certificado de confianza. Asegúrate de acceder siempre por HTTPS y, si tienes N8N_SECURE_COOKIE=true, necesitas un entorno cifrado.

6. El contenedor no inicia (se reinicia constantemente)

Verifica los logs en Container Manager. Las causas más frecuentes son variables mal configuradas (por ejemplo, un host de base de datos inexistente) o puertos en conflicto. Si 5678 está en uso, mapea otro puerto local y ajusta las variables en consecuencia.

7. Problemas de rendimiento o bloqueos

Si n8n va lento o consume muchos recursos, revisa si hay flujos en bucle o demasiadas ejecuciones simultáneas. Amplía la RAM si lo necesitas o cierra otros servicios. En casos de muchas escrituras, SQLite puede bloquearse; valora migrar a PostgreSQL.

8. No puedo acceder con las credenciales después de actualizar

Si tras actualizar n8n te pide crear una cuenta nueva, puede que no hayas montado la carpeta correctamente y hayas perdido la base de datos. Verifica que database.sqlite y ~/.n8n/config siguen en tu volumen. Por eso es fundamental montar el volumen desde el principio y hacer copias de seguridad.

Sigue leyendo sobre SEO e IA

antigravity vs cursor: joystick de mission control que simboliza dirigir un equipo de agentes de IA

Cómo instalar N8N en Synology NAS con Docker | Guía actualizada