n8n con Docker: instalación y automatización en servidor

Qué aporta n8n a un servidor propio

Administrar un servidor doméstico o un homelab suele implicar muchas tareas pequeñas: consultar servicios, recibir avisos, procesar datos de una API, ejecutar acciones programadas, transformar información, llamar a modelos de inteligencia artificial, registrar resultados o conectar aplicaciones que no fueron diseñadas para trabajar juntas. Es posible resolver cada necesidad con scripts independientes, cron y pequeños servicios, pero a medida que crece la infraestructura resulta más difícil seguir las dependencias y comprobar visualmente qué ocurre en cada automatización.

n8n es una plataforma de automatización de flujos de trabajo basada en nodos. Un flujo puede comenzar, por ejemplo, con una programación horaria o con la recepción de un webhook, consultar después una API HTTP, evaluar una condición, transformar el JSON recibido y terminar enviando información a otro servicio. Su editor visual no elimina la necesidad de comprender HTTP, JSON, autenticación o bases de datos, pero permite representar esas operaciones mediante un flujo que resulta mucho más sencillo de inspeccionar y modificar.

Para un servidor que ya utiliza Docker, el despliegue mediante Docker Compose ofrece una separación clara entre la aplicación y sus datos. Esta guía propone una arquitectura de una sola instancia de n8n acompañada de PostgreSQL. La base de datos conserva la información persistente de la aplicación mientras el directorio de datos de n8n se mantiene también en un volumen persistente. El puerto de la aplicación se publica únicamente sobre la interfaz local del servidor, de modo que no sea necesario exponerlo directamente a toda la red.

La publicación HTTPS se deja en manos de la capa de acceso o proxy inverso que ya utilice el servidor. Esta separación es especialmente importante con n8n porque los webhooks necesitan conocer su URL pública real. Cuando existe un proxy delante de la aplicación deben configurarse de forma coherente la URL del editor, la URL utilizada para generar webhooks y el número de proxies de confianza. Copiar una configuración genérica de Internet sin adaptar estos valores es una causa habitual de URLs incorrectas y problemas con callbacks externos.

El procedimiento cubre la creación del directorio del proyecto, generación de contraseñas y de una clave de cifrado, archivo de variables de entorno, definición de Docker Compose, arranque, comprobaciones y estrategia de actualización. También se explica qué debe incluir una copia de seguridad: no basta con guardar el archivo Compose. La base PostgreSQL, los datos persistentes de n8n, el archivo de configuración y, especialmente, la clave de cifrado forman parte de la recuperación real del servicio.

Finalmente se plantean casos de uso adaptables a un homelab: vigilancia de servicios, recepción de eventos mediante webhooks, consulta de APIs, automatizaciones periódicas, integración con servicios de inteligencia artificial y generación de avisos. Los ejemplos se presentan como diseños de flujo y no presuponen credenciales ni endpoints privados concretos. Antes de activar cualquier automatización que modifique datos, reinicie servicios o llame a sistemas externos conviene probarla con entradas controladas, limitar sus permisos y revisar qué información queda registrada en las ejecuciones de n8n.

Guía completa: Leer la guía técnica completa en Jesanre Stack