PRIVATE INFRASTRUKTUR / KEINE IDENTITÄT ERFORDERLICHLesen Sie die Datenschutzgrundsätze
Die KoalaVPS-Feldnotizen

Workflows, die den nächsten Neustart überstehen.

Ein selbst gehosteter Automatisierungseditor kann mächtige Konten verbinden. Behandeln Sie seine Datenbank und seinen Verschlüsselungsschlüssel als kritische Infrastruktur.

Den Editor schützen

Platzieren Sie den Editor hinter HTTPS und unterstützter Authentifizierung. Beschränken Sie den administrativen Zugriff und vermeiden Sie unnötige öffentliche Registrierung. Webhook-Routen erfordern eigene Entscheidungen zu Exposition und Authentifizierung.

Anmeldedatenschlüssel aufbewahren

Sichern Sie den konfigurierten Verschlüsselungsschlüssel mit angemessenem Schutz. Die Wiederherstellung einer Datenbank ohne den richtigen Schlüssel kann gespeicherte Anmeldedaten unbrauchbar machen. Halten Sie den Schlüssel aus Screenshots, Repositories und ungefilterten Protokollen heraus.

Skalieren Sie den Ausführungspfad bewusst

Prüfen Sie für ein stark ausgelastetes Setup das unterstützte Datenbank-, Warteschlangen- und Worker-Modell. Redis und separate Worker bringen eigene Zugriffs- und Persistenzanforderungen mit. Begrenzen Sie gleichzeitige Jobs, damit eine Lastspitze nicht das VPS oder ein externes API-Budget erschöpft.

Bewahren Sie nur nützliche Ausführungsdaten auf

Workflows können Tokens, personenbezogene Daten und Dokumente verarbeiten. Legen Sie die Bereinigung des Ausführungsverlaufs fest, schwärzen Sie sensible Werte und definieren Sie Wiederholungen sorgfältig. Ein duplizierter Webhook darf keine unbeabsichtigte zweite Zahlung oder Nachricht auslösen.

Behandeln Sie den Verschlüsselungsschlüssel als Teil der Datenbank

Gespeicherte Anmeldedaten hängen vom Verschlüsselungsschlüssel von n8n ab. Bewahren Sie das Zustandsverzeichnis auf, das einen automatisch generierten Schlüssel enthält, oder setzen Sie N8N_ENCRYPTION_KEY aus einem privaten Secret Store. Alle Queue-Worker benötigen denselben Schlüssel wie der Hauptprozess. Testen Sie die Wiederherstellung mit einem Wegwerf-Anmeldedatensatz; eine wiederhergestellte Datenbank allein kann gesund erscheinen, während ihre Anmeldedaten unlesbar bleiben.

  • Bewahren Sie den Schlüssel außerhalb des öffentlichen Verzeichnisses und des Repositorys auf
  • Sichern Sie die Datenbank konsistent
  • Verwenden Sie unterstütztes PostgreSQL für die vorgesehene Produktionsbereitstellung

Geben Sie Webhooks ihre öffentliche Adresse

Ein Reverse-Proxy wie Caddy kann HTTPS terminieren, während n8n intern lauscht. Die aktuelle Dokumentation verwendet N8N_WEBHOOK_URL für den externen Webhook-Ursprung und ersetzt den älteren Namen WEBHOOK_URL ab Version 2.35.0. Setzen Sie die Anzahl vertrauenswürdiger Proxy-Hops auf den tatsächlichen Pfad; ein einzelner Proxy verwendet N8N_PROXY_HOPS=1. Bewahren Sie weitergeleitete Host-, Protokoll- und Client-Informationen. Testen Sie einen Webhook von außerhalb des Servers und prüfen Sie dessen Produktions-URL.

  • Legen Sie die Zeitzone des Workflows bewusst fest
  • Bereinigen Sie Ausführungsverläufe, die sensible Eingaben enthalten
  • Verwenden Sie Queue-Worker und Redis nur mit den erforderlichen privaten Zugriffskontrollen
# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

Definieren Sie die Arbeitslast und die erlaubten Integrationen

Listen Sie die Auslöser, externen Konten, das erwartete Ausführungsvolumen und die maximalen Kosten oder Nebenwirkungen auf, die jeder Workflow verursachen kann. Prüfen Sie die n8-Lizenz für die tatsächliche Nutzung, insbesondere wenn Sie sie anderen als Dienst anbieten. Ein kleiner geplanter Workflow und ein öffentlicher Webhook-Prozessor haben unterschiedliche Ressourcenanforderungen. Beginnen Sie mit einer unterstützten Version, privatem persistentem Zustand, einem TLS-Namen und einer für die Bereitstellung geeigneten Datenbank; vermeiden Sie es, Datenbankports mit dem Editor offenzulegen.

  • Verwenden Sie separate eingeschränkte Zugangsdaten für jede Integration.
  • Legen Sie die vorgesehene Workflow-Zeitzone und die Aufbewahrung des Ausführungsverlaufs fest.
  • Halten Sie exportierte Workflows frei von eingebetteten echten Geheimnissen.

Legen Sie den öffentlichen Webhook-Ursprung für die installierte Version fest

Ein Reverse-Proxy wie Caddy erreicht n8n intern, während externe Dienste dessen HTTPS-Webhook-Ursprung aufrufen. Verwenden Sie die für das installierte Release dokumentierte Webhook-URL-Variable; die aktuelle Dokumentation nennt N8N_WEBHOOK_URL, während ältere Releases WEBHOOK_URL verwendeten. Setzen Sie die tatsächliche Proxy-Hop-Anzahl, statt beliebigen weitergeleiteten Headern zu vertrauen. Halten Sie die Editor-Zugriffsrichtlinie getrennt von der Webhook-Authentifizierung und prüfen Sie, dass der Produktions-Callback keinen internen Host oder Port enthält.

# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

Testen Sie einen harmlosen Workflow, bevor Sie Schreibzugriff gewähren

Beginnen Sie mit einer schreibgeschützten Anfrage oder einem entbehrlichen Testdatensatz. Testen Sie den Produktions-Webhook von außerhalb des VPS, die Ablehnung der Authentifizierung und einen bewussten Wiederholungsversuch. Eine wiederholte Anfrage darf nicht versehentlich eine zweite folgenreiche Aktion auslösen. Prüfen Sie die Ausführungsprotokolle auf preisgegebene Eingaben und wenden Sie dann eine Aufbewahrungsrichtlinie an. Wenn ein Webhook nur im Testmodus des Editors funktioniert, prüfen Sie, ob der Workflow veröffentlicht/aktiv ist und ob die Produktions- und Testrouten den richtigen Prozess erreichen.

  • Testen Sie eine Wiederherstellung mit einem Einweg-Integrationszugang.
  • Bewahren Sie eine unabhängige verschlüsselte Kopie von N8N_ENCRYPTION_KEY oder des generierten Schlüsselzustands auf.
  • Senden Sie keine Beispielpasswörter oder API-Tokens in aufbewahrte Debug-Ausgaben.

Erst skalieren, nachdem der Ausführungsengpass beobachtet wurde

Der Queue-Modus ergänzt Redis, Worker und eine gemeinsame Datenbank; der Hauptprozess empfängt Trigger, während Worker Ausführungen durchführen. Jeder Worker muss denselben Verschlüsselungsschlüssel für Anmeldedaten verwenden. Befolgen Sie die aktuellen Anforderungen an die Speicherung von Binärdaten, bevor Sie einen Workflow mit Dateien in den Queue-Modus verschieben. Begrenzen Sie Parallelität und Upstream-API-Budgets und überwachen Sie Warteschlangenalter und Fehler. Sichern Sie Datenbank, Zustand und Schlüssel gemeinsam; einen Container neu zu starten ist kein Wiederherstellungsplan für unlesbare gespeicherte Anmeldedaten.

KONFIGURIEREN SIE IHRE INFRASTRUKTUR

Übernehmen Sie die Kontrolle.
Bereitstellen zu Ihren Bedingungen.

Kein Identitätspapierkram. Vollständiger Administratorzugriff. Krypto-native Abrechnung.