SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

Container erreicht den Docker-Host nicht?

host.docker.internal löst nicht auf, Verbindung abgelehnt oder Timeout? So finden Sie die Ursache und lassen Open WebUI sicher auf Ollama am Host zugreifen.

Warum der Container den Docker-Host nicht erreicht

Ein Container erreicht den Docker-Host unter Linux nur, wenn drei Dinge zusammenpassen. Der Name muss auflösen. Der Dienst muss auf einer Adresse lauschen, die der Container erreicht. Und die Firewall muss das Paket durchlassen. Docker Desktop auf Mac und Windows stellt den Namen für Sie bereit. Docker Engine auf einem Linux-VPS tut das nicht. Um Bind-Adresse und Firewall kümmern Sie sich auf beiden Systemen selbst.

Das typische Szenario: Open WebUI, n8n oder ein Reverse Proxy läuft in Docker Compose. Der Dienst, den der Container braucht, läuft direkt auf dem Host. Das kann Ollama auf Port 11434 sein, eine PostgreSQL-Datenbank oder eine eigene API. Viele betreiben Ollama bewusst auf dem eigenen VPS, damit Prompts und Dokumente den Server nicht verlassen. Genau dieser Fall ist hier das durchgehende Beispiel.

Prüfen Sie die drei Ursachen in dieser Reihenfolge. Die Fehlermeldungen grenzen die Suche ein, ordnen den Fehler aber nicht immer eindeutig einer Ursache zu.

Welche Fehlermeldung zeigt welche Ursache?

Testen Sie die Verbindung nicht mit Ihrer Anwendung. Nehmen Sie einen kleinen Wegwerf-Container im selben Compose-Netzwerk. Compose legt dieses Netzwerk unter dem Namen <projektname>_default an. Der Projektname ist standardmäßig der Name des Verzeichnisses. docker network ls zeigt ihn.

docker network ls
docker run --rm --network openwebui_default \
  --add-host host.docker.internal=host-gateway \
  curlimages/curl -sS --max-time 5 http://host.docker.internal:11434/

Ersetzen Sie openwebui_default durch Ihren Netzwerknamen. Es gibt vier mögliche Ergebnisse:

  • Ollama is running: Der Weg zum Host funktioniert. Das Problem liegt dann in der Konfiguration Ihrer Anwendung.
  • curl: (6) Could not resolve host: host.docker.internal: Der Name konnte nicht aufgelöst werden. Das ist Ursache 1.
  • curl: (7) Failed to connect to host.docker.internal port 11434, und zwar sofort, ohne Wartezeit: Der Verbindungsaufbau ist gescheitert. Je nach curl-Version folgt Connection refused oder Couldn't connect to server. Prüfen Sie Ursache 2 und 3: Auch eine Firewall kann die Verbindung sofort ablehnen.
  • curl: (28) mit timed out nach fünf Sekunden: Das Zeitlimit ist abgelaufen. Das passiert beim Verbindungsaufbau oder während einer laufenden Datenübertragung. Prüfen Sie die Firewall unter Ursache 3 und ob der Dienst rechtzeitig antwortet.

Die Unterscheidung zwischen „abgelehnt“ und „Zeitüberschreitung“ ist der wichtigste Hinweis in diesem Artikel. Bei „abgelehnt“ wurde der Verbindungsaufbau aktiv zurückgewiesen. Häufig wartet kein Programm auf dieser Adresse und diesem Port; auch eine Firewall kann die Verbindung zurückweisen. Eine Zeitüberschreitung belegt nur, dass das Zeitlimit abgelaufen ist, nicht, dass keine Antwort zurückkam. Eine Firewall, die Pakete still verwirft, erzeugt genau dieses Bild.

Ursache 1: host.docker.internal löst unter Linux nicht auf

Auf Mac und Windows stellt Docker den Namen host.docker.internal selbst bereit. Unter Linux mit Docker Engine müssen Sie ihn eintragen. Docker kennt dafür den Sonderwert host-gateway. In Compose sieht das so aus:

services:
  open-webui:
    extra_hosts:
      - "host.docker.internal:host-gateway"

Beim docker run heißt die Option --add-host host.docker.internal=host-gateway. Der Name host.docker.internal ist dabei nur eine Konvention. Docker schreibt den Eintrag in die Datei /etc/hosts im Container.

Wichtig ist, worauf host-gateway zeigt. Unter Linux löst der Wert standardmäßig zur IPv4-Adresse der Standard-Bridge auf. Das ist die Adresse der Schnittstelle docker0. Es ist nicht das Gateway Ihres Compose-Netzwerks. Diese Adresse brauchen Sie bei Ursache 2 und 3 noch einmal. Lesen Sie sie aus:

ip -4 addr show docker0

Häufig steht dort 172.17.0.1. Verlassen Sie sich nicht darauf, sondern nehmen Sie den Wert aus Ihrer Ausgabe. Wer eine andere Zieladresse braucht, legt sie in der Datei /etc/docker/daemon.json mit dem Schlüssel host-gateway-ips fest.

Braucht Docker Engine 29 den Eintrag noch?

Docker Engine 29.10.0 erschien am 16. November 2026. In den Release Notes zu 29.9.0 steht der Begriff „implicit host-gateway mapping“. Das klingt, als würde der Name jetzt von selbst auflösen. Der Eintrag ist aber eine Fehlerkorrektur. Container mit einem host-gateway-Mapping, die nach einem Neustart des Daemons wiederhergestellt wurden, ließen sich nicht mit weiteren Netzwerken verbinden. „Implicit“ meint dort die Adresse, die Docker für host-gateway aus der Standard-Bridge ableitet. Von einem automatischen host.docker.internal unter Linux steht dort nichts.

Prüfen Sie es auf Ihrer eigenen Engine, ohne den Eintrag:

docker version
docker run --rm alpine getent hosts host.docker.internal

Der erste Befehl zeigt unter Server die Version Ihrer Engine. Gibt der zweite Befehl nichts aus, kennt der Container den Namen nicht. Tragen Sie extra_hosts in jedem Fall ein. Dann funktioniert die Datei auch auf älteren Engines und nach einem Umzug auf einen anderen Server.

Ursache 2: Der Dienst lauscht nur auf 127.0.0.1

Ein Container hat einen eigenen Netzwerk-Namensraum. Seine Adresse 127.0.0.1 ist der Container selbst, nicht der Host. Wenn der Container host.docker.internal anspricht, schickt er das Paket an die Adresse von docker0 auf dem Host. Lauscht der Dienst nur auf 127.0.0.1, ist auf der docker0-Adresse kein Port offen. Der Kernel des Hosts lehnt die Verbindung deshalb ab, und curl meldet den Fehler 7.

Ollama lauscht standardmäßig genau so: auf 127.0.0.1, Port 11434. Prüfen Sie es auf dem Host:

sudo ss -ltnp | grep 11434

Steht in der Spalte für die lokale Adresse 127.0.0.1:11434, ist das Ihre Ursache. Für PostgreSQL oder eine eigene API gilt dasselbe Prinzip. Ersetzen Sie die Portnummer und suchen Sie in der Konfiguration des Dienstes die Listen- oder Bind-Adresse.

0.0.0.0 oder die Bridge-Adresse?

Sie haben zwei Wege. Beide haben einen Preis.

Bind an 0.0.0.0. Der Dienst lauscht dann auf allen Schnittstellen, also auch auf der öffentlichen IP Ihres VPS. Das rät die Fehlerseite von Open WebUI. Auf einem öffentlichen Server schützt Sie dann nur noch die Firewall. Ist ufw einmal deaktiviert oder eine Regel zu breit, ist Ollama offen im Internet. Ollama hat keine eigene Anmeldung. Warum das gefährlich ist, erklärt die Anleitung zur Absicherung der Ollama-API.

Bind an die Adresse von docker0. Der Dienst lauscht dann nur dort, wo Container ihn erreichen, und nicht auf der öffentlichen IP. Das ist unsere Empfehlung für einen VPS. Die Ollama-Dokumentation nennt diesen Weg nicht ausdrücklich. Er folgt aber daraus, wie OLLAMA_HOST funktioniert. Der Preis: Die Adresse muss existieren, wenn Ollama startet. Startet Ollama vor Docker, gibt es docker0 noch nicht, und der Bind schlägt fehl.

Ollama konfigurieren Sie unter systemd über ein Override:

sudo systemctl edit ollama.service

Tragen Sie im Editor Folgendes ein, mit Ihrer Adresse aus ip -4 addr show docker0:

[Unit]
After=docker.service

[Service]
Environment="OLLAMA_HOST=172.17.0.1:11434"

Danach laden Sie systemd neu und starten Ollama neu:

sudo systemctl daemon-reload
sudo systemctl restart ollama
sudo ss -ltnp | grep 11434

ss sollte jetzt 172.17.0.1:11434 zeigen. Die Zeile After=docker.service ordnet Ollama nach Docker ein, wenn beide Dienste gestartet werden; sie startet Docker nicht selbst. Prüfen Sie das nach dem nächsten Neustart des Servers mit systemctl status ollama. Prüfen Sie außerdem, ob ollama list auf dem Host noch antwortet. Antwortet der Befehl nicht, setzen Sie OLLAMA_HOST=172.17.0.1:11434 auch in Ihrer Shell. Die Variable im Override gilt nur für den Dienst.

Ursache 3: ufw blockiert den Weg vom Container zum Host

Nach der Installation hat ufw die Standardregel „eingehend verweigern“. Viele kennen den umgekehrten Fall: Ports, die Docker mit ports: veröffentlicht, umgehen ufw. Das passiert, weil Docker diese Pakete umleitet, bevor sie die INPUT-Kette erreichen, die ufw nutzt. Die Details stehen in warum veröffentlichte Docker-Ports ufw umgehen.

Der Weg vom Container zum Host ist ein anderer Fall. Das Ziel ist eine Adresse, die dem Host selbst gehört. Das Paket landet deshalb in der INPUT-Kette, und dort greift die Standardregel von ufw. Die Docker-Dokumentation beschreibt diesen Weg nicht. Behandeln Sie die folgenden Schritte deshalb als Test, den Sie selbst ausführen.

Die entscheidende Frage lautet: Welche Quelladresse hat das Paket? Ein Container im Compose-Netzwerk hat eine Adresse aus dem Subnetz dieses Netzwerks. Sie stammt nicht aus dem Subnetz von docker0. Eine Regel für das docker0-Subnetz passt deshalb oft nicht. Lesen Sie das Subnetz Ihres Compose-Netzwerks aus:

docker network inspect openwebui_default

Suchen Sie in der JSON-Ausgabe den Block IPAM, darin Config und dort Subnet. Schalten Sie dann das Logging von ufw ein und wiederholen Sie den curl-Test von oben:

sudo ufw logging on
sudo journalctl -k --since "5 minutes ago" | grep 'UFW BLOCK'

Eine blockierte Verbindung zeigt eine Zeile mit DPT=11434. Das Feld SRC= nennt die echte Quelladresse, DST= die Zieladresse und IN= die Schnittstelle, über die das Paket kam. Bei einem Compose-Netzwerk ist das eine Schnittstelle mit einem Namen wie br- plus Kennung, nicht docker0. Ihre Regel muss genau diese Quelle erlauben, und nur für diesen Port:

sudo ufw allow proto tcp from 172.18.0.0/16 to 172.17.0.1 port 11434 comment 'open-webui to ollama'
sudo ufw status numbered

Setzen Sie für 172.18.0.0/16 Ihr Subnetz aus docker network inspect ein und für 172.17.0.1 Ihre docker0-Adresse. Wiederholen Sie dann den curl-Test. Statt der Zeitüberschreitung sollte jetzt Ollama is running kommen. Eine falsche Regel entfernen Sie mit sudo ufw delete und der Nummer aus ufw status numbered. Mehr zu Standardregeln und Regelsyntax steht in den ufw-Grundlagen für einen VPS.

Komplettes Beispiel: Open WebUI in Compose, Ollama auf dem Host

Das Subnetz eines Compose-Netzwerks vergibt Docker beim Anlegen des Netzwerks. Wenn Sie es in der Compose-Datei festlegen, passt Ihre ufw-Regel immer. Wählen Sie ein Subnetz, das auf Ihrem Server noch nicht vorkommt. ip route zeigt die belegten Netze. Hier dient 172.28.0.0/24 als Beispiel.

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "127.0.0.1:3000:8080"
    environment:
      - OLLAMA_BASE_URL=http://host.docker.internal:11434
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - open-webui:/app/backend/data
    restart: unless-stopped

volumes:
  open-webui:

networks:
  default:
    ipam:
      config:
        - subnet: 172.28.0.0/24

Einige Zeilen brauchen eine Erklärung. OLLAMA_BASE_URL setzen Sie ausdrücklich, damit die Datei eindeutig ist. Ohne die Variable nutzt das offizielle Image ohne gebündeltes Ollama bereits http://host.docker.internal:11434. Der Standardwert http://localhost:11434 gilt nur außerhalb von Docker oder im Image mit gebündeltem Ollama. Der Port ist nur an 127.0.0.1 gebunden, weil veröffentlichte Ports ufw umgehen. Sie erreichen Open WebUI dann über einen SSH-Tunnel oder einen Reverse Proxy auf dem Host.

Die Registrierung neuer Konten ist in Open WebUI standardmäßig eingeschaltet (ENABLE_SIGNUP). Nach der Registrierung des ersten Kontos schaltet Open WebUI die Registrierung automatisch ab. Legen Sie Ihr Admin-Konto deshalb sofort nach dem ersten Start an. Machen Sie die Oberfläche erst danach über einen Reverse Proxy öffentlich.

Die passende ufw-Regel und der Start:

sudo ufw allow proto tcp from 172.28.0.0/24 to 172.17.0.1 port 11434 comment 'open-webui to ollama'
docker compose up -d
docker compose logs -f open-webui

Prüfen Sie zum Schluss den Weg aus dem Container heraus. Nutzen Sie dafür den Wegwerf-Container aus dem ersten Abschnitt mit dem Netzwerknamen Ihres Projekts. Wie Compose-Netzwerke, Dienstnamen und Subnetze zusammenspielen, erklärt die Übersicht zu Docker-Compose-Netzwerken.

Die Alternative: network_mode: host

Mit network_mode: host teilt der Container den Netzwerk-Stack des Hosts. Er hat keine eigene IP-Adresse. Für ihn ist 127.0.0.1 dann wirklich der Host. Ollama darf also auf 127.0.0.1 bleiben, und Sie brauchen weder extra_hosts noch eine ufw-Regel für den Weg zum Host. Die Fehlerseite von Open WebUI nennt diesen Weg mit OLLAMA_BASE_URL=http://127.0.0.1:11434.

Der Preis ist hoch. Alle Ports, auf denen der Container lauscht, liegen jetzt direkt auf den Schnittstellen des Hosts, bei Open WebUI also Port 8080. ports: wird ignoriert, und Docker gibt nur eine Warnung aus. Compose lehnt außerdem eine Datei ab, die network_mode und networks für denselben Dienst setzt. Der Container spricht dann nicht mehr über das Projektnetzwerk mit anderen Diensten. Ports können zudem mit Diensten auf dem Host kollidieren. Für einen einzelnen Container auf einem privaten Server ist das vertretbar. Für einen Stack aus mehreren Diensten ist der Weg über extra_hosts sauberer.

Eine Sonderform ist ein Container, der seinen Verkehr durch einen VPN-Container leitet. Dort gelten eigene Regeln für den Weg zum Host. Sie stehen in Host und andere Container hinter Gluetun erreichen.

FAQ

Warum meldet mein Container „Could not resolve host: host.docker.internal“?

Unter Linux legt Docker Engine diesen Namen nicht von selbst an. Docker Desktop auf Mac und Windows stellt ihn bereit. Tragen Sie in Compose extra_hosts: ["host.docker.internal:host-gateway"] ein, oder nutzen Sie beim docker run die Option --add-host host.docker.internal=host-gateway. Mit docker run --rm alpine getent hosts host.docker.internal prüfen Sie, ob Ihre Engine den Namen ohne Eintrag kennt.

Was bedeutet „Connection refused“ im Unterschied zu einer Zeitüberschreitung?

„Connection refused“ heißt: Der Verbindungsaufbau wurde aktiv zurückgewiesen. Häufig lauscht kein Programm auf dieser Adresse und diesem Port; auch eine Firewall kann die Verbindung zurückweisen. Meist lauscht der Dienst nur auf 127.0.0.1, was sudo ss -ltnp zeigt. Eine Zeitüberschreitung heißt: Das Zeitlimit ist abgelaufen, beim Verbindungsaufbau oder während der Datenübertragung. Eine Firewall wie ufw, die Pakete still verwirft, ist eine mögliche Ursache; auch ein langsam antwortender Dienst kommt infrage.

Soll ich Ollama auf 0.0.0.0 binden, damit Docker es erreicht?

Auf einem öffentlichen VPS ist das riskant. Ollama lauscht dann auch auf der öffentlichen IP und hat keine eigene Anmeldung. Binden Sie Ollama besser an die Adresse von docker0, zum Beispiel mit Environment="OLLAMA_HOST=172.17.0.1:11434" in einem systemd-Override. Erlauben Sie dann in ufw nur das Subnetz Ihres Compose-Netzwerks auf Port 11434.

Welches Subnetz muss in der ufw-Regel stehen?

Das Subnetz des Netzwerks, in dem der Container hängt, und nicht das Subnetz von docker0. Bei Compose ist das meist <projektname>_default. docker network inspect zeigt es unter IPAM, Config, Subnet. Wenn Sie unsicher sind, schalten Sie mit sudo ufw logging on das Logging ein und lesen das Feld SRC= in den Zeilen mit UFW BLOCK.

War dieser Artikel hilfreich?