découvrez notre guide pratique et complet pour déployer n8n avec docker sur un système linux. suivez les étapes simples et efficaces pour automatiser vos flux de travail et optimisez votre productivité en quelques minutes.

Guía práctica para implementar n8n con Docker en un sistema Linux

por

Más que nunca, la automatización de tareas se ha convertido en un factor esencial para aumentar la productividad, especialmente en entornos Linux, donde la gestión del flujo de trabajo puede volverse compleja rápidamente. n8n se presenta como la solución flexible de código abierto ideal para conectar API, orquestar webhooks y gestionar integraciones complejas sin tener que reinventar la rueda. Docker, por su parte, simplifica la implementación al aislar el entorno de ejecución, lo que garantiza un funcionamiento estable y portátil, independientemente del sistema Linux subyacente. Esta guía detallada proporciona una guía paso a paso para implementar n8n con Docker en un servidor Linux, ya sea una máquina dedicada o un entorno en la nube, aprovechando herramientas robustas como PostgreSQL para la base de datos y Nginx como proxy inverso seguro. Este tutorial está dirigido tanto a administradores de sistemas que buscan industrializar sus soluciones de automatización como a entusiastas de Linux que desean explorar el potencial de Node.js en entornos contenedorizados. Requisitos previos esenciales para instalar n8n con Docker en un sistema Linux.

Antes de comenzar la implementación, es fundamental preparar un entorno adecuado donde cada componente pueda funcionar a la perfección. El servidor Linux debe ser estable, generalmente Debian o Ubuntu, reconocido por su robustez y amplia compatibilidad con Docker y sus herramientas relacionadas. Es fundamental tener instalado Docker y Docker Compose, ya que orquestan el lanzamiento de los contenedores que alojarán n8n y sus dependencias.

Para proteger su instancia n8n, se recomienda un proxy inverso como Nginx o Traefik. Esto le permitirá agregar un certificado SSL/TLS, a menudo administrado gratuitamente mediante Let’s Encrypt. Este nivel de seguridad es esencial al exponer webhooks o API a internet, garantizando la confidencialidad e integridad de los intercambios. En producción, es preferible usar una base de datos PostgreSQL a la opción nativa SQLite, ya que garantiza una mejor escalabilidad y una gestión más eficiente de numerosas consultas. Aquí está la lista de prerrequisitos esenciales:

Servidor Linux actualizado

(Se recomienda Debian 11 o superior, Ubuntu 22.04 o superior)

  • Docker y Docker Compose instalados con versiones compatibles (Docker 20.10 o superior, Compose 2.x)
  • Proxy inverso instalado (Se recomienda Nginx o Traefik)
  • Nombre de dominio que apunte al servidor para facilitar el acceso y la configuración de SSL
  • PostgreSQL configurado a través de Docker para gestionar la base de datos n8n
  • Configuración de red adecuada : puertos 80, 443 (HTTP/S) y 5678 (n8n) abiertos y redirigidos si es necesario
  • Cualquier principiante en Linux se beneficiará de comprender qué representan estos elementos: Docker encapsula las aplicaciones en contenedores ligeros, aislados del sistema host, mientras que un proxy inverso como Nginx redirige y protege el acceso entrante a n8n. PostgreSQL es una potente base de datos relacional que se recomienda para una instancia de producción debido a su robustez y compatibilidad con el framework Node.js, en el que se basa n8n. Configuración del entorno Docker y personalización de n8n con Docker Compose en Linux

La magia de implementar n8n en Linux reside en la facilidad de uso de Docker Compose. Este archivo YAML describe todos los contenedores y sus interacciones en un formato legible y editable. La configuración inicial consiste en crear un árbol n8n dedicado y, a continuación, definir dos archivos esenciales:

.env

Para las variables de entorno y docker-compose.yml para orquestar los servicios. Un aspecto que a menudo se pasa por alto es la segregación de los datos persistentes. Se deben crear tres carpetas locales: una para los datos de PostgreSQL, otra para los archivos generados por n8n y una última para los archivos temporales o de intercambio. Estos directorios se montarán en los contenedores correspondientes, lo que evitará la pérdida de datos en caso de reinicio o actualización. Ejemplo de creación de directorios: mkdir -p /opt/docker-compose/n8n/{postgresql,n8n_data,n8n_files} chmod 777 /opt/docker-compose/n8n/n8n_data (necesario para evitar errores de permisos) El archivo

.env

contiene variables clave:

  • N8N_HOST
  • : nombre de host que la interfaz mostrará y usará para generar URL

N8N_WEBHOOK_URL : URL de acceso público para el correcto funcionamiento de los webhooks POSTGRES_DB

  • , POSTGRES_USER
  • , POSTGRES_PASSWORD
  • : información de conexión a la base de datos PostgreSQLN8N_GENERIC_TIMEZONE : zona horaria que afecta a la ejecución del flujo de trabajoEl archivo docker-compose.yml incluye dos servicios principales:
  • postgres : basado en la imagen oficial de PostgreSQL con configuración de variables de entorno, volúmenes de persistencia y estado Comprobaciones

n8n : Imagen oficial de Docker n8n, configuración de variables de entorno para conectar la aplicación a la base de datos, gestión de puertos, volumen para persistir datos y archivos, y dependencia de estado de PostgreSQL. Al configurar con estos dos archivos, se crea un entorno automatizado, reproducible y fácilmente modificable. Esta es la fortaleza combinada del software de código abierto, Docker y Linux. Este método también protege contra errores de dependencia o incompatibilidades entre versiones.

  • https://www.youtube.com/watch?v=NAzpMf50auI Inicio y gestión de contenedores Docker para n8n en un sistema Linux
  • Una vez que el entorno esté listo, debe asegurarse de que los permisos de las carpetas montadas sean correctos para evitar que el contenedor n8n tenga problemas al escribir sus archivos. En la mayoría de los casos, es necesario configurar chmod 777 en la carpeta que contiene los datos de n8n, aunque este enfoque es permisivo y requiere un conocimiento profundo de los riesgos asociados. Al iniciar los contenedores con el siguiente comando, podrá iniciar e implementar servicios en segundo plano:

sudo docker compose up -d Supervise el estado de los contenedores mediante:sudo docker compose ps

para ver la lista de contenedores activos y su estado

sudo docker compose logs -f

para ver los registros de salida en tiempo real, esencial en caso de problemas

El contenedor PostgreSQL debe estar en buen estado para que n8n pueda conectarse correctamente e iniciarse sin errores. Los registros mostrarán mensajes como:

  • «El editor ahora es accesible a través de: https://n8n.it-connect.local».

Este mensaje confirma que el servicio está operativo y listo para usarse a través del puerto 5678, accesible desde su navegador mediante el nombre de dominio configurado. El uso de un administrador de registros simplifica enormemente el diagnóstico al implementar soluciones complejas basadas en Node.js, bases de datos PostgreSQL y middleware.

  • Configure un proxy inverso Nginx para proteger y exponer n8n a través de HTTPS en Linux. Un proxy inverso es fundamental para proteger el acceso a n8n, especialmente si utiliza webhooks o expone su automatización a través de internet. Nginx es una opción óptima en Linux gracias a su ligereza, fiabilidad y facilidad de configuración. En lugar de exponer directamente el puerto 5678 de Docker, Nginx actúa como intermediario, lo que permite aplicar un certificado SSL/TLS y gestionar redirecciones esenciales y encabezados HTTP. Estos son los pasos clave:
  • Instale Nginx mediante el gestor de paquetes; por ejemplo, sudo apt install nginx en Debian/Ubuntu. Cree un directorio para almacenar el certificado SSL autofirmado o generado por Let’s Encrypt.

Genere un certificado con OpenSSL (o mediante Certbot para Let’s Encrypt):

sudo openssl req -x509 -nodes -days 365 -newkey rsa:4096 -keyout /etc/nginx/ssl/n8n.key -out /etc/nginx/ssl/n8n.crt

La configuración de Nginx debe incluir dos bloques de servidor:

Un bloque que escucha en el puerto 80, que realizará una redirección 301 a HTTPS.

Un bloque HTTPS con certificado, compatibilidad con los protocolos TLS 1.2 y 1.3, y configuración de proxy_pass en http://127.0.0.1:5678, donde se ejecuta n8n.

El archivo de configuración esencial se verá así (el nombre de dominio debe adaptarse):

  • Fragmento de configuración de Nginx: servidor { listen 80;
  • servidor_nombre n8n.ejemplo.com;
  • devolver 301 https://$servidor_nombre$solicitud_uri;

}

servidor {

  • listen 443 ssl http2;
  • servidor_nombre n8n.ejemplo.com; certificado_ssl /etc/nginx/ssl/n8n.crt; clave_certificado_ssl /etc/nginx/ssl/n8n.key;

protocolos_ssl TLSv1.2 TLSv1.3;

cifrados_servidor_preferidos desactivados;

<!– wp:code {"content":"
nserver {n    listen 80;n    server_name n8n.example.com;n    return 301 https://$server_name$request_uri;n}nnserver {n    listen 443 ssl http2;n    server_name n8n.example.com;nn    ssl_certificate /etc/nginx/ssl/n8n.crt;n    ssl_certificate_key /etc/nginx/ssl/n8n.key;n    ssl_protocols TLSv1.2 TLSv1.3;n    ssl_prefer_server_ciphers off;n    ssl_session_cache shared:SSL:10m;n    ssl_session_timeout 10m;nn    location / {n        proxy_pass http://127.0.0.1:5678;n        proxy_http_version 1.1;n        proxy_set_header Upgrade $http_upgrade;n        proxy_set_header Connection 'upgrade';n        proxy_set_header Host $host;n        proxy_set_header X-Real-IP $remote_addr;n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;n        proxy_set_header X-Forwarded-Proto $scheme;nn        proxy_buffering off;n        proxy_read_timeout 300s;n    }n}n
«} –>
caché_session_ssl compartido:SSL:10m; Tiempo de espera de sesión SSL: 10 m;
    alquiler / {
    contraseña de proxy http://127.0.0.1:5678;
    versión http de proxy 1.1;
encabezado_conjunto_proxy Actualización $actualización_http;

encabezado_conjunto_proxy Conexión 'actualización';
    encabezado_conjunto_proxy Host $host;
    encabezado_conjunto_proxy X-Real-IP $dirección_remota;

    encabezado_conjunto_proxy X-Reenviado-Para $add_proxy_x_reenviado_para;
    encabezado_conjunto_proxy X-Reenviado-Proto $esquema;
    desactivación_búfer_proxy;
    tiempo_de_espera_lectura_proxy 300 s; }
    }
    Activar este sitio mediante un enlace simbólico en /etc/nginx/sites-enabled/

    y luego recargar Nginx es esencial:
        sudo ln -s /etc/nginx/sites-available/n8n.example.com /etc/nginx/sites-enabled/
        sudo systemctl reload nginx
        Al acceder a https://n8n.example.com, verá la interfaz de administración de n8n, protegida por HTTPS. Puede aparecer una advertencia sobre el certificado SSL si este es autofirmado, pero esto se puede solucionar mediante una CA reconocida.
        
        Introducción a n8n: Gestión de flujos de trabajo, webhooks e integraciones de API en Linux
        Una vez instalado y accesible n8n, la configuración de flujos de trabajo permite aprovechar al máximo la automatización. n8n está basado en Node.js y ofrece soporte nativo para cientos de servicios a través de sus API, simplificando las complejas cadenas de automatización. Los conceptos clave incluyen:
        Flujos de trabajo
        : Secuencias de tareas automatizadas que pueden incluir scripts, llamadas a la API y diversos desencadenadores.

        Webhooks
        : Puntos de entrada HTTP para activar un flujo de trabajo externamente, cruciales para reaccionar ante eventos externos.
    Integraciones
: Conectores nativos para MySQL, PostgreSQL, Redis y muchos otros, que facilitan la interconexión de datos.

Ejemplo práctico: Sincronizar automáticamente los datos de CRM con una base de datos MySQL tras recibir un webhook activado por un formulario de cliente. Esta orquestación evita errores manuales, reduce el tiempo de procesamiento y libera recursos humanos. n8n también ofrece una interfaz gráfica intuitiva y plantillas listas para usar, accesibles a través de GitHub o el sitio web oficial, lo que agiliza el proceso incluso para principiantes. Se recomienda usar Redis como caché intermedia para mejorar la gestión de colas en grandes flujos de trabajo de producción. La sinergia entre Docker, Linux y n8n simplifica las implementaciones tradicionalmente complejas. Esta arquitectura modular facilita las actualizaciones y la depuración, y ofrece una escalabilidad controlada para soportar el crecimiento de las aplicaciones de automatización.