Langflow 2026 selbst hosten: Flows, API-Zugriff und persistenter Zustand
Langflow mit den richtigen Ports, persistentem Storage, HTTPS, Secrets, Backups und Upgrade-Prüfungen selbst hosten. Erfahre, wie du das Problem behebst, wenn sich ein Secret nach einem Neustart ändert.
Behandle Langflow als kleines System und nicht als Docker-Image. Das Nutzerziel für Langflow ist klar: ein visueller LLM-Workflow-Builder, der Flows als APIs bereitstellt. Die Bereitstellung ist erst dann akzeptabel, wenn du einen Flow mit einer Provider-Credential erstellen, ihn im Editor ausführen, seine API aufrufen und die Antwort nach einem Neustart des Service verifizieren kannst.
Diese Unterscheidung macht den Fehler sichtbar, auf den Betreiber nach lokalen Tests stoßen: Ein Secret ändert sich nach dem Neustart oder Component-Abhängigkeiten fehlen. Außerdem wird der Backup- und Upgrade-Plan dadurch konkret genug, um ihn zu testen.
Erfolg für Langflow zuerst definieren
Lass nicht versehentlich das Langflow-Image die Produktionsarchitektur bestimmen. Das Image stellt einen Prozess auf Port 7860 bereit; Storage, Routing und externe Anforderungen benötigen weiterhin bewusst festgelegte Lifecycles. Der Netzwerkvertrag für Langflow umfasst Postgres für persistenten Zustand sowie Credentials für Model-Provider. Halte private Endpunkte in einem internen DNS, erlaube nur erforderliche ausgehende Verbindungen und gib Langflow eine eingeschränkte Service-Credential.
Die Bereitstellung ist bereit für weiterführende Tests, wenn sie einen Flow mit einer Provider-Credential erstellen, ihn im Editor ausführen, seine API aufrufen und die Antwort nach einem Neustart des Service verifizieren kann. Verfolge die Transaktion in den Logs und beobachte Component-Ausführung, Model-Latenz, parallele API-Aufrufe, File-Parsing und die Anzahl der Datenbankverbindungen. Diese Beobachtungen zeigen, ob die aktuelle Topologie die richtige Komponente isoliert.
Langflow mit beobachtbaren Standardeinstellungen starten
Halte den initialen Langflow-Aufruf so reproduzierbar, dass er sich in einem Pull Request überprüfen lässt.
docker run -d \
--name langflow \
--restart unless-stopped \
-p 127.0.0.1:7860:7860 \
-v langflow-data:/app/langflow \
-e LANGFLOW_SECRET_KEY=replace-with-a-long-random-value \
langflowai/langflow:latest
Verlasse dich nicht auf latest, sobald echte Daten vorhanden sind. Halte den funktionierenden Digest, den Container-User und die Besitzrechte des Mounts fest. Verfolge die Application-Logs durch einen vollständigen Test — erstelle einen Flow mit einer Provider-Credential, führe ihn im Editor aus, rufe seine API auf und verifiziere die Antwort nach einem Neustart des Service — und notiere alle Migrationen, bevor du die Route für produktiven Traffic freigibst.
Langflow von außerhalb des Servers testen
Behandle die externe Langflow-URL als Konfiguration, die Redeployments übersteht. Lege zuerst die öffentliche Adresse fest, die von API-Clients und Authentication-Callbacks verwendet wird. Leite anschließend den Hostnamen mit unverändertem ursprünglichem Host und Schema auf Port 7860 weiter.
Die Checkliste zur Erreichbarkeit einer Deployment-Route kann nachweisen, dass Requests den Container erreichen. Danach sollte der bekannte Fehler — ein Secret ändert sich nach dem Neustart oder Component-Abhängigkeiten fehlen — in Langflow, seinem Zustand oder seiner Workload untersucht werden und nicht in der Zertifikatsautomatisierung.
Austauschbare Container von dauerhaften Daten trennen
Ein Container-Image kann erneut heruntergeladen werden; Flows, Datenbank, API-Keys und hochgeladene Dateien nicht. Mounte /app/langflow vor dem Bootstrap, schreibe harmlose Beispieldaten und ersetze den Container, um zu beweisen, dass dieser Pfad tatsächlich persistent ist. Prüfe den effektiven Mount, statt einem Compose-Dateinamen zu vertrauen, und stelle sicher, dass der Runtime-User an der von Langflow erwarteten Stelle schreiben kann.
Lege Aufbewahrungsfristen und ein Off-Host-Ziel fest und übe anschließend die Wiederherstellung, ohne die Produktion zu berühren. Die Übung ist nur dann erfolgreich, wenn Flows, Benutzer, Credentials und Dateien zurückkehren und ein vorhandener API-Client den wiederhergestellten Flow ausführen kann. Bei datenbankgestütztem Zustand solltest du Storage-Snapshots mit konsistenten Application-Exports kombinieren, wie unter Point-in-Time-Recovery im Vergleich zu Snapshots beschrieben.
Sicherheitsentscheidungen speziell für Langflow
Übernimm keine Sicherheitsannahmen aus einem lokalen Tutorial. Das spezifische Risiko von Langflow besteht darin, Flow-Erstellung und gespeicherte Provider-Keys ohne Authentication bereitzustellen. In der Produktion solltest du daher den Builder schützen, den API-Zugriff einschränken und Model-Credentials in verschlüsseltem serverseitigem Storage aufbewahren.
Behandle LANGFLOW_SECRET_KEY entsprechend seiner Rolle in Langflow: Halte sensible Werte aus Git heraus, dokumentiere die Auswirkungen einer Rotation und ersetze niemals ein öffentliches Beispiel in der Produktion. Beschränke Datei- und Netzwerkzugriffe, sichere Setup-Endpunkte ab und definiere Limits für Uploads, Requests oder Ausführungen rund um Component-Ausführung, Model-Latenz, parallele API-Aufrufe, File-Parsing und die Anzahl der Datenbankverbindungen.
Kapazitäts- und Upgrade-Prüfungen
Die erste nützliche Betriebsmetrik für Langflow ist die Frage, ob ein Flow mit einer Provider-Credential erstellt, im Editor ausgeführt, über seine API aufgerufen und die Antwort nach einem Neustart des Service verifiziert werden kann. Ergänze diese Prüfung um Sättigungssignale für Component-Ausführung, Model-Latenz, parallele API-Aufrufe, File-Parsing und die Anzahl der Datenbankverbindungen. Ein reiner Process-Probe sollte keine teuren Abhängigkeiten aufrufen und den Container nicht neu starten, nur weil ein Upstream kurzzeitig nicht verfügbar ist.
Behandle Upgrades als Datenänderungen, da sich Component-Packages, Datenbankmigrationen und serialisierte Flows zwischen Langflow-Releases ändern können. Pinne Versionen, übe den Ablauf mit wiederhergestelltem Zustand und halte das vorherige Image verfügbar, bis ein Rollback weiterhin gültig ist. Wenn sich ein Secret nach dem Neustart ändert oder Component-Abhängigkeiten fehlen, sichere die Logs von vor dem Neustart; sie enthalten normalerweise die auslösende Meldung.
Eine funktionierende Langflow-Bereitstellung dokumentieren
Mache aus dem Langflow-Smoke-Test einen wiederholbaren Release-Befehl oder ein kurzes Runbook. Die Ausgabe muss dieses Ergebnis nachweisen: Erstelle einen Flow mit einer Provider-Credential, führe ihn im Editor aus, rufe seine API auf und verifiziere die Antwort nach einem Neustart des Service. Dokumentiere gemeinsam mit dem Ergebnis die Application-Version, den Container-Digest, den Hostnamen der Route und die Kennung der Testdaten.
Führe dieselbe Prüfung nach einem regulären Container-Austausch sowie nach der Wiederherstellung von Flows, Datenbank, API-Keys und hochgeladenen Dateien an einem anderen Ort durch. Die Wiederherstellung war erfolgreich, wenn Flows, Benutzer, Credentials und Dateien zurückkehren und ein vorhandener API-Client den wiederhergestellten Flow ausführen kann. Vergleiche Timing und Verbrauch im Zusammenhang mit Component-Ausführung, Model-Latenz, parallelen API-Aufrufen, File-Parsing und der Anzahl der Datenbankverbindungen. Eine deutliche Änderung verdient auch dann eine Untersuchung, wenn die abschließende Aktion weiterhin erfolgreich ist.
Übe anschließend einen sicheren Fehlerfall: Entziehe der Testidentität vorübergehend den Zugriff auf Postgres für persistenten Zustand sowie auf die Credentials des Model-Providers. Bestätige, dass Langflow den Fehler sichtbar macht und ohne destruktive manuelle Änderungen zum Normalbetrieb zurückkehrt. Bewahre nur den erforderlichen, redigierten Log-Auszug auf. Dieses Gate aus vier Teilen deckt Start, Persistenz, Wiederherstellung und Fehlerbehandlung ab.
Was Dockup für Langflow automatisieren sollte
Die Plattformebene für Langflow besteht aus Port 7860, Ingress, TLS, Runtime-Konfiguration, Storage und der Erreichbarkeit von Abhängigkeiten. Dockup kann diese Bestandteile für die eigene Infrastruktur oder für einen Server reproduzieren, den der Kunde verbindet.
Anschließend schließt der Betreiber die Produktebene ab: Lege die öffentliche Adresse fest, die von API-Clients und Authentication-Callbacks verwendet wird; setze diese Zugriffsregel durch — schütze den Builder, schränke den API-Zugriff ein und bewahre Model-Credentials in verschlüsseltem serverseitigem Storage auf — und führe „Erstelle einen Flow mit einer Provider-Credential, führe ihn im Editor aus, rufe seine API auf und verifiziere die Antwort nach einem Neustart des Service“ aus. Wenn dieser Test gemeinsam mit der Bereitstellung dokumentiert wird, lässt sich automatisiertes Provisioning klar von der Application-Readiness unterscheiden.
Häufig gestellte Fragen
Was benötigt Langflow für eine produktive Bereitstellung?
Leite den Langflow-Container auf Port 7860 über eine HTTPS-Origin weiter. Die unterstützende Netzwerkanforderung umfasst Postgres für persistenten Zustand sowie Credentials für Model-Provider. Betrachte Langflow erst dann als bereit, wenn du einen Flow mit einer Provider-Credential erstellen, ihn im Editor ausführen, seine API aufrufen und die Antwort nach einem Neustart des Service verifizieren kannst.
Welche Langflow-Daten gehören in ein Backup?
Persistiere /app/langflow und nimm Flows, Datenbank, API-Keys und hochgeladene Dateien in dasselbe Recovery-Manifest auf. Eine saubere Langflow-Wiederherstellung ist nur dann erfolgreich, wenn Flows, Benutzer, Credentials und Dateien zurückkehren und ein vorhandener API-Client den wiederhergestellten Flow ausführen kann.
Benötigt Langflow hinter einem Reverse Proxy HTTPS?
Verwende HTTPS für die öffentliche Langflow-Origin und halte Port 7860 auf der internen Route. Wende die Langflow-Einstellung korrekt an: Lege die öffentliche Adresse fest, die von API-Clients und Authentication-Callbacks verwendet wird. Bei Langflow schützt HTTPS Credentials oder Benutzerinhalte während der Übertragung und sorgt für ein konsistentes, origin-sensitives Client-Verhalten.
Wie sollte ein Langflow-Upgrade getestet werden?
Stelle den aktuellen Langflow-Zustand in einer isolierten Bereitstellung wieder her, spiele die Kandidatenversion ein und wiederhole die Abnahmetransaktion. Gehe dabei besonders sorgfältig vor, da sich Component-Packages, Datenbankmigrationen und serialisierte Flows zwischen Langflow-Releases ändern können. Halte das vorherige Langflow-Image verfügbar, bis die Grenzen für Datenmigration und Rollback geklärt sind.