Hoe n8n opzetten: Een praktische handleiding

TL;DR

• Zelf-host n8n in 2 minuten met Docker: docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n
• Bouw uw eerste workflow in 5 minuten: HTTP Request → OpenAI → Slack
• Gebruik AI-nodes (OpenAI/Anthropic) om taken te automatiseren, zoals het samenvatten van supporttickets
• Plan workflows met cron-triggers (bijv. 0 9 * * * voor dagelijkse uitvoering om 9:00 uur)
• Beveilig credentials met omgevingsvariabelen (.env-bestand)

1. Zelf-hosting met Docker

1.1 Docker installeren

Als u Docker nog niet heeft geïnstalleerd, voer dan het volgende uit:

# Linux/macOS
curl -fsSL https://get.docker.com | sh

# Windows (PowerShell)
winget install Docker.DockerDesktop

1.2 n8n uitvoeren

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Verwachte uitvoer:

n8n ready on 0.0.0.0, port 5678
Version: 1.40.0
Editor is nu toegankelijk via: http://localhost:5678

Valkuilen:

• Poortconflict? Wijzig -p 5678:5678 in -p 5679:5678 als poort 5678 in gebruik is.
• Machtigingsfouten? Voeg -e N8N_USER=node toe om als niet-rootgebruiker uit te voeren.

1.3 Gegevens persistent maken

Voeg een volume toe om workflows en credentials op te slaan:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

2. Uw eerste workflow

2.1 De editor openen

Open http://localhost:5678 in uw browser. U ziet de visuele workflow-editor.

2.2 Een "Hello World"-workflow maken

1. Klik op + Nieuwe workflow.
2. Sleep een HTTP Request-node vanuit het linkerpaneel.
3. Configureer deze:
   • Methode: GET
   • URL: https://api.github.com/users/n8n-io
4. Klik op Execute Node om te testen. U ziet de API-reactie van GitHub.

Verwachte uitvoer (ingekort):

{
  "login": "n8n-io",
  "id": 45487711,
  "node_id": "MDEyOk9yZ2FuaXphdGlvbjQ1NDg3NzEx",
  ...
}

3. AI Agent Nodes (OpenAI/Anthropic)

3.1 Een OpenAI-node toevoegen

1. Sleep een OpenAI-node in uw workflow.
2. Klik op Connect Account en voer uw OpenAI API-sleutel in (verkrijgbaar hier).
3. Configureer de node:
   • Resource: Chat
   • Operation: Create Chat Completion
   • Model: gpt-4o-mini
   • Prompt: Vat deze GitHub-gebruikersgegevens samen: {{ $json }}

3.2 Nodes verbinden

1. Verbind de uitvoer van de HTTP Request-node met de invoer van de OpenAI-node.
2. Voer de workflow uit. De OpenAI-node vat de GitHub-gegevens samen.

Voorbeelduitvoer:

De GitHub-gebruiker "n8n-io" is een organisatieaccount met ID 45487711. Het is aangemaakt om het n8n-project te hosten, een open-source workflowautomatiseringstool.

Valkuilen:

• API-limieten? Gebruik gpt-4o-mini om kosten te besparen.
• Rate limits? Voeg een Wait-node toe (bijv. vertraging van 1 seconde) tussen verzoeken.

4. HTTP Request- en Webhook-nodes

4.1 HTTP Request-node

Gebruik deze om elke API aan te roepen. Voorbeeld: Weergegevens ophalen van OpenWeatherMap.

1. Voeg een HTTP Request-node toe.
2. Configureer:
   • Methode: GET
   • URL: https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_API_KEY
   • Query Parameters:

     {
       "q": "London",
       "appid": "YOUR_API_KEY"
     }
     

     Copy

4.2 Webhook-node

Start workflows via HTTP. Voorbeeld: Slack slash-command.

1. Voeg een Webhook-node toe.
2. Configureer:
   • Path: slack-command
   • HTTP Method: POST
3. Klik op Webhook URLs om de URL te kopiëren (bijv. http://localhost:5678/webhook/slack-command).
4. Voeg een Slack-node toe om een antwoord te verzenden.

Test de webhook:

curl -X POST http://localhost:5678/webhook/slack-command \
  -H "Content-Type: application/json" \
  -d '{"text": "Hallo vanuit Slack!"}'

5. Planning en Cron-triggers

5.1 Een Cron-trigger toevoegen

1. Sleep een Cron-node in uw workflow.
2. Configureer:
   • Trigger On: Every Minute (of gebruik cron-syntaxis, bijv. 0 9 * * * voor dagelijkse uitvoering om 9:00 uur).
3. Verbind deze met een HTTP Request-node om dagelijks gegevens op te halen.

Voorbeeld cron-expressies:

5.2 Handmatige triggers

Gebruik de Manual Trigger-node om workflows op aanvraag uit te voeren.

6. Omgevingsvariabelen en credentials

6.1 Gebruik een .env-bestand

Maak een .env-bestand aan:

echo "N8N_BASIC_AUTH_USER=admin" >> .env
echo "N8N_BASIC_AUTH_PASSWORD=securepassword" >> .env
echo "OPENAI_API_KEY=sk-your-key" >> .env

Start n8n opnieuw op met het .env-bestand:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  --env-file .env \
  n8nio/n8n

6.2 Credentials beveiligen

1. Ga in de n8n-editor naar Credentials → Add Credential.
2. Selecteer OpenAI en voer uw API-sleutel in.
3. Gebruik de credential in elke OpenAI-node (u hoeft geen sleutels hard te coderen).

Valkuilen:

• Voeg .env nooit toe aan Git! Voeg het toe aan .gitignore.
• Roteer sleutels regelmatig (bijv. elke 90 dagen).

7. Productietips en back-ups

7.1 Gebruik PostgreSQL (geen SQLite)

Vervang SQLite voor productie door PostgreSQL:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_DATABASE=n8n \
  -e DB_POSTGRESDB_HOST=postgres \
  -e DB_POSTGRESDB_PORT=5432 \
  -e DB_POSTGRESDB_USER=n8n \
  -e DB_POSTGRESDB_PASSWORD=securepassword \
  n8nio/n8n

7.2 HTTPS inschakelen

Gebruik een reverse proxy zoals Nginx of Caddy:

# Caddy-voorbeeld
echo "localhost:5678 {
  reverse_proxy n8n:5678
}" > Caddyfile
docker run -d --name caddy -p 80:80 -p 443:443 -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile caddy

7.3 Workflows back-uppen

Exporteer workflows via de API:

curl http://localhost:5678/rest/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o workflows_backup.json

Workflows herstellen:

curl -X POST http://localhost:5678/rest/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @workflows_backup.json

7.4 Workflows monitoren

• Gebruik de Execution List in de n8n-UI om mislukte workflows te debuggen.
• Schakel Error Workflows in om Slack-meldingen te verzenden bij fouten.

Alternatieven voor n8n

Wat nu?

1. Bouw een echte workflow: Automatiseer een taak zoals het samenvatten van Slack-berichten met OpenAI.
2. Implementeer in productie: Gebruik Kubernetes of n8n.cloud voor schaalbaarheid.
3. Ontdek AI-functies: Probeer de AI-workflowgenerator van n8n (bèta).

Hulp nodig bij het opschalen van AI-workflows? Hyperion Consulting is gespecialiseerd in AI-tools en automatisering voor bedrijven. Bezoek hyperion-consulting.io voor meer informatie.