SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

Was ist n8n? Workflow-Automatisierung erklärt

n8n ist ein selbst gehostetes Tool für Workflow-Automatisierung: Sie erfahren, wie man es ausspricht, Workflows baut und wann sich der Einsatz lohnt.

Was ist n8n?

n8n ist ein Tool zur Workflow-Automatisierung, das Sie auf Ihrem eigenen Server betreiben können. Ein Workflow ist eine Kette von Boxen, die als Nodes bezeichnet werden. Der erste Node wartet darauf, dass etwas geschieht. Die folgenden Nodes führen die Aufgaben aus. Sie verbinden die Nodes in einem browserbasierten Editor. Wenn die vorgefertigten Nodes Ihre Anforderungen nicht erfüllen, wechseln Sie an diesem Schritt zu einem Code Node und schreiben JavaScript oder Python.

Zwei Eigenschaften von n8n sind wichtiger als jede Funktionsliste. Es handelt sich um Software mit verfügbarem Quellcode, die Sie selbst hosten. Daher bleiben die Workflows und die darin verwendeten Zugangsdaten auf einem von Ihnen kontrollierten Rechner. Außerdem verwendet n8n einfaches HTTP und JSON statt des Katalogs eines einzelnen Anbieters. Daher lässt sich auch ein interner Dienst, von dem kein gehostetes Automatisierungsprodukt je gehört hat, einfach über einen HTTP Request Node anbinden.

Wie spricht man n8n aus, und was bedeutet der Name?

Es wird „n-eight-n“ ausgesprochen.

Der Name ist eine verkürzte Form von „nodemation“. Die eigene Erklärung des Gründers steht in der README des Projekts: „node-“, weil der Editor eine Knotenansicht verwendet und die Laufzeitumgebung Node.js ist, sowie „-mation“ als Kurzform für Automation. Zählt man die Buchstaben zwischen dem ersten n und dem letzten n von „nodemation“, erhält man acht. Daher stammt die 8. Der Gründer kürzte den Namen, weil der lange Name zu viel Aufwand beim wiederholten Eingeben in ein Terminal verursachte.

Trigger, Knoten und die Daten dazwischen

Jeder Workflow beginnt mit einem Trigger-Knoten. Der Trigger legt fest, wann der Workflow ausgeführt wird. Ein Webhook-Trigger wird ausgelöst, wenn eine HTTP-Anfrage an einer URL eingeht, die n8n für Sie bereitstellt. Ein Schedule-Trigger wird zeitgesteuert ausgelöst. Ein App-Trigger wird ausgelöst, wenn der überwachte Dienst ein neues Ereignis meldet. Ein Workflow ohne Trigger-Knoten kann nicht selbstständig starten. Er wird daher nur ausgeführt, wenn Sie im Editor auf die Schaltfläche klicken.

Alles nach dem Trigger ist ein Aktionsknoten: eine Nachricht senden, eine API aufrufen, eine Datenbank lesen, ein Feld umformen oder anhand einer Bedingung verzweigen. Die Knoten werden von links nach rechts entlang der von Ihnen gezeichneten Verbindungen ausgeführt. Ein IF-Knoten teilt die Verbindung in zwei Pfade. Switch unterstützt mehrere Ausgabepfade. Jeder Ausgabepfad wird unabhängig weiterverarbeitet.

Die Daten werden als Liste von Items zwischen den Knoten übertragen. Jedes Item ist ein JSON-Objekt, das unter einem json-Schlüssel liegt. Wenn das Item eine Datei enthält, gibt es zusätzlich einen optionalen binary-Schlüssel. Die meisten Knoten werden einmal pro Item ausgeführt. Übergibt ein Trigger beispielsweise fünfzig Items, führt der nächste Knoten seine Aufgabe fünfzigmal aus. Das ist der erste Punkt, der viele Benutzer überrascht: Eine Ausführung eines Workflows entspricht nicht einer einzelnen Operation. Sie entspricht einer Operation pro Item.

Knoten lesen diese Daten mit Expressions. Eine Expression ist ein kurzer JavaScript-Ausdruck in doppelten geschweiften Klammern. {{ $json.email }} bedeutet „das Feld email des Items, das dieser Knoten gerade verarbeitet“. Überall dort, wo ein Knoten die Eingabe eines Werts erlaubt, können Sie stattdessen eine Expression eingeben.

Ein kleiner Workflow, von Anfang bis Ende

Das folgende Beispiel umfasst drei Nodes. Eine Anfrage trifft ein, ein Node formt sie um, ein anderer Node sendet eine Nachricht. Sie können den Ablauf nachvollziehen, ohne etwas zu installieren.

Schritt 1. Fügen Sie einen Webhook-Node hinzu und setzen Sie die HTTP-Methode auf POST. n8n zeigt oben im Node-Bereich zwei URLs an. Die Test-URL funktioniert, solange der Editor auf Ereignisse wartet. Die Produktions-URL funktioniert erst, sobald der Workflow veröffentlicht wurde. Die URLs sind absichtlich unterschiedlich, damit Ihr unfertiger Workflow keinen echten Netzwerkverkehr beantwortet.

Schritt 2. Klicken Sie auf „Auf Testereignis warten“ und senden Sie anschließend etwas an den Node. Fügen Sie die Test-URL aus dem Node-Bereich in die folgende Variable ein.

# paste the test URL that the Webhook node shows in the editor
TEST_URL='https://n8n.example.com/webhook-test/xxxxxxxx'
curl -X POST -H 'Content-Type: application/json' \
  -d '{"name":"Ana","plan":"pro","email":"ana@example.com"}' \
  "$TEST_URL"

Der Node-Bereich wird mit einem Item gefüllt und sieht so aus:

{
  "headers": { "content-type": "application/json" },
  "params": {},
  "query": {},
  "body": { "name": "Ana", "plan": "pro", "email": "ana@example.com" }
}

Diese Struktur sollten Sie sich einprägen. Ihre gesendeten Daten stehen unter body. Die Header und die Query-Zeichenkette stehen daneben und werden nicht darin zusammengeführt. Ein erster Workflow, der {{ $json.name }} liest, erhält einen leeren Wert, weil sich das Feld tatsächlich unter {{ $json.body.name }} befindet.

Schritt 3. Fügen Sie einen Edit Fields (Set)-Node hinzu. Erstellen Sie ein String-Feld mit dem Namen message und setzen Sie seinen Wert auf einen Ausdruck:

New signup: {{ $json.body.name }} on the {{ $json.body.plan }} plan

Der Node-Bereich zeigt während der Eingabe eine Vorschau der fertigen Zeichenkette anhand des tatsächlichen Items an. Verwenden Sie diese Vorschau. Ein falscher Pfad wird sofort als leere Vorschau angezeigt und nicht erst um vier Uhr morgens als leere Nachricht in Ihrem Chat-Kanal.

Schritt 4. Fügen Sie den Node hinzu, der die Nachricht sendet. Ein Slack-Node mit ausgewähltem Kanal funktioniert ebenso wie ein HTTP Request-Node, der Daten an die eingehende Webhook-URL sendet, die Ihr Chat-Tool bereitstellt. Setzen Sie das Textfeld auf {{ $json.message }}, also auf das Feld, das der vorherige Node erstellt hat.

Schritt 5. Klicken Sie im Kopfbereich der Canvas auf die Schaltfläche Publish (oder drücken Sie Shift+P) und bestätigen Sie anschließend. Das Benennen von Versionen erfordert n8n Cloud Pro oder Enterprise beziehungsweise Self-Hosted Business oder Enterprise; in der Community Edition ist diese Funktion nicht verfügbar. Es gibt keinen separaten Speicherschritt: n8n speichert Ihre Änderungen automatisch, und Änderungen an Nodes bleiben als Entwurf erhalten, bis Sie den Workflow veröffentlichen. Erst dann antwortet die Produktions-URL. Sie verwendet immer die veröffentlichte Version. Spätere Änderungen an Nodes wirken sich daher erst nach einer erneuten Veröffentlichung auf die Produktion aus. Workflow-Einstellungen sind eine Ausnahme: Wenn Sie nur diese Einstellungen ändern, veröffentlicht n8n die Version automatisch erneut. Rufen Sie die URL vor der Veröffentlichung auf, erhalten Sie HTTP 404 mit einem Body, der genau angibt, was falsch ist. Dabei wird weiterhin die Formulierung verwendet, die vor n8n 2.0 galt, als n8n den Active-Schalter durch Publish ersetzte:

The requested webhook "POST new-signup" is not registered.
The workflow must be active for a production URL to run successfully.

Rechnen Sie mit einem weiteren Unterschied. Ein Testlauf wird während der Ausführung auf der Canvas dargestellt, sodass Sie den Datenfluss beobachten können. Ein Produktionslauf wird nicht auf der Canvas dargestellt. Er erscheint im Tab Executions auf der Seite Overview. Die Ein- und Ausgaben der Nodes werden entsprechend Ihren Ausführungseinstellungen und Aufbewahrungsgrenzen gespeichert.

n8n selbst betreiben

Am schnellsten erhalten Sie einen praktischen Eindruck mit dem offiziellen Docker-Image. Dies sind die Befehle aus der README des Projekts:

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

Öffnen Sie http://localhost:5678, dann ist der Editor erreichbar. Achten Sie besonders auf das Volume. n8n speichert seine SQLite-Datenbank und den Schlüssel für die Verschlüsselung der Zugangsdaten unter /home/node/.n8n. Ein Container, der ohne dieses Volume gestartet wird, ist daher bei jedem Start leer. Zugangsdaten, die in einem später gelöschten Volume gespeichert wurden, können anschließend nicht mehr entschlüsselt werden.

Dieser Befehl dient zum Ausprobieren, nicht für den produktiven Betrieb. --rm löscht den Container sofort beim Beenden. Außerdem richtet der Befehl weder TLS (Transport Layer Security) noch eine Neustart-Richtlinie ein. Der Editor ist zudem für jeden erreichbar, der Zugriff auf Port 5678 hat. Für eine öffentliche Bereitstellung empfiehlt n8n einen Reverse Proxy, der HTTPS und die Zertifikatserneuerung übernimmt. Genau das beschreibt n8n auf einem VPS mit Docker und HTTPS installieren. Sie können HTTPS auch direkt in n8n bereitstellen. Setzen Sie dazu N8N_PROTOCOL=https und geben Sie in N8N_SSL_CERT und N8N_SSL_KEY die Pfade zu Ihren Zertifikats- und Schlüsseldateien an. Die Zertifikate müssen Sie dann selbst erneuern. Wenn Compose-Dateien für Sie neu sind, lesen Sie zuerst Docker Compose auf einem VPS.

Eine Einstellung verursacht bei fast allen Benutzern des Schedule-Triggers Probleme. Geplante Workflows verwenden die Zeitzone des Workflows, sofern Sie eine festlegen. Andernfalls gilt die Zeitzone der Instanz. Bei selbst gehosteten Instanzen ist dies standardmäßig America/New_York. Legen Sie die Zeitzone am ersten Tag bewusst fest: Zeitzonen und Zeitpläne in n8n beschreibt die Variable und die Probleme bei der Umstellung zwischen Standard- und Sommerzeit.

Wann n8n einen Cron-Job und ein Shell-Skript übertrifft

Ein Shell-Skript unter cron ist kleiner, schneller und leichter nachzuvollziehen als jede Automatisierungsplattform. Es benötigt keine Datenbank für Backups, keinen Editor und keinen Port, den Sie absichern müssen. Wenn die Aufgabe lautet: „Führen Sie dies um 04:00 aus und schreiben Sie eine Datei“, dann schreiben Sie das Skript. Daran verbessert dieser Ansatz nichts.

n8n lohnt sich, wenn eine dieser Bedingungen erfüllt ist:

  • Der Auslöser ist keine Uhrzeit. cron kann nicht auf eine eingehende HTTP-Anfrage oder auf eine neue Zeile in einer Tabelle reagieren.
  • Die Verarbeitung umfasst mehrere APIs, jeweils mit eigener Authentifizierung, Paginierung und Rate-Limits. Der Credential Store und die Retry-Einstellungen pro Node nehmen Ihnen die langweilige Hälfte dieses Codes ab.
  • Sie müssen nachvollziehen können, was passiert ist. Ausführungsdaten werden entsprechend Ihren Ausführungseinstellungen und Aufbewahrungslimits gespeichert. Sie öffnen einen gespeicherten fehlgeschlagenen Lauf und sehen sich das genaue Element an, das den Fehler verursacht hat. Ein Cron-Job liefert Ihnen einen Exit-Code und eine Zeile in einem Mail-Spool.
  • Eine Person ohne Programmierkenntnisse muss die Konfiguration in sechs Monaten ändern. Einen Wert in einem Node-Panel zu bearbeiten, ist deutlich weniger riskant, als ein Shell-Skript auf einem Produktionsserver zu ändern.

Der Aufwand ist real und nicht gleich null. Sie erhalten einen Dienst, den Sie dauerhaft betreiben müssen, eine Datenbank, die Sie sichern müssen, und alle paar Wochen ein Upgrade. Behandeln Sie ihn wie jeden anderen Dienst, den Sie hosten, denn genau das ist er.

Wenn ein gehosteter Dienst die bessere Lösung ist

Self-Hosting beansprucht Ihre Aufmerksamkeit, und Aufmerksamkeit ist die knappe Ressource. n8n Cloud, die gehostete Version des Anbieters, übernimmt Upgrades und Backups für Sie. Außerdem erhalten Sie eine stabile öffentliche URL für Webhooks, ohne selbst eine Domain verwalten zu müssen. Wählen Sie diese Option, wenn die Automatisierung für Sie wichtiger ist als die darunterliegende Infrastruktur.

Betreiben Sie n8n auf Ihrem eigenen Server, wenn die Daten Ihre Kontrolle nicht verlassen dürfen oder wenn die Workflows Dienste in einem privaten Netzwerk erreichen müssen, auf das ein gehosteter Runner keinen Zugriff hat. Auch die Kosten hängen vom Volumen ab: Gehostete Tarife werden nach Nutzung abgerechnet. Bei der selbst gehosteten Community Edition fallen keine n8n-Ausführungsgebühren an. Die Kosten für das Hosting und für kostenpflichtige Dienste, die Ihre Workflows aufrufen, bestehen jedoch weiterhin. Für die selbst gehosteten Business- und Enterprise-Tarife gilt ebenfalls eine nutzungsabhängige Abrechnung.

Wenn Ihre eigentliche Frage n8n im Vergleich zu einem anderen Produkt betrifft, stellt der Vergleich von n8n, Zapier und Make die drei Preismodelle und die jeweiligen Grenzen gegenüber. Wenn Sie dieses Konzept aus einem vollständig anderen Projekt betrachten möchten, ist die Übersicht der selbst gehosteten Alternativen zu n8n der kürzere Weg.

Wo die Lizenzgrenze verläuft

n8n bezeichnet sein Lizenzmodell als Fair-Code. Der Quellcode ist öffentlich und vollständig einsehbar, aber die Lizenz schränkt weiterhin ein, was Sie damit tun dürfen. Der Code steht unter der Sustainable Use License. Deren Abschnitt „Limitations“ umfasst vier Sätze, wobei der erste den wesentlichen Teil regelt: „Sie dürfen die Software nur für Ihre eigenen internen Geschäftszwecke oder für nicht kommerzielle beziehungsweise private Zwecke verwenden oder ändern.“ Sie dürfen die Software nur kostenlos und für nicht kommerzielle Zwecke an andere Personen weitergeben. Außerdem dürfen Sie die Copyright- oder Lizenzhinweise nicht daraus entfernen. Der vierte Satz überlässt jede Nutzung der Marken von n8n dem geltenden Recht.

In der Praxis bedeutet das: Sie dürfen n8n für die Arbeit Ihres eigenen Unternehmens betreiben. Wenn Sie n8n jedoch als Dienst hosten, in dem Kunden eigene Workflows erstellen oder konfigurieren, benötigen Sie eine kommerzielle Vereinbarung. Sie dürfen für das Erstellen und Warten von Kundenautomatisierungen auf Ihrer Instanz Gebühren verlangen, solange Kunden diese nicht selbst erstellen oder bearbeiten können. Dies entspricht nicht der Definition von Open Source der Open Source Initiative, weil diese Definition genau eine solche Beschränkung des Verwendungszwecks untersagt. Single Sign-on mit SAML ist in den Plänen Business und Enterprise verfügbar. Das Streamen von Logs bleibt eine Funktion von Enterprise. Die vollständige Aufteilung finden Sie unter welche Funktionen die kostenlose Community Edition umfasst und welche nicht.

Wo die KI-Funktionen zum Einsatz kommen

Die jüngste Aufmerksamkeit für n8n gilt vor allem den KI-Nodes. Sie folgen jedoch demselben Modell wie alle anderen Nodes. Ein AI Agent-Node verwendet ein Large Language Model (LLM) als Sub-Node und mehrere Tools als weitere Sub-Nodes. Ein Tool ist dabei einfach ein weiterer n8n-Node, den das Modell aufrufen darf. Der umgebende Workflow bleibt gewöhnlich: Ein Trigger nimmt Daten entgegen, der Agent entscheidet über das weitere Vorgehen, und normale Nodes führen die übrigen Schritte aus. Einen AI Agent in n8n erstellen zeigt diese vollständige Verknüpfung.

FAQ

Wie spricht man n8n aus?

Die Aussprache lautet „n-eight-n“. Der Name ist eine Kurzform von „nodemation“. Der Gründer bildete ihn aus „node-“ (der Editor ist eine Node-Ansicht, die auf Node.js läuft) und „-mation“ (Automation). Die 8 steht für die acht Buchstaben zwischen dem ersten n und dem letzten n von „nodemation“. Die Kurzform entstand, weil die Eingabe des langen Namens in einem Terminal zu umständlich wurde.

Ist n8n kostenlos nutzbar?

Die Community Edition kann unter der Sustainable Use License kostenlos heruntergeladen und selbst gehostet werden. n8n erhebt dafür keine Gebühr pro Ausführung. Für die kostenpflichtigen, selbst gehosteten Pläne Business und Enterprise gilt eine auf Ausführungen basierende Preisgestaltung. Die Lizenz erlaubt die Nutzung für Ihre eigenen internen Geschäftszwecke oder für private Zwecke. Sie erlaubt es nicht, n8n als Dienst zu hosten, in dem Kunden eigene Workflows erstellen oder konfigurieren. n8n Cloud ist ein kostenpflichtiges Produkt. Single Sign-on mit SAML ist in den Plänen Business und Enterprise enthalten.

Muss ich programmieren können, um n8n zu verwenden?

Nein, für den üblichen Einstieg nicht. Sie wählen Nodes aus, verbinden sie und füllen die Felder aus. Sobald Sie Daten umformen, sind grundlegende JavaScript-Kenntnisse hilfreich, weil Ausdrücke wie {{ $json.body.email }} innerhalb doppelter geschweifter Klammern JavaScript enthalten. Wenn ein Workflow Logik benötigt, die kein Node abdeckt, können Sie in einem Code-Node für diesen einzelnen Schritt JavaScript oder Python schreiben und das Ergebnis an den nächsten Node übergeben.

Was ist der Unterschied zwischen der Test-URL und der Produktions-URL eines Webhooks?

Die Test-URL wartet auf Anfragen, wenn Sie im Editor auf „Listen for test event“ oder „Execute workflow“ klicken. Das Ergebnis wird auf dem Canvas angezeigt, sodass Sie jeden Node prüfen können. Die Produktions-URL antwortet erst, wenn der Workflow veröffentlicht wurde. Sie führt die veröffentlichte Version aus und nicht die neuesten Änderungen an den Nodes Ihres Entwurfs. Die Ausführungen erscheinen in der Liste „Executions“ und nicht auf dem Canvas. Änderungen, die nur die Workflow-Einstellungen betreffen, veranlassen n8n automatisch zu einer erneuten Veröffentlichung. Wenn Sie die Produktions-URL eines nicht veröffentlichten Workflows aufrufen, wird HTTP 404 zurückgegeben. Die Meldung besagt, dass der angeforderte Webhook nicht registriert ist, und weist darauf hin, dass der Workflow aktiv sein muss.

Ist n8n Open Source?

Der Quellcode ist öffentlich, und Sie können n8n selbst hosten. Daher ist n8n quelloffen verfügbar. Nach der Definition der Open Source Initiative ist n8n jedoch nicht Open Source, weil die Sustainable Use License die Nutzung auf interne Geschäftszwecke, private oder nicht kommerzielle Zwecke beschränkt. Von der OSI genehmigte Lizenzen dürfen den Verwendungszweck nicht beschränken. n8n bezeichnet diese Position als Fair-Code.

War dieser Artikel hilfreich?