LiteLLM selbst hosten: Architektur- und Security-Guide für Production 2026
LiteLLM kann jeder Anwendung einen OpenAI-kompatiblen Endpoint geben, während das Gateway Provider-Zugangsdaten, Virtual Keys, Budgets, Routing und Observability übernimmt. Die offizielle Dokumentation beschreibt den Proxy als zentralen Service für Plattformteams, getrennt vom Python-SDK in einer einzelnen Anwendung. Genau um diesen Proxy als Infrastruktur geht es hier.
Die unterversorgte Frage lautet nicht mehr: „Kann ich den Container starten?“ Sie lautet: „Kann mein Team das Gateway patchen, skalieren und wiederherstellen, das jetzt alle Modell-Zugangsdaten hält?“ Eine Demo braucht einen Prozess. Production braucht einen Owner, eine private Datenschicht, eine Release-Policy und den Nachweis, dass ein Fehler nicht jedes KI-Feature gleichzeitig stoppt.
Du planst ein produktives KI-Gateway?
Architektur mit uns prüfenWas bedeutet es wirklich, LiteLLM selbst zu hosten?
LiteLLM selbst zu hosten bedeutet, dass Du das Gateway in Deiner eigenen Infrastruktur betreibst. Requests erreichen weiterhin OpenAI, Anthropic, Bedrock oder einen anderen konfigurierten Provider, außer Du leitest sie an einen lokalen Inference-Server wie vLLM oder Ollama. Du kontrollierst Proxy, Keys, Logs und Routing-Policy, nicht automatisch die Modellausführung.
Damit trennt sich dieser Artikel von zwei benachbarten Entscheidungen. Unser Vergleich von LLM-Gateways hilft Dir bei der Wahl zwischen LiteLLM, OpenRouter, Portkey oder einem Routing-Framework. Unser Kosten-Guide für selbst gehostete LLMs in der EU behandelt Modellgewichte und GPU-Inferenz. Hier ist das Produkt die Gateway-Control-Plane zwischen Deinen Anwendungen und beliebigen gehosteten oder lokalen Modellen.
Wann lohnt sich Self-Hosting mit LiteLLM?
LiteLLM gibt für sein Open-Source-Gateway keine Lizenzgebühr an und listet dort Virtual Keys, Budgets, Rate-Limits, Fallbacks, Logging und Prometheus-Metriken. Enterprise ergänzt Governance und Support, etwa SSO, SCIM und Audit-Logs. Prüfe die aktuelle Trennung vor der Beschaffung auf der LiteLLM-Preisseite.
| Situation | Sinnvoller Default | Warum |
|---|---|---|
| Ein Prototyp, ein Provider, kein Plattform-Owner | Provider direkt aufrufen | Ein Gateway wird zur weiteren Production-Abhängigkeit, bevor es ein echtes Problem löst. |
| Mehrere Produkte oder Teams teilen Provider-Accounts | Self-Hosting kann sich lohnen | Begrenzte Keys, zentrale Budgets und eine Provider-Abstraktion schaffen einen klaren Kontrollpunkt. |
| Delivery-Speed ist wichtiger als Infrastrukturkontrolle | Managed Gateway nutzen | Du kaufst Betrieb, Updates und Support, statt sie selbst zu bauen. |
| Private Netze, EU-Deployment oder eigene Controls sind Pflicht | Self-Hosting evaluieren | Du wählst Netzwerk, Region, Logs, Retention und Deployment-Kadenz. |
| Du brauchst zusätzlich lokale Modell-Inferenz | Gateway und Inferenz getrennt betreiben | LiteLLM routet Requests. vLLM, Ollama oder ein anderer Server führt das Modell aus. |
Welche Architektur braucht ein produktives LiteLLM-Deployment?
Der aktuelle LiteLLM-Guide für Production-Deployments beschreibt stateless Services hinter einem Load Balancer, PostgreSQL für Keys, Teams, Spend-Logs und Konfiguration sowie Redis für gemeinsame Rate-Limits, Routing-State und Caching. Er empfiehlt mindestens zwei Replikas und einen eigenen Migrations-Job. Das ist die glaubwürdige Production-Basis, nicht eine öffentlich erreichbare Ein-Container-Compose-Datei.
| Schicht | Verantwortung in Production | Fehlerfrage |
|---|---|---|
| TLS-Ingress oder Load Balancer | TLS terminieren, Routen begrenzen, Missbrauch drosseln und Replikas sauber drainen | Kann ein fehlerhafter Client Management-Endpunkte erreichen oder den Service auslasten? |
| Mindestens zwei LiteLLM-Replikas | Traffic aus einer exakt gepinnten, signierten Image-Version bedienen | Unterbricht ein Rollout oder ein abgestürzter Pod laufende Streams? |
| Managed PostgreSQL | Keys, Teams, Spend und Konfiguration mit Backups speichern | Kannst Du wiederherstellen, bevor das Gateway zum unternehmensweiten Ausfall wird? |
| Managed Redis | Rate-Limits, Cache und Router-State zwischen Replikas teilen | Bleiben Limits korrekt, wenn Traffic auf verschiedenen Pods landet? |
| Secret Store | Provider-Zugangsdaten, Master Key und permanenten Salt Key speichern | Kann eine Anwendung die Provider-Zugangsdaten einer anderen lesen? |
| Metriken, Logs und Traces | Verfügbarkeit, Latenz, Spend, Fehler und Sättigung messen, ohne Prompts zu leaken | Erkennt der On-call, ob LiteLLM, Datenbank oder Provider ausgefallen ist? |
Starte mit dem monolithischen Image, solange die getrennte Skalierung von Gateway, Backend und UI keinen gemessenen Engpass löst. Eine kleinere Architektur lässt sich leichter patchen und wiederherstellen. Komponenten helfen bei hohem Traffic oder strikter administrativer Trennung, erhöhen aber die Release-Koordination.
Wie deployst Du LiteLLM sicher?
- Definiere den Gateway-Vertrag. Liste erlaubte Modell-Aliase, Provider und regionale Fallback-Reihenfolge, Budgets je Workload, erlaubte Endpunkte, Retention-Regeln und den Owner jedes Alerts. Ein gemeinsamer Endpoint ohne Policy zentralisiert nur das Risiko.
- Beweise den Pfad in Staging. Starte einen gepinnten Container an einem privaten Endpoint, mounte eine versionierte
config.yaml, injiziere Provider-Zugangsdaten über die Umgebung und sende einen Request mit dem normalen OpenAI-Client. Exponiere in Production wedermain-latestnoch Detailed-Debug-Logging. - Füge Postgres vor Team-Keys hinzu. Nutze eine private gemanagte Datenbank, verschlüsselte Verbindungen, automatische Backups und einen eigenen Migrations-Job. Halte Schemaänderungen aus Serving-Replikas heraus, damit ein Autoscaling-Event nicht mit einer Migration konkurriert.
- Füge Redis vor der zweiten Replika hinzu. LiteLLMs Production-Checkliste empfiehlt Redis 7 oder neuer, sobald mehr als ein Proxy läuft. Ohne Shared State erzwingen Replikas Limits getrennt und Cache-Hits bleiben lokal. Skaliere in Kubernetes mit einem Worker pro Pod und CPU, nicht mit dauerhaft belegtem Prozessspeicher.
- Vergib je Workload einen eigenen Virtual Key. Die Dokumentation zu Virtual Keys verlangt Postgres und unterstützt Modellzugriff, Budgets und Spend-Zuordnung. Setze Modell- und Routen-Allow-Lists ausdrücklich. Gib keiner Anwendung den Master Key und verlasse Dich nicht darauf, dass eine leere Liste keinen Zugriff bedeutet.
- Setze das Gateway in ein privates Netz. Exponiere über TLS nur Request-Routen, die Clients brauchen. Lege Admin UI und Management-APIs hinter identitätsbasierten Zugriff oder einen eigenen administrativen Pfad. Begrenze Egress auf erlaubte Provider und Observability-Ziele.
- Mache Updates reversibel. Teste Image, Konfiguration und Migrationen gegen eine Kopie des Production-Schemas, deploye einen Canary und spiele repräsentative Requests ab. Halte das vorige Image und ein kompatibles Datenbank-Backup für den Rollback bereit.
- Übe Fehlerfälle. Deaktiviere nacheinander einen Provider, eine Gateway-Replika, Redis und Postgres. Prüfe erwarteten Fallback, Readiness, Alert, Recovery-Ziel und Client-Fehler. Ein nie getesteter Fallback ist Dokumentation, keine Resilienz.
Was hat sich 2026 bei der LiteLLM-Security geändert?
Security muss die Architektur prägen, weil der Proxy Modell-Zugangsdaten, Datenbankzugriff und Request-Inhalte halten kann. Im März 2026 erschienen die bösartigen LiteLLM-Versionen 1.82.7 und 1.82.8 auf PyPI. Laut Incident-Timeline des Projekts konnten die betroffenen Pakete Umgebungs- und Cloud-Zugangsdaten stehlen, während Nutzer der Proxy-Docker-Images nicht betroffen waren. Teams mit diesen Paketen sollten der Incident-Anleitung folgen und exponierte Zugangsdaten rotieren.
Getrennte Proxy-Schwachstellen erhöhten die Anforderungen zusätzlich. Eine kritische SQL-Injection in der API-Key-Prüfung betraf 1.81.16 bis 1.83.6. Eine Command-Injection in MCP-Test-Endpunkten betraf 1.74.2 bis 1.83.6. Eine spätere Rechteausweitung über Virtual Keys wurde in 1.83.14 behoben. Diese alten Fix-Versionen sind historische Untergrenzen, keine empfohlenen Deployment-Ziele.
Die praktische Antwort ist klar: Nutze einen aktuell unterstützten Stable Release, kein Prerelease und keinen alten Mindest-Patch. Am 13. August 2026 markierte GitHub v1.96.2 als neuesten Release und veröffentlichte auf der LiteLLM-Release-Seite einen cosign-Befehl zur Prüfung. Prüfe die Seite am Deployment-Tag erneut, pinne Version oder Digest exakt, verifiziere die Signatur, scanne das Image und promote denselben Digest durch alle Umgebungen.
Was muss vor dem Go-live wahr sein?
- Least Privilege ist ausdrücklich. Jede Workload hat einen eigenen Virtual Key, benannten Owner, erlaubte Modelle, Routen, Budget und Ablaufdatum. Der Master Key erreicht nie eine Anwendung.
- Secrets sind wiederherstellbar und getrennt. Provider Keys und Master Key liegen im Secret Store der Plattform. Der permanente
LITELLM_SALT_KEYwird getrennt gesichert, weil eine Änderung nach dem Speichern von Credentials diese unlesbar macht. - Das Netz schlägt geschlossen fehl. Admin-Routen sind privat, TLS-Prüfung bleibt aktiv, Provider-Egress ist begrenzt und Datenbank sowie Redis haben keine öffentliche Adresse. Diese Controls folgen LiteLLMs Security Best Practices.
- Logs haben eine Daten-Policy. Entscheide, ob Prompts und Antworten geloggt werden dürfen, redigiere sensible Felder vor dem Export, setze Retention, begrenze Zugriff und teste Löschung. Unser Guide zur PII-Redaktion vor LLM-Prompts behandelt diese Grenze.
- Health-Checks meinen verschiedene Dinge. LiteLLM dokumentiert unauthentifizierte Liveness- und Readiness-Endpunkte ohne Modellaufruf. Der authentifizierte Modell-Health-Endpunkt sendet dagegen echte Provider-Requests. Verdrahte Orchestrator-Probes und tiefere synthetische Checks nach dem Health-Check-Vertrag.
- Spend wird abgeglichen. Vergleiche LiteLLM-Zuordnung mit Provider-Rechnungen und teste Streaming, Retries, Cache-Hits und Fallback. Eine Dashboard-Schätzung hilft, Finance braucht aber einen Abgleichspfad.
- Ein Owner kann schnell patchen. Abonniere Security Advisories, definiere ein Patch-SLA, pflege eine Staging-Smoke-Suite und dokumentiere Credential-Rotation nach einem vermuteten Angriff.
Wie viel Arbeit verlangt selbst gehostetes LiteLLM?
Es gibt keinen ehrlichen Universalpreis, weil das Gateway Deine Cloud, Verfügbarkeitsziele, Identity-Plattform und Compliance übernimmt. Die folgenden Werte sind Wavect-Planungsgrößen fürs Scoping, keine LiteLLM-Angebote oder Versprechen zu Cloud-Preisen.
| Deployment-Level | Typischer Engineering-Aufwand | Enthalten |
|---|---|---|
| Privates Staging-Gateway | 1 bis 3 Engineering-Tage | Gepinnter Container, zwei Provider, Config, ein Virtual Key, Basis-Logs und Smoke-Tests |
| Single-Region-Production-Basis | 1 bis 3 Engineering-Wochen | Replikas, TLS, Managed Postgres und Redis, Secret Store, Budgets, Metriken, Backups, Canary-Rollout und Runbook |
| Regulierte oder Multi-Team-Plattform | 4 bis 10 Engineering-Wochen | Identity-Integration, Tenant-Policy, Audit-Evidenz, Datenschutz, Disaster Recovery, Lasttests und Support-Übergabe |
| Laufender Betrieb | Benannte monatliche Kapazität plus On-call | Patches, Provider-Änderungen, Cost-Map-Prüfung, Incident Response, Access Reviews und Restore-Übungen |
Bei moderatem Traffic entscheidet selten die Infrastrukturrechnung. Ownership entscheidet. Wenn niemand Patch- und Recovery-Pflicht übernehmen kann, ist ein Managed Gateway günstiger, selbst wenn die Rechnung höher ist. Betreibt ein Plattformteam bereits Kubernetes, Postgres, Redis, Secrets und Observability, kann LiteLLM in bestehende Controls passen.
Solltest Du LiteLLM selbst hosten oder ein Managed Gateway kaufen?
Hoste LiteLLM selbst, wenn Kontrolle eine Anforderung und Betrieb eine vorhandene Fähigkeit ist. Kaufe ein Managed Gateway, wenn Speed, Support und weniger Rufbereitschaft mehr wert sind als Infrastrukturkontrolle. Bleibe für einen engen Prototyp, der noch kein Gateway verdient, beim direkten Provider-Zugriff.
Ein brauchbarer Beschaffungstest kalkuliert ein Jahr, nicht einen Container. Nimm Design, Implementierung, Datenbank und Redis, Monitoring, Backups, Updates, Security Review, On-call und eine Provider-Migration auf. Vergleiche diese Summe mit der Managed-Option und den Kosten des Nichtstuns. Für die Optimierung nach dem Gateway hilft unser Playbook zur Reduktion von LLM-Token-Kosten.
Häufige Fragen
Ist LiteLLM beim Self-Hosting kostenlos?
Bleiben Prompts beim selbst gehosteten LiteLLM auf meinen Servern?
Kann LiteLLM ohne Kubernetes in Docker laufen?
Braucht LiteLLM Postgres und Redis?
Welche LiteLLM-Version sollte ich deployen?
Wann sollte ich eine Managed-Alternative wählen?
Fazit
Selbst gehostetes LiteLLM ist ein kleiner Service mit großem Blast Radius. Der Container ist leicht. Production ist die Disziplin darum herum: privates Netz, exakt gepinnte signierte Releases, begrenzte Keys, Postgres, Redis, Metriken, Backups, Fehlerübungen und ein Owner, der schnell patchen kann.
Nutze LiteLLM, wenn ein kontrolliertes Gateway mehrere Produkte und Provider vereinfacht. Behandle Modell-Inferenz als eigene Architekturentscheidung. Wenn Dein Team das Gateway nicht durch einen Incident und Restore tragen kann, kaufe den Betrieb als Managed Service. Wenn es das kann, starte mit einem engen Staging-Vertrag, beweise Resilienz und erweitere nur aus Evidenz.
