Tutoriel Linux

Praktische handleiding voor het implementeren van n8n met Docker op een Linux-systeem

DébutantPublié par Julien Macé le 8 min de lecture

Taakautomatisering is meer dan ooit een essentiële factor geworden voor het verhogen van de productiviteit, met name in Linux-omgevingen waar workflowbeheer snel complex kan worden. n8n presenteert zich als de ideale flexibele open-source oplossing voor het verbinden van API’s, het orkestreren van webhooks en het beheren van complexe integraties zonder het wiel opnieuw uit te vinden. Docker vereenvoudigt de implementatie door de runtime-omgeving te isoleren, wat een stabiele en draagbare werking garandeert, ongeacht het onderliggende Linux-systeem. Deze gedetailleerde handleiding biedt stapsgewijze instructies voor het implementeren van n8n met Docker op een Linux-server, of het nu een dedicated machine of een cloudomgeving is, met behulp van robuuste tools zoals PostgreSQL voor de database en Nginx als een veilige reverse proxy. Deze handleiding is bedoeld voor zowel systeembeheerders die hun automatiseringsoplossingen willen industrialiseren als Linux-enthousiasten die de mogelijkheden van Node.js in containeromgevingen willen verkennen.

Essentiële vereisten voor het installeren van n8n met Docker op een Linux-systeem

Voordat de implementatie begint, is het cruciaal om een ​​geschikte omgeving voor te bereiden waarin elk onderdeel probleemloos kan functioneren. De Linux-server moet stabiel zijn, bij voorkeur Debian of Ubuntu, die bekend staan ​​om hun robuustheid en brede compatibiliteit met Docker en de bijbehorende tools. Docker en Docker Compose moeten geïnstalleerd zijn, aangezien deze de lancering van de containers coördineren die n8n en de bijbehorende afhankelijkheden zullen hosten.

Om uw n8n-instantie te beveiligen, wordt een reverse proxy zoals Nginx of Traefik aanbevolen. Hiermee kunt u een SSL/TLS-certificaat toevoegen, dat vaak gratis wordt beheerd via Let’s Encrypt. Dit beveiligingsniveau is essentieel wanneer u webhooks of API’s aan het internet blootstelt, omdat het de vertrouwelijkheid en integriteit van de communicatie garandeert. In een productieomgeving heeft het gebruik van een PostgreSQL-database de voorkeur boven de native SQLite-optie, omdat dit zorgt voor een betere schaalbaarheid en een efficiëntere verwerking van talloze query’s.

Hieronder vindt u een lijst met essentiële voorwaarden:

  • Actuele Linux-server (Debian 11+, Ubuntu 22.04+ aanbevolen)
  • Docker en Docker Compose installeren met compatibele versies (Docker 20.10+, Compose 2.x)
  • Omgekeerde proxy geïnstalleerd (Nginx of Traefik aanbevolen)
  • Domeinnaam die naar de server verwijst om SSL-toegang en -configuratie te vergemakkelijken
  • PostgreSQL geconfigureerd Docker gebruiken voor het beheren van de n8n-database.
  • Geschikte netwerkconfiguratie Poorten 80, 443 (HTTP/S) en 5678 (n8n) zijn geopend en worden indien nodig doorgestuurd.

Iedere Linux-beginner heeft baat bij het begrijpen van de volgende elementen: Docker verpakt applicaties in lichtgewicht containers, geïsoleerd van het hostsysteem, terwijl een reverse proxy zoals Nginx inkomend verkeer naar n8n omleidt en beveiligt. PostgreSQL is een krachtige relationele database die de voorkeur verdient voor een productieomgeving, vanwege de robuustheid en compatibiliteit met het Node.js-framework waarop n8n is gebaseerd.

Configureer de Docker-omgeving en pas n8n aan met Docker Compose op Linux.

De kracht van het implementeren van n8n op Linux schuilt in het gebruiksgemak van Docker Compose. Dit YAML-bestand beschrijft alle containers en hun interacties in een leesbaar en bewerkbaar formaat. De initiële configuratie omvat het creëren van een directorystructuur speciaal voor n8n, en vervolgens het definiëren van twee essentiële bestanden: .env voor omgevingsvariabelen, en docker-compose.yml om de diensten te coördineren.

Een aspect dat vaak over het hoofd wordt gezien, is de scheiding van permanente gegevens. Er moeten drie lokale mappen worden aangemaakt: één voor PostgreSQL-gegevens, één voor bestanden die door n8n worden gegenereerd en een derde voor tijdelijke bestanden of swapbestanden. Deze mappen worden in hun respectievelijke containers gemount, waardoor gegevensverlies bij een herstart of update wordt voorkomen.

Voorbeeld van het aanmaken van mappen:

  • mkdir -p /opt/docker-compose/n8n/{postgresql,n8n_data,n8n_files}
  • chmod 777 /opt/docker-compose/n8n/n8n_data (noodzakelijk om permissiefouten te voorkomen)

Het bestand .env Bevat belangrijke variabelen:

  • N8N_HOST : hostnaam die de interface zal weergeven en gebruiken om URL’s te genereren
  • N8N_WEBHOOK_URL Een openbaar toegankelijke URL is vereist voor een correcte werking van de webhooks.
  • POSTGRES_DB, POSTGRES_USER, POSTGRES_WACHTWOORD Verbindingsinformatie voor de PostgreSQL-database
  • N8N_GENERIC_TIMEZONE : tijdzone, wat van invloed is op de uitvoering van workflows

DE docker-compose.yml omvat twee hoofddiensten:

  • postgres : gebaseerd op de officiële PostgreSQL-image met instellingen voor omgevingsvariabelen, volumes voor persistentie en gezondheidscontroles
  • n8n Officiële Docker-image n8n, configuratie van omgevingsvariabelen om de applicatie met de database te verbinden, poortbeheer, volume voor het persistent opslaan van data en bestanden, health dependency op PostgreSQL.

Door middel van deze twee bestanden configureert u een omgeving. geautomatiseerd, reproduceerbaar en gemakkelijk aanpasbaarDit is de gecombineerde kracht van open source software, Docker en Linux. Deze methode beschermt je bovendien tegen afhankelijkheidsfouten of versie-incompatibiliteit.

Docker-containers voor n8n starten en beheren op een Linux-systeem.

Zodra de omgeving gereed is, moet u ervoor zorgen dat de machtigingen voor de gekoppelde mappen correct zijn om te voorkomen dat de n8n-container problemen ondervindt bij het schrijven van bestanden. In de meeste gevallen is een `chmod 777`-instelling voor de map die de gegevens van n8n moet bevatten noodzakelijk, hoewel deze aanpak ruim is en een grondig begrip van de bijbehorende risico’s vereist.

Door de containers met het volgende commando te starten, kunt u de achtergrondservices initiëren en implementeren:

  • sudo docker compose up -d

Monitor de status van containers via:

  • sudo docker compose ps om de lijst met actieve containers en hun status te bekijken
  • sudo docker compose logs -f Om de uitvoerlogboeken in realtime te bekijken, wat essentieel is in geval van een probleem.

De PostgreSQL-container moet in een “gezonde” staat verkeren om n8n correct te laten verbinden en zonder fouten te laten starten. In de logbestanden worden berichten weergegeven zoals:

“Editor is nu toegankelijk via: https://n8n.it-connect.local”

Dit bericht bevestigt dat de service operationeel en gebruiksklaar is via poort 5678, toegankelijk vanuit uw browser via de geconfigureerde domeinnaam. Het gebruik van een logmanager vereenvoudigt het oplossen van problemen aanzienlijk bij het implementeren van complexe oplossingen gebaseerd op Node.js, PostgreSQL-databases en middleware.

Configureer een Nginx reverse proxy om n8n via HTTPS te beveiligen en beschikbaar te maken op Linux.

Een reverse proxy is een essentieel onderdeel voor het beveiligen van de toegang tot n8n, vooral als je webhooks gebruikt of je automatiseringsprocessen aan het internet blootstelt. Nginx is een optimale keuze op Linux vanwege zijn lichte karakter, betrouwbaarheid en eenvoudige configuratie. In plaats van Docker-poort 5678 direct beschikbaar te stellen, fungeert Nginx als tussenpersoon, waardoor je een SSL/TLS-certificaat kunt toepassen en essentiële HTTP-redirects en headers kunt beheren.

Dit zijn de belangrijkste stappen:

  • Installeer Nginx bijvoorbeeld via de pakketbeheerder. sudo apt install nginx op Debian/Ubuntu.
  • Maak een map aan om het zelfondertekende of door Let’s Encrypt gegenereerde SSL-certificaat op te slaan.
  • Genereer een certificaat met OpenSSL (of via Certbot voor 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

De Nginx-configuratie moet twee serverblokken bevatten:

  • Een blok dat luistert op poort 80 en een 301-omleiding naar HTTPS uitvoert.
  • Een HTTPS-blok met certificaat, ondersteuning voor TLS 1.2- en 1.3-protocollen en proxy_pass-configuratie. http://127.0.0.1:5678 waarbij n8n roteert.

Het essentiële configuratiebestand ziet er als volgt uit (domeinnaam moet worden aangepast):

Uittreksel uit de Nginx-configuratie:

server {
    luister 80;
    server_name n8n.example.com;
    retourneer 301 https://$server_name$request_uri;
}

server {
    luister 443 ssl http2;
    server_name n8n.example.com;

    ssl_certificate /etc/nginx/ssl/n8n.crt;
    ssl_certificate_key /etc/nginx/ssl/n8n.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    ssl_session_cache gedeeld:SSL:10m;
    ssl_session_timeout 10m;

    verhuur / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_versie 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Verbinding '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_buffering uitgeschakeld;
        proxy_read_timeout 300s;
    }
}

Deze site activeren via een symbolische link in /etc/nginx/sites-enabled/ Het herladen van Nginx is dan essentieel:

  • sudo ln -s /etc/nginx/sites-available/n8n.example.com /etc/nginx/sites-enabled/
  • sudo systemctl reload nginx

Via https://n8n.example.com krijgt u toegang tot de n8n-beheerinterface, die beveiligd is met HTTPS. Er kan een waarschuwing over het SSL-certificaat verschijnen als het certificaat zelfondertekend is, maar dit kan worden opgelost via een erkende certificeringsinstantie (CA).

Aan de slag met n8n: workflows, webhooks en API-integraties beheren onder Linux

Zodra n8n is geïnstalleerd en toegankelijk is, kunt u via de workflowconfiguratie de automatisering volledig benutten. n8n is gebouwd op Node.js en biedt native ondersteuning voor honderden services via hun API’s, waardoor complexe automatiseringsketens worden vereenvoudigd. Belangrijke concepten zijn onder andere:

  • Werkstromen : geautomatiseerde taakreeksen die scripts, API-aanroepen en diverse triggers kunnen bevatten.
  • Webhaken HTTP-ingangspunten die het mogelijk maken een workflow van buitenaf te activeren, cruciaal voor het reageren op externe gebeurtenissen.
  • Integraties : native connectors voor MySQL, PostgreSQL, Redis en vele andere, die de gegevensuitwisseling vergemakkelijken.

Praktisch voorbeeld: Het automatisch synchroniseren van CRM-gegevens met een MySQL-database na ontvangst van een webhook die is geactiveerd door een klantformulier. Deze orkestratie voorkomt handmatige fouten, verkort de verwerkingstijd en ontlast medewerkers.

n8n biedt ook een intuïtieve grafische interface en kant-en-klare sjablonen, toegankelijk via GitHub of de officiële website, waardoor het installatieproces zelfs voor beginners wordt versneld. Het gebruik van Redis als tussenliggende cache wordt aanbevolen om het wachtrijbeheer in grote productieworkflows te verbeteren.

De synergie tussen Docker, Linux en n8n vereenvoudigt traditioneel complexe implementaties. Deze modulaire architectuur maakt updates en debuggen gemakkelijk en biedt gecontroleerde schaalbaarheid ter ondersteuning van de groei van het gebruik van automatisering.