Docker/Grundlagen/04 Portweiterleitung: Unterschied zwischen den Versionen
K Textersetzung - „Docker/Buch/03 Grundlagen“ durch „Docker/Grundlagen“ |
K Dirkwagner verschob die Seite Docker/Buch/03 Grundlagen/04 Portweiterleitung nach Docker/Grundlagen/04 Portweiterleitung, ohne dabei eine Weiterleitung anzulegen: Textersetzung - „Docker/Buch/03 Grundlagen“ durch „Docker/Grundlagen“ |
||
(kein Unterschied)
| |||
Version vom 13. November 2026, 12:49 Uhr
Portweiterleitung
Neben dem schon vorgestellten hello-world-Image gibt es im Docker Hub ein weiteres Image, das für erste Experimente gedacht ist.
- macOS- und Windows-Anwender werden nach der Installation von Docker Desktop unmissverständlich darauf hingewiesen, dieses Beispiel auszuprobieren.
- Wenn Sie sich nach der Installation dagegen entschieden haben oder wenn Sie das Beispiel unter Linux ausprobieren möchten, sind Sie in diesem Abschnitt richtig!
Container-Ports mit lokalen Ports verbinden
getting-started ist im Vergleich zu den bisherigen Beispielen dieses Kapitels insofern spannend, als es einen weiteren Aspekt der Docker-Anwendung ins Spiel bringt: die Integration von Containern in das lokale Netzwerk.
- Bei getting-started handelt es sich um einen einfachen Webserver, dessen Container als Hintergrunddienst ausgeführt wird.
- Sofern Sie Port 80 des Containers mit einem freien Port Ihres Host-Rechners verbinden (Option -p), können Sie über einen Webbrowser die vom Webserver zur Verfügung gestellten HTML-Dokumente lesen.
- Die Inbetriebnahme erfolgt Docker-typisch mit einem unscheinbaren, kurzen Kommando:
docker run -d -p 80:80 docker / getting - started
Kurz eine Erklärung der Optionen: -d (detach) bedeutet, dass Docker den Container im Hintergrund ausführen soll.
- Aufgrund von -p 80:80 verbindet Docker Port 80 des Containers mit Port 80 des lokalen Rechners.
Obwohl das getting-started -Image viele Docker-spezifische Anweisungen enthält, eignet es sich prinzipiell auch für Podman.
- Das Kommando sieht dann wie folgt aus
(warum jetzt Port 8080 im Spiel ist, erklären wir Ihnen gleich):
podman run -d -p 8080:80 docker .
- io / docker / getting - started
Sicherheitsrisiko durch Ports
Durch -p geöffnete Ports können nicht nur auf dem lokalen Rechner genutzt werden, sondern sind auch nach außen hin sichtbar! In manchen Fällen kann dies ein Sicherheitsrisiko sein.
- Dieses vermeiden Sie, wenn Sie die Port-Weiterleitung explizit auf localhost beschränken, z. B. mit docker run -p 127.0.0.1:8080:80 .
https://docs.docker.com/network
Offizielle Images
Im Unterschied zu den bisherigen Beispielen reicht es bei diesem Beispiel nicht, als Image-Name einfach nur getting-started anzugeben.
- Diese Kurzschreibweise ist nur für »offizielle« Images vorgesehen, die Basis-Images bzw. grundlegende Programmiersprachen, Server oder sonstige Tools zur Verfügung stellen.
Offizielle Images müssen bestimmte Spielregeln einhalten, werden dafür aber innerhalb des Docker Hubs bevorzugt behandelt: https://docs.docker.com/docker-hub/official_images Bei allen anderen Images, die von Entwicklern oder Firmen über den Docker Hub bereitgestellt werden, muss dem Image-Namen der Firmen- oder Entwicklername vorangestellt werden – hier also docker/getting-started.
Nach einigen Statusmeldungen (in der Regel muss Docker das Image zuerst herunterladen) passiert – scheinbar – nichts.
- docker hat das Kommando ausgeführt, aber anders als bei den bisherigen Beispielen gibt es kein visuelles Feedback in der Konsole.
- docker ps beweist immerhin, dass der Container tatsächlich läuft:
docker ps
CONTAINE R ID IMAGE PORTS ... 6 f3f1d532 6 5 9 docker / getting - started 0.0.0.0:80 - >80/tcp
Die Spalte PORTS verrät, dass Port 80 des Containers mit Port 80 des Docker-Hosts (also Ihres Rechners!) verbunden ist.
- Um zu sehen, was auf Port 80 passiert, öffnen Sie auf Ihrem Webbrowser die Adresse localhost. (Unter Umständen müssen Sie http://localhost eingeben, damit der Browser Ihre Eingabe nicht als Suchaufforderung versteht.) Damit kommen Sie auf eine Website, die der von Docker ausgeführte Container – genau genommen ein Webserver – zur Verfügung stellt (siehe Abbildung 3.1).
Die Website besteht aus einer ganzen Palette von Seiten, die durch ein weiteres Beispiel für die Anwendung von Docker führen.
- Dabei geht es um die Inbetriebnahme eines weiteren Containers auf der Basis eines zuvor lokal erstellten Images.
- Dieses heißt – ein wenig verwirrend – ebenfalls getting-started , wenn auch ohne vorangestelltes docker/.
- Wir empfehlen Ihnen, zuerst Kapitel 4, »Eigene Images«, zu lesen, bevor Sie der Anleitung des getting-started-Beispiels folgen.
Abbildung 3.1 Die »getting-started«-App im Webbrowser
Probleme mit Port 80
Nicht in jedem Fall führt das vorhin angegebene Kommando docker run zum Erfolg. Eine mögliche Fehlerursache kann darin bestehen, dass Port 80 schon belegt ist, weil auf Ihrem Rechner bereits ein Webserver aktiv ist.
- Gerade auf Entwicklungsrechnern ist das nicht ungewöhnlich.
- In diesem Fall verändern Sie die Optionen von docker run ein wenig und geben eben einen anderen Zielport an (hier 8080).
Beachten Sie die Syntax -p hostport:containerport ! Die erste Portnummer bezieht sich also auf den Host (auf Ihren Computer), die zweite auf den Container.
- Die Reihenfolge widerspricht der Quelle-Ziel-Logik der meisten Linux-Kommandos.
- Grundsätzlich gilt bei allen Docker-Optionen, die eine Zuordnung zwischen Host und Container festlegen (Ports, Volumes etc.), dass zuerst die Hostund dann die Container-Daten angegeben werden.
docker run -d -p 8080:80 docker / getting - started
Wenn das klappt, dann müssen Sie nun Port 8080 auch in der Adresse verwenden, die Sie in Ihrem Webbrowser angeben – also http://localhost:8080. Eine zweite Fehlerursache kann darin bestehen, dass Sie unter Linux mit Rootless Docker oder mit Podman arbeiten.
- Ohne root-Rechte kann Docker nicht über die
»privilegierten« Ports kleiner als 1024 verfügen.
- Der Lösungsweg ist der gleiche wie vorhin – Sie verwenden eben eine Portnummer, die größer ist als 1024 – z. B. 8080.
(Jede Zahl zwischen 1024 und 65535 funktioniert, sofern der Port nicht schon für eine andere Funktion reserviert ist.)
Aufräumen
Der getting-started-Container läuft im Hintergrund weiter, bis Sie ihn explizit beenden oder Ihren Rechner neu starten. (Wenn Sie mit Rootless Docker arbeiten, führt auch ein Logout dazu, dass die Container-Ausführung gestoppt wird.) Um die Container-Ausführung zu beenden, ermitteln Sie zuerst mit ps seinen Namen oder seine ID.
- In der Folge stoppen Sie den Container:
docker ps
CONTAINE R ID IMAGE ... NAMES 3 c8ac7126 2 b 8 docker / getting - started nervous_w i l l i am s
docker stop 3 c8ac71262 b 8
Wenn Sie denselben Container später noch einmal starten möchten, führen Sie entsprechend docker start <id> oder <name> aus.
- Die ID können Sie bei Bedarf mit docker ps -a ermitteln.
- Mit der Option -a listet docker ps alle Container auf, auch die, die gerade nicht ausgeführt werden.
docker rm <id> löscht den Container.
- Das funktioniert nur, wenn er nicht läuft.
- Gegebenenfalls führen Sie vorher docker stop aus oder übergeben docker rm die Option -f
(force), um den Container sowohl zu stoppen als auch zu löschen. Das Image löschen Sie mit docker image rm docker/getting-started.
- Das ist wiederum nur möglich, nachdem Sie vorher alle davon abgeleiteten Container gelöscht haben.