Docker Compose ports: Was jede Zeile wirklich öffnet
Was öffnet "8080:80" in der compose.yaml wirklich? Alle Formen von ports und expose, mit IPv6, 127.0.0.1, UDP und Bereichen. Und warum UFW davon nichts sieht.
Was ein ports-Eintrag in Docker Compose öffnet
Ein ports:-Eintrag in Docker Compose ohne Host-IP, etwa "8080:80", öffnet den Port auf allen Adressen des Servers, also auf IPv4 und auf IPv6. Auf einem VPS mit öffentlicher Adresse ist der Dienst damit aus dem Internet erreichbar, und UFW hält ihn nicht auf. Nur eine Host-IP wie 127.0.0.1 vor dem Port beschränkt ihn auf den Server selbst. expose: öffnet dagegen gar nichts nach außen.
Für jede Zeile gibt es drei Fragen. Erstens: Kommt jemand aus dem Internet an den Dienst? Zweitens: Kommt ein Programm auf dem Server selbst an ihn, zum Beispiel ein Reverse Proxy außerhalb von Docker oder Ihr eigenes curl? Drittens: Kommen andere Container im selben Compose-Netz an ihn? Die Antworten hängen von zwei Dingen ab: von der Host-IP in der Zeile und davon, ob überhaupt ein Host-Port veröffentlicht wird.
Zwei Begriffe brauchen Sie dafür. Der Container-Port ist der Port, auf dem das Programm im Container lauscht, bei nginx meist 80. Der Host-Port ist der Port auf dem Server, den Docker auf den Container-Port weiterleitet. In "8080:80" steht links der Host-Port und rechts der Container-Port. Was ein Port grundsätzlich ist, erklärt der Überblick über Ports unter Linux.
Die Grammatik der Kurzform
Die Compose-Referenz beschreibt die Kurzform als [HOST:]CONTAINER[/PROTOCOL]. HOST ist [IP:](port | range) und darf fehlen. Fehlt die IP, bindet Docker an alle Netzwerkschnittstellen (0.0.0.0). CONTAINER ist ein Port oder ein Bereich. PROTOCOL ist tcp oder udp und ist ohne Angabe tcp.
Die Docker-Doku zur Port-Veröffentlichung ist bei IPv6 genauer. Ohne Host-IP veröffentlicht Docker auf allen Host-Adressen, also auf 0.0.0.0 und auf [::]. Die Compose-Referenz trägt dazu eine Warnung: Ohne Host-IP bindet Docker an alle Schnittstellen und umgeht dabei die Firewall-Regeln des Hosts. Hat der Host eine öffentliche IP, kann der Container so direkt aus dem Internet erreichbar sein.
Als Beispiel dient dieser Dienst. Die folgenden Abschnitte tauschen nur die ports:-Zeile aus.
services:
web:
image: nginx:1.29-alpine
ports:
- "8080:80"Jede Form und wer sie erreicht
"8080:80"
- Internet: ja, auf Port 8080, über IPv4 und IPv6, sofern der Server eine öffentliche IPv6-Adresse hat.
- Server selbst: ja, über
localhost:8080und über jede Adresse des Servers. - Andere Dienste im Compose-Netz: ja, über
web:80, also über den Container-Port.
Diese Form ist richtig, wenn der Dienst öffentlich sein soll. Für eine Datenbank, eine Admin-Oberfläche oder eine App hinter einem Reverse Proxy ist sie falsch.
"127.0.0.1:8080:80"
- Internet: nein.
- Server selbst: ja, über
127.0.0.1:8080. - Andere Dienste im Compose-Netz: ja, über
web:80. Die Host-IP betrifft nur den Host-Port.
Die Docker-Doku sagt es so: Mit der localhost-Adresse im Publish-Eintrag kann nur der Docker-Host den veröffentlichten Port erreichen. Diese Zeile bindet nur die IPv4-Loopback-Adresse. Das ist die richtige Form für alles, was nur ein Programm auf dem Server selbst ansprechen soll, zum Beispiel ein nginx oder Caddy, der direkt auf dem Host läuft. Eine wichtige Bedingung steht im Abschnitt über die Engine-Version weiter unten.
"[::1]:8080:80"
- Internet: nein.
- Server selbst: ja, über
[::1]:8080. - Andere Dienste im Compose-Netz: ja, über
web:80.
::1 ist die IPv6-Loopback-Adresse. Die Compose-Referenz zeigt zwei Schreibweisen, "::1:6000:6000" und "[::1]:6001:6001". Nehmen Sie die Form mit eckigen Klammern. Sie ist eindeutig lesbar, und die Docker-Doku verwendet sie auch bei docker run. Soll der Dienst lokal über IPv4 und IPv6 erreichbar sein, schreiben Sie zwei Zeilen, so wie das Beispiel in der Docker-Doku:
ports:
- "127.0.0.1:8080:80"
- "[::1]:8080:80""51820:51820/udp" wie bei wg-easy
- Internet: ja, auf UDP-Port 51820, über IPv4 und IPv6.
- Server selbst: ja.
- Andere Dienste im Compose-Netz: ja, über UDP 51820 des Containers.
Das Suffix /udp ändert nur das Protokoll. Die Host-IP fehlt, also gilt wieder: alle Adressen. Die docker-compose.yml von wg-easy (Image ghcr.io/wg-easy/wg-easy:15) enthält genau diese Zeile und dazu eine zweite:
ports:
- "51820:51820/udp"
- "51821:51821/tcp"Port 51820/udp ist der WireGuard-Tunnel. Er muss öffentlich sein, sonst verbindet sich kein Client. Port 51821/tcp ist die Web-Oberfläche. Auch sie hat keine Host-IP und ist damit aus dem Internet erreichbar. Die Installationsanleitung von wg-easy nennt für die Firewall nur UDP 51820. Wer die Oberfläche nicht öffentlich zeigen will, ändert die zweite Zeile auf "127.0.0.1:51821:51821/tcp" und stellt einen Reverse Proxy mit TLS (Transport Layer Security) davor. Eine Regel in UFW reicht dafür nicht. Den Grund erklärt der Abschnitt über UFW.
"6881-6889:6881-6889"
- Internet: ja, alle neun Ports von 6881 bis 6889, nur TCP.
- Server selbst: ja.
- Andere Dienste im Compose-Netz: ja, über dieselben Container-Ports.
Ein Bereich veröffentlicht jeden Port darin. Die Compose-Referenz verlangt, dass HOST und CONTAINER gleichwertige Bereiche nutzen. Ohne Suffix gilt tcp. Braucht die Anwendung denselben Bereich auch für UDP, schreiben Sie eine zweite Zeile mit /udp. Eine Host-IP davor schränkt auch einen Bereich ein. Die Referenz zeigt dafür "127.0.0.1:5000-5010:5000-5010".
Die lange Syntax
ports:
- name: web
target: 80
published: "8080"
host_ip: 127.0.0.1
protocol: tcpDie lange Form sagt dasselbe wie "127.0.0.1:8080:80", nur mit einem Namen für jedes Feld. target ist der Container-Port. published ist der Host-Port. Die Referenz definiert ihn als String, und er darf ein Bereich start-end sein. host_ip ist die Host-Adresse. Fehlt sie, bindet Docker an alle Schnittstellen, genau wie in der Kurzform. protocol ist tcp oder udp, Standard ist tcp. name ist ein lesbarer Name, der nur dokumentiert, wofür der Port da ist. Dazu kommt app_protocol, das laut Referenz mit Docker Compose 2.26.0 eingeführt wurde.
Das Feld mode mit den Werten host und ingress beschreibt die Docker-Referenz in Begriffen von Swarm: host veröffentlicht den Port auf jedem Knoten im Swarm, ingress verteilt die Last über die Knoten. Der Standard ist ingress. Für die Frage, wer den Port erreicht, ist host_ip das Feld, auf das es ankommt.
expose
- Internet: nein.
- Server selbst: kein Host-Port. Docker veröffentlicht nichts.
- Andere Dienste im Compose-Netz: ja, und zwar auf jedem Port, auf dem der Container lauscht, nicht nur auf dem gelisteten.
Die Syntax ist <portnum>/[<proto>] oder ein Bereich, zum Beispiel "3000" oder "8080-8085/tcp". Mehr dazu steht im Abschnitt über expose weiter unten.
Gar kein Eintrag
- Internet: nein.
- Server selbst: kein Host-Port. Laut Docker-Doku erreicht der Docker-Host die Ports von Containern in Bridge-Netzen trotzdem, und zwar über die IP-Adresse des Containers.
- Andere Dienste im Compose-Netz: ja, auf jedem lauschenden Port.
Für eine Datenbank, die nur die App im selben Compose-Projekt braucht, ist das die richtige Wahl. Sie brauchen dafür weder ports: noch expose:.
Warum der Port auch über IPv6 offen ist
Viele Admins rechnen nicht mit IPv6, weil sie in Docker nie IPv6 aktiviert haben. Der Port ist trotzdem offen. Die Docker-Doku beschreibt den Fall genau: Ports auf den IPv6-Adressen des Hosts werden auf die IPv4-Adresse des Containers abgebildet, wenn in der Port-Zuordnung keine Host-IP steht, das Bridge-Netz nur IPv4 kennt und --userland-proxy=true gilt. Das ist der Standard. Ein VPS mit einer öffentlichen IPv6-Adresse nimmt also Verbindungen auf [2001:db8::10]:8080 an, auch wenn der Container selbst nur IPv4 hat.
Soll ein öffentlicher Port nur über IPv4 erreichbar sein, muss die Adresse in der Zeile stehen. Die Docker-Doku nennt dafür 0.0.0.0:8080:80 als Beispiel. In Compose heißt das "0.0.0.0:8080:80".
Warum UFW den veröffentlichten Port nicht sperrt
Die Docker-Doku zu Firewalls sagt es deutlich. Docker leitet Container-Verkehr in der nat-Tabelle um. Die Pakete werden also umgeleitet, bevor sie die Ketten INPUT und OUTPUT erreichen, die UFW benutzt. Die Regeln von UFW werden für veröffentlichte Ports damit praktisch ignoriert. Ein ufw deny 8080 ändert an "8080:80" nichts.
Was das im Detail bedeutet und welche Wege es gibt, beschreibt warum Docker-Ports an UFW vorbeigehen. Wie UFW selbst mit IPv6 umgeht, steht in offene IPv6-Ports trotz UFW auf dem VPS. Die sauberste Lösung bleibt dieselbe: Was nicht öffentlich sein soll, bekommt 127.0.0.1 in die Zeile oder gar keinen Host-Port.
Wer firewalld statt UFW nutzt, sollte die Engine-Version prüfen. Docker 28.3.3 vom 29. Juli 2025 behebt einen Fehler, bei dem veröffentlichte Container-Ports nach einem Neuladen von firewalld direkt erreichbar waren (CVE-2025-54388). Die Grundlagen dazu stehen in firewalld auf einem VPS einrichten.
Ist 127.0.0.1 sicher? Die Engine-Version entscheidet
Bis Docker Engine 28.0.0 hatte 127.0.0.1 eine Lücke. In älteren Versionen konnten Rechner im selben Layer-2-Segment, also zum Beispiel am selben Switch, Ports erreichen, die nur an localhost veröffentlicht waren. Docker 28.0.0 erschien am 19. Februar 2025. Die Release Notes führen unter „Port publishing in bridge networks“ den Fix „Fix a security issue that was allowing neighbor hosts to connect to ports mapped on a loopback address.“ Auf einem VPS können die Nachbarn im Layer-2-Segment andere Server im Rechenzentrum sein. Mit einer alten Engine schützt 127.0.0.1 Sie also nicht vollständig.
Prüfen Sie die Version auf Ihrem Server:
docker versionUnter Server steht bei Engine die Version. Alles ab 28.0.0 enthält den Fix. Woher Ihre Engine kommt, zeigt apt:
apt policy docker-ce docker.ioStand 21. November 2026 liefert Ubuntu im Paket docker.io für amd64 die Engine 29.1.3, auf 24.04 als 29.1.3-0ubuntu3~24.04.2 und auf 26.04 als 29.1.3-0ubuntu4.1. Beide sind neuer als 28.0.0. Docker selbst bietet in seinem apt-Repository für beide Releases 29.10.0 an, veröffentlicht am 16. November 2026. Docker schreibt seine Versionen mit einer Epoche davor, etwa 5:29.10.0-1~ubuntu.24.04~noble. Vergleichen Sie die Zahl nach 5:. Die Paketseite von Ubuntu 24.04 listet für andere Architekturen wie arm64 noch die Version 24.0.7. Die ist älter als 28.0.0. Auf einem ARM-VPS ist docker version deshalb Pflicht. Installieren Sie außerdem nicht beide Pakete. Docker warnt, dass die Pakete der Distribution inoffiziell sind und mit den offiziellen Paketen in Konflikt geraten können.
Eine Variable müssen Sie kennen, damit Sie sie nie setzen: DOCKER_INSECURE_NO_IPTABLES_RAW=1. Sie kam mit 28.0.2 und ist für Systeme gedacht, deren Kernel die raw-Tabelle von iptables nicht unterstützt. Mit ihr legt Docker keine Regeln in der raw-Tabelle an. Die Release Notes warnen selbst: Andere Rechner im lokalen Netz können dann Ports erreichen, die an Host-Adressen veröffentlicht sind, auch an 127.0.0.1. Die Variable öffnet also genau die Lücke wieder, die 28.0.0 geschlossen hat. Suchen Sie in Ihren systemd-Overrides und Umgebungsdateien danach:
sudo grep -rs DOCKER_INSECURE_NO_IPTABLES_RAW /etc/systemd /etc/defaultKeine Ausgabe ist das gewünschte Ergebnis.
Was expose wirklich tut, und wo es doch zählt
expose: veröffentlicht nichts. Das gilt auch für die Anweisung EXPOSE im Dockerfile. Die Dockerfile-Referenz sagt dazu: „The EXPOSE instruction doesn't actually publish the port.“ Die Anweisung ist Dokumentation zwischen dem, der das Image baut, und dem, der den Container startet. Container im selben benutzerdefinierten Bridge-Netz erreichen sich gegenseitig auf allen Ports, ob ein Port gelistet ist oder nicht. Ein Dienst ruft einen anderen über den Container-Port an. Der Host-Port spielt nur von außerhalb des Netzes eine Rolle. Wie Compose die Netze anlegt und wie die Namensauflösung der Dienste funktioniert, erklärt wie Docker-Compose-Netze funktionieren.
An einer Stelle zählen die exponierten Ports doch: bei Traefik. Traefik liest die private IP-Adresse und die Ports eines Containers über die Docker-API und wählt daraus den Port, an den es Anfragen weiterleitet. Die Doku von Traefik v3.7 sagt im Routing-Teil: „By default, Traefik uses the first exposed port of a container.“ Die Provider-Referenz derselben Version formuliert es anders: Exponiert ein Container mehrere Ports, nimmt Traefik den niedrigsten. In einem Punkt sind sich beide Seiten einig. Bei mehreren Ports wählt Traefik selbst, und das kann der falsche Port sein. Die Doku nennt als Folge einen HTTP/502-Fehler. Setzen Sie bei Images mit mehreren Ports deshalb immer das Label:
services:
app:
# image und übrige Einstellungen wie gehabt
labels:
- "traefik.enable=true"
- "traefik.http.routers.app.rule=Host(`app.example.de`)"
- "traefik.http.services.app.loadbalancer.server.port=8080"Traefik spricht den Container über das gemeinsame Netz und den Container-Port an. Deshalb braucht der App-Dienst für Traefik keinen eigenen ports:-Eintrag. Nur Traefik selbst veröffentlicht 80 und 443. Ein vollständiges Setup zeigt Traefik als Reverse Proxy für mehrere Apps mit Docker Compose.
Warum Docker Anführungszeichen empfiehlt
Die Compose-Referenz empfiehlt, HOST:CONTAINER immer als String in Anführungszeichen zu schreiben. Der Grund ist YAML: Ohne Anführungszeichen kann ein YAML-Parser einen Wert mit Doppelpunkt als Zahl im Sechzigersystem (Basis 60) lesen statt als Text. Alle Beispiele der Referenz stehen deshalb in Anführungszeichen. Schreiben Sie - "8080:80" und nie - 8080:80. Dann müssen Sie nicht darüber nachdenken, welche Werte der Parser falsch liest.
Lokal als Standard für ein ganzes Compose-Projekt
Wenn in einem Projekt fast nichts öffentlich sein soll, können Sie die Standardadresse für das Netz ändern. Docker dokumentiert dafür die Treiber-Option com.docker.network.bridge.host_binding_ipv4. Sie gilt für benutzerdefinierte Bridge-Netze und wird beim Anlegen des Netzes gesetzt. Trotz des Namens akzeptiert sie laut Doku auch eine IPv6-Adresse. In Compose sieht das so aus:
networks:
default:
driver_opts:
com.docker.network.bridge.host_binding_ipv4: "127.0.0.1"Die Option wirkt nur beim Anlegen des Netzes. Entfernen Sie das bestehende Netz deshalb einmal mit docker compose down und starten Sie das Projekt danach mit docker compose up -d neu. Prüfen Sie anschließend mit ss, wie im nächsten Abschnitt beschrieben, an welche Adressen die Ports wirklich gebunden sind. Achten Sie dabei besonders auf IPv6. Die Daemon-Option --ip hilft Compose-Projekten nicht: Sie gilt laut dockerd-Referenz nur für das Standard-Bridge-Netz, und Compose legt eigene Netze an.
So prüfen Sie, welche Ports wirklich offen sind
Lesen Sie nicht nur die compose.yaml. Mehrere Dateien, Variablen und .env verändern, was am Ende gilt. Der erste Befehl zeigt das Modell, das Compose wirklich anwendet:
docker compose configLaut Referenz führt der Befehl die Compose-Dateien zusammen, löst Variablen auf und erweitert die Kurzform in die kanonische Form. Suchen Sie im Abschnitt ports jedes Dienstes nach host_ip. Fehlt das Feld, ist der Port auf allen Adressen offen.
Der zweite Befehl fragt Docker nach den tatsächlichen Zuordnungen:
docker compose port web 80
docker port <container-name>docker compose port druckt die Host-Adresse für einen Container-Port eines Dienstes. docker port listet alle Zuordnungen eines Containers, eine pro Zeile, in der Form 80/tcp -> <host-ip>:<host-port>. Steht dort 0.0.0.0 oder [::], ist der Port auf allen Adressen offen. Steht dort 127.0.0.1, ist er lokal.
Der dritte Befehl fragt den Kernel, wer auf welchem Socket lauscht:
sudo ss -tlnp
sudo ss -ulnp-t zeigt TCP-Sockets, -u UDP-Sockets, -l nur lauschende Sockets, -n verzichtet auf die Auflösung von Dienstnamen und -p zeigt die Prozesse dazu. Achten Sie in der Spalte für die lokale Adresse auf 0.0.0.0 und [::] gegenüber 127.0.0.1 und [::1].
Den letzten Beweis liefert ein Test von außen, von einem anderen Rechner, einmal über IPv4 und einmal über IPv6. Wie Sie das zuverlässig machen, zeigt prüfen, ob ein Port unter Linux offen ist. Bekommen Sie dabei keine Antwort, hilft der Unterschied zwischen connection refused und timed out bei der Deutung.
Wenn der Host-Port schon belegt ist
Hat Docker den Host-Port schon an einen anderen Container vergeben, scheitert der Start. Die Meldung kommt aus dem Port-Allocator der Engine und hat diese Form:
Bind for 0.0.0.0:8080 failed: port is already allocatedDie Adresse in der Meldung ist die Host-IP der Zeile, also 0.0.0.0 oder :: bei einer Zeile ohne Host-IP. Suchen Sie mit docker ps den Container, der den Port schon hält, und wählen Sie einen anderen Host-Port. Der Container-Port darf gleich bleiben. Hält ein Programm außerhalb von Docker den Port, sieht die Meldung anders aus. Lesen Sie den Wortlaut genau und prüfen Sie mit sudo ss -tlnp, welcher Prozess auf dem Port lauscht.
ports und network_mode: host
Mit network_mode: host teilt der Container das Netz des Servers. Jeder Port, auf dem das Programm lauscht, liegt dann direkt auf den Adressen des Servers. Ein ports:-Eintrag hat dort keinen Sinn. Die Compose-Referenz sagt, dass Port-Zuordnungen nicht mit network_mode: host kombiniert werden dürfen, weil das einen Laufzeitfehler auslöst. Für docker run beschreibt die Docker-Doku dagegen, dass die Publish-Optionen ignoriert werden, mit dieser Warnung:
WARNING: Published ports are discarded when using host network modeWer network_mode: host nutzt, muss die Adresse also im Programm selbst festlegen, zum Beispiel in dessen eigener Konfiguration mit der Listen-Adresse 127.0.0.1.
FAQ
Ist ein Docker-Port ohne 127.0.0.1 aus dem Internet erreichbar?
Ja. Ohne Host-IP veröffentlicht Docker den Port auf allen Adressen des Servers, 0.0.0.0 und [::]. Hat der VPS eine öffentliche IPv4- und IPv6-Adresse, ist der Dienst über beide erreichbar. UFW blockiert ihn nicht, weil Docker die Pakete in der nat-Tabelle umleitet, bevor die Ketten von UFW greifen. Schreiben Sie "127.0.0.1:8080:80", wenn nur der Server selbst zugreifen soll.
Was ist der Unterschied zwischen ports und expose in Docker Compose?
ports: veröffentlicht einen Host-Port und macht den Container von außerhalb des Docker-Netzes erreichbar. expose: veröffentlicht nichts. Es dokumentiert nur Ports, und Werkzeuge wie Traefik lesen diese Angabe. Container im selben Compose-Netz erreichen sich ohnehin auf allen lauschenden Ports, mit oder ohne expose:.
Brauche ich ports, wenn die App hinter Traefik im selben Compose-Netz läuft?
Nein. Traefik spricht die App über das gemeinsame Docker-Netz und den Container-Port an. Nur Traefik veröffentlicht 80 und 443. Hat das Image mehrere Ports, setzen Sie das Label traefik.http.services.<name>.loadbalancer.server.port. Sonst wählt Traefik den Port selbst und trifft womöglich den falschen.
Schützt 127.0.0.1 auch vor anderen Servern im Rechenzentrum?
Ab Docker Engine 28.0.0 ja. In älteren Versionen konnten Rechner im selben Layer-2-Segment Ports erreichen, die nur an localhost veröffentlicht waren. Prüfen Sie die Version mit docker version. Setzen Sie außerdem nie DOCKER_INSECURE_NO_IPTABLES_RAW=1, denn diese Variable öffnet die Lücke laut den Release Notes von Docker wieder.
Warum stehen Port-Angaben in Anführungszeichen?
Die Compose-Referenz empfiehlt, HOST:CONTAINER immer als String in Anführungszeichen zu schreiben. Ohne Anführungszeichen kann YAML einen Wert mit Doppelpunkt als Zahl im Sechzigersystem lesen. Mit - "8080:80" liest Compose den Wert immer als Text.