So hosten Sie n8n selbst und führen den CometAPI-Node lokal aus

Die KI bewegt sich schnell: Neue multimodale Modelle und verbesserte Echtzeit-APIs erleichtern es, leistungsfähige KI in Automatisierungsplattformen einzubetten, während parallele Debatten über Sicherheit und Observability die Art und Weise verändern, wie Teams Produktionssysteme betreiben. Für Menschen, die lokale Automatisierungen bauen, zeichnet sich ein praktisches Muster ab: Verwenden Sie ein einheitliches Modell-Gateway (wie CometAPI), um auf viele Modelle zuzugreifen, und verketten Sie diese Modellaufrufe mit einem selbstgehosteten Automatisierungs-Runner (wie n8n), damit Sie die Kontrolle über Daten, Latenz und Kosten behalten. Diese Anleitung zeigt Ihnen Schritt für Schritt, wie Sie mit CometAPI + n8n (lokal) starten, worauf Sie achten sollten und wie Sie Fehler beheben, wenn etwas schiefgeht.

Was ist n8n und warum ist es für KI-Automatisierung wichtig?

n8n ist ein Open-Source-Tool für Workflow-Automatisierung mit einem visuellen Editor und einem großen Ökosystem von Nodes (Konnektoren). Es wurde dafür entwickelt, Trigger, Transformationen und externe API-Aufrufe zu wiederholbaren Workflows zu verketten (Webhooks, geplante Jobs, Dateiverarbeitung, Chatbots usw.). Das lokale Self-Hosting von n8n gibt Ihnen die vollständige Kontrolle über Datenresidenz und Ausführung, was besonders wertvoll ist, wenn Sie Drittanbieter-KI-Modelle aufrufen, die sensible Eingaben verarbeiten.

Wie funktioniert n8n in der Praxis?

Visuelle Arbeitsfläche mit Triggern (Webhook, Cron) und Aktions-Nodes (HTTP Request, Datenbank-Nodes, E-Mail).
Community-Nodes erweitern die Fähigkeiten — Sie können Community-Pakete installieren und wie native Nodes verwenden.

Self-Hosting von n8n bietet Ihnen:

Volle Datenkontrolle — Workflows und Laufdaten verbleiben auf der von Ihnen verwalteten Infrastruktur.
Anpassung — fügen Sie private Nodes oder lokale Integrationen hinzu, ohne auf Cloud-Features zu warten.
Kalkulierbare Kosten — keine überraschenden Cloud-Abrechnungen pro Aufgabe bei intensiver interner Automatisierung.
Sicherheit & Compliance — leichter, interne Richtlinien und regulatorische Anforderungen zu erfüllen.

Was ist CometAPI und warum als Modell-Gateway verwenden?

CometAPI ist ein einheitliches API-Gateway, das Hunderte von KI-Modellen von Drittanbietern (Text, Embeddings, Bildgenerierung usw.) hinter einer einzigen, OpenAI-kompatiblen Schnittstelle und einem Abrechnungsmodell bereitstellt. Das bedeutet: Anstatt für jedes LLM oder jede Bild-Engine, die Sie ausprobieren möchten, eine eigene Integration hinzuzufügen, rufen Sie eine API auf und wählen das gewünschte Modell in der Anfrage. Das vereinfacht Experimentieren, Kostenkontrolle und die betriebliche Integration.

Vorteile:

Modellwahl: Viele Anbieter/Modelle über denselben Codepfad testen.
Token-Pooling / Freikontingente: Viele Gateways bieten Credits/Tiers zum Ausprobieren.
Einfachere Infrastruktur: Ein Authentifizierungssystem und eine Basis-URL zur Verwaltung.

Wie erhalte ich CometAPI-Zugang und -Schlüssel?

Registrieren Sie sich auf der CometAPI-Seite (oder im Vendor-Dashboard). Die meisten Gateways haben eine kostenlose Teststufe.
API-Schlüssel abrufen aus Ihrem CometAPI-Dashboard — ein langer geheimer String. Beachten Sie, wo die Doku vorgibt, ihn zu platzieren (CometAPI verwendet Bearer-Authentifizierung gegen https://api.cometapi.com/v1).
Lesen Sie die API-Dokumentation für den Endpunkt, den Sie verwenden möchten (Chat Completions, Images, Embeddings). CometAPI dokumentiert Endpunkte wie /v1/chat/completions und /v1/images/generations.

So hosten Sie n8n selbst und führen den CometAPI-Node lokal aus

Warum ist das Bonding (Integration) zwischen n8n und CometAPI wichtig?

„Bonding“ bedeutet hier einen zuverlässigen, sicheren Integrationspfad zwischen Ihrem Automatisierungs-Runner (n8n) und Ihrem Modell-Gateway. Ordentliches Bonding ist wichtig, weil:

Es Kontext über Aufrufe hinweg bewahrt (Verlauf von Konversationen, Embeddings).
Es Zugangsdaten und Secrets zentralisiert und damit sicherer drehbar macht.
Es Latenz und Fehlerrisiko reduziert, indem vorhersehbare Endpunkte und standardisierte Request-Formate genutzt werden.
Es Observability und Troubleshooting ermöglicht — man weiß, welches Modell, welcher Prompt und welche Antwort zu einem Ergebnis geführt haben.

Kurz: Gutes Bonding senkt das Betriebsrisiko und beschleunigt Iteration.

Wie setze ich n8n lokal auf (schnelle Praxiseinführung)?

Sie können n8n lokal entweder mit npm oder mit Docker ausführen; Docker Compose ist für die meisten selbstgehosteten Szenarien der empfohlene Ansatz (reproduzierbar und isoliert Abhängigkeiten). Unten finden Sie ein minimales Docker-Compose-Beispiel und wesentliche Hinweise.

Wie hoste ich n8n selbst mit Docker?

Docker (und Docker Compose) ist der robusteste, reproduzierbarste Weg, n8n produktiv zu betreiben. Es isoliert die App, vereinfacht Upgrades und passt gut zu Reverse Proxies und Orchestratoren (Docker Swarm, Kubernetes). Die offiziellen n8n-Dokumente enthalten eine Docker-Compose-Referenz, der ich hier folge und die ich anpasse.

Für die Produktion betreiben Sie typischerweise einen Stack aus:

n8n-Service (offizielles Image: docker.n8n.io/n8nio/n8n oder n8nio/n8n je nach Tag).
PostgreSQL (oder eine andere unterstützte DB).
Redis (wenn Sie Queue-Mode verwenden möchten).
Einen Reverse Proxy (Traefik, Caddy oder nginx) für TLS, Host-Routing und Rate-Limit-Regeln.

Diese Architektur trennt Verantwortlichkeiten (DB-Persistenz, Queueing, Web-Proxy) sauber und macht Skalierung und Backups unkompliziert. Die offiziellen n8n-Dokumente bieten Docker-Compose-Muster und Referenzen zu Umgebungsvariablen.

Dies ist die Schritt-für-Schritt-Anleitung:

Erstellen Sie einen Ordner und eine docker-compose.yml mit dem kanonischen n8n-Service. Unten ein praktisches Docker-Compose-Beispiel, das typische Produktionsanforderungen abdeckt: externe Postgres-DB, Redis (für Queue/Executions-Mode), persistente Volumes und ein Nginx-Reverse-Proxy für TLS:

```yaml
version: "3.8"
services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=supersecretpassword
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=anothersecret
      - WEBHOOK_TUNNEL_URL=https://n8n.example.com
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: supersecretpassword
    volumes:
      - pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7
    volumes:
      - redisdata:/data

volumes:
  n8n_data:
  pgdata:
  redisdata:
```

Start:

docker compose up -d

Besuchen Sie http://localhost:5678 und erstellen Sie Ihren Admin-Benutzer. Für die Produktion benötigen Sie Postgres, SSL und passende Umgebungsvariablen — siehe die offizielle Docker-Compose-Dokumentation.

Hinweise & Härtung:

Speichern Sie keine Secrets im Klartext in docker-compose.yml; verwenden Sie in der Produktion Umgebungsdateien, Docker-Secrets oder externe Secret-Manager.
Ersetzen Sie WEBHOOK_URL durch Ihre echte öffentliche URL und konfigurieren Sie den Reverse Proxy so, dass n8n.example.com auf den n8n-Container geroutet wird.
Verwenden Sie EXECUTIONS_MODE=queue für robuste Hintergrundverarbeitung; dafür sind Queue-Worker und Redis erforderlich.

Wie hoste ich n8n selbst mit npm / Node.js?

Die Installation über npm (oder pnpm) führt n8n direkt auf dem Host aus. Das ist leichter (keine Container-Schicht) und kann für Single-User-, wenig komplexe Installationen oder Entwicklerrechner hilfreich sein. Allerdings trägt der Admin mehr Verantwortung für Abhängigkeitsmanagement, Isolation und Dienstüberwachung. Die offiziellen n8n-Dokumente enthalten eine npm-Installationsanleitung und Hinweise.

Erforderliche OS-Pakete und Node-Version:

Verwenden Sie eine stabile LTS-Version von Node.js (Node 18 oder Node 20+, passend zur n8n-Version).
Installieren Sie build-essential, git und einen Prozessmanager (systemd wird empfohlen).
Verwenden Sie für die Produktion weiterhin PostgreSQL und Redis als externe Dienste (aus denselben Gründen wie bei Docker).

Wie installiere und starte ich n8n via npm (Schritt für Schritt)?

1.Installieren Sie Node.js (empfohlen: nvm)

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reload your shell (adjust to your shell startup file if needed)
source ~/.bashrc  # or ~/.zshrc

# Install and use the latest LTS (usually 18 or 20)
nvm install --lts
nvm use --lts

# Verify
node -v
npm -v

Wenn später “n8n: command not found” angezeigt wird, starten Sie das Terminal neu oder stellen Sie sicher, dass der von nvm verwaltete globale npm-Bin-Pfad in Ihrem PATH enthalten ist.

2. n8n installieren und starten (lokal)

npm install -g n8n
n8n -v  # verify version

3. Im Vordergrund starten:

n8n start

Standard-URL: http://localhost:5678/ Falls der Port belegt ist:

export N8N_PORT=5679
n8n start

Optional: im Hintergrund weiterlaufen lassen (weiterhin lokal):

npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status

4 .Erster Zugriff und Anmeldung:

Öffnen Sie http://localhost:5678/ in Ihrem Browser.
Folgen Sie beim ersten Start dem Assistenten, um das Owner-Konto (E-Mail + Passwort) zu erstellen, und melden Sie sich an.

Wie installiere oder konfiguriere ich einen CometAPI-Community-Node in n8n?

n8n unterstützt sowohl verifizierte Community-Nodes (GUI-Installation) als auch manuelle Installation via npm beim Self-Hosting. Es gibt zwei Wege, CometAPI in n8n zu integrieren:

Option A — Den CometAPI-Community-Node verwenden (falls im Nodes-Panel verfügbar)

Öffnen Sie in n8n das Nodes-Panel (drücken Sie + oder Tab).
CometAPI ist ein verifizierter Community-Node, er erscheint unter „Mehr aus der Community“. Klicken und installieren.
Starten Sie n8n nach der Installation neu, falls Sie dazu aufgefordert werden. Erstellen Sie unter Einstellungen → Credentials eine neue Zugangsdaten-Konfiguration (wählen Sie den CometAPI-Credential-Typ, falls vom Node bereitgestellt) und fügen Sie Ihren CometAPI-Token ein.

Option B — Manuelle Installation (wenn GUI-Installation nicht verfügbar)

1.SSH in Ihren n8n-Host/Container.

2. Installieren Sie das Paket im globalen n8n-node_modules oder in Ihrem benutzerdefinierten Ordner :

Gehen Sie zu Settings (unten links) > Community nodesKlicken Sie auf „
Install a community node”
Geben Sie in „npm Package Name” ein: @cometapi-dev/n8n-nodes-cometapiMarkieren Sie das Kontrollkästchen zur RisikoanerkennungKlicken Sie auf „
Install”Nach der Installation können Sie im Node-Panel nach „CometAPI“ suchen.

3.Starten Sie n8n neu. Wenn Ihre Instanz im Queue-Mode läuft, müssen Sie dem in der Doku beschriebenen manuellen Installationsweg folgen.

Wie prüfen, ob der Node installiert ist

Nach dem Neustart öffnen Sie das Nodes-Panel und suchen Sie nach „CometAPI“ oder „Comet“. Der Node ist als Community-Paket gekennzeichnet.
Wenn Sie den Node nicht sehen: Vergewissern Sie sich, dass Sie das Owner-Konto der Instanz verwenden (nur Owner können installieren), oder dass das Node-Paket ohne Fehler in den Container-/Image-Logs installiert wurde.

Wie erstelle ich einen Workflow und konfiguriere die API?

1. Neuen Workflow erstellen

Melden Sie sich bei Ihrer (selbstgehosteten) n8n-Instanz an.
Klicken Sie auf "Add Workflow", um eine neue Automatisierungs-Canvas zu starten.

2.Node hinzufügen

Fügen Sie einen Trigger-Node hinzu: Suchen Sie nach „Manual Trigger“ oder „When clicking ‘Execute workflow’“.
Klicken Sie auf das „+“ auf der rechten Seite der Arbeitsfläche und suchen Sie nach „CometAPI“, um den Node hinzuzufügen.
Sie können auch links in der Node-Liste nach „CometAPI“ suchen und ihn auf die Arbeitsfläche ziehen.

3.Zugangsdaten konfigurieren (nur beim ersten Mal):

Wählen Sie im CometAPI-Node unter „Credential to connect with“ die Option „Create new“.
Fügen Sie den Token, den Sie in der CometAPI-Konsole erstellt haben, in „CometAPI Key“ ein.
Speichern. Die Base-URL ist standardmäßig https://api.cometapi.com und muss in der Regel nicht geändert werden.

4. Modell und Nachrichten konfigurieren:

Modell: Geben Sie ein unterstütztes Modell ein, z. B. gpt-4o oder gpt-4o-mini.

Nachrichten: Sie müssen Rolle und Kontext ausfüllen und können für Role zwischen user oder system wählen.

Optionale Parameter (nach Bedarf) sind: Maximale Anzahl an Tokens (z. B. 4096); Sampling-Temperatur (z. B. 0,7); PenaltyStream (Streaming aktivieren/deaktivieren). Für die spezifische Parameterdokumentation und Erklärungen lesen Sie bitte die CometAPI-Dokumentation.

5.Textausführung:

Wählen Sie den CometAPI-Node aus und klicken Sie auf „Execute step“, oder klicken Sie unten auf „Execute workflow“.
Das AUSGABE-Panel auf der rechten Seite sollte eine JSON-Antwort anzeigen (einschließlich choices, usage usw.).

Sie haben nun n8n (empfohlen) lokal unter Linux via npm installiert, den CometAPI-Community-Node installiert und konfiguriert und können Workflows ausführen, die Modelle wie gpt-4o aufrufen, um Antworten zu erhalten.

Welche häufigen Probleme gibt es und wie behebe ich sie?

1) „401 Unauthorized“ oder „Invalid API key“

Bestätigen Sie den exakten Token-String in Ihrem CometAPI-Dashboard (es kann ähnlich benannte Tokens geben). Kopieren → in n8n-Credential einfügen und bei Bedarf den Node neu starten.
Stellen Sie sicher, dass das Authorization-Header-Format Bearer sk-xxxxx ist.

2) Community-Node lässt sich nicht installieren / „queue mode“

Wenn Ihr n8n im Queue-Mode läuft, kann die GUI-Installation deaktiviert sein; folgen Sie der Anleitung zur manuellen Installation, um Community-Nodes via npm zu installieren, oder bauen Sie ein benutzerdefiniertes Image, das den Node enthält. Starten Sie n8n nach der Installation neu.

3) Node nach Installation nicht in der Palette zu finden

Starten Sie n8n neu.
Stellen Sie sicher, dass Sie das Paket im richtigen Kontext installiert haben (im Container-Image oder im .n8n/custom-Pfad, falls Sie dieses Muster nutzen).
Prüfen Sie die Container-Logs auf Fehler bei der Modulauflösung.

4) Rate Limits oder Kontingentprobleme

Prüfen Sie das CometAPI-Dashboard auf Nutzung und Kontingent.
Implementieren Sie exponentielles Backoff und Fallbacks auf günstigere Modelle, wenn Sie Limit-Warnungen oder HTTP 429 erkennen.

Gibt es Alternativen, wenn der Community-Node nicht verfügbar ist oder Sie mehr Flexibilität möchten?

Ja — Sie können jederzeit direkt den HTTP Request-Node verwenden (volle Kontrolle) oder einen OpenAI-Node mit Base-URL-Umleitung (praktische Abkürzung). Die Verwendung von Raw-HTTP erleichtert es auch, neue CometAPI-Endpunkte zu übernehmen, sobald sie veröffentlicht werden (z. B. Image-/Video-Endpunkte).Bitte beachten Sie Leitfaden.

Siehe auch So verwenden Sie n8n mit CometAPI

Fazit:

CometAPI bietet Ihnen Modellwahl und betriebliche Einfachheit; n8n liefert visuelle Orchestrierung und Erweiterbarkeit. Verwenden Sie den OpenAI-Credential-Trick für eine schnelle Chat-/Completion-Integration und Community-Nodes, wo sie existieren und vertrauenswürdig sind. Instrumentieren Sie jeden Workflow für Kosten, Latenz und Sicherheit; bevorzugen Sie menschliche Fallbacks für Entscheidungen, die wichtig sind; und halten Sie Ihre Modellauswahl dynamisch, damit Sie sich an die schnelle Entwicklung in der KI-Anbieterlandschaft anpassen können. Die Kombination aus n8n und CometAPI ist mächtig, aber wie alle mächtigen Werkzeuge braucht sie Leitplanken — beobachten, testen und iterieren.