Docker/Grundlagen/04 Portweiterleitung

Aus Foxwiki
Version vom 18. November 2026, 13:55 Uhr von Dirkwagner (Diskussion | Beiträge) (Textersetzung - „bzw. “ durch „oder “)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu:Navigation, Suche


Docker/Grundlagen/04 Portweiterleitung


Docker Portweiterleitung


Beschreibung

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:

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
Optionen
  • -d (detach) bedeutet, dass Docker den Container im Hintergrund ausführen soll
  • -p 80:80 verbindetPort 80 des Containers mit Port 80 des lokalen Rechners

Sicherheit

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
Achtung
-p hostport:containerport!
Siehe auch

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 oder grundlegende Programmiersprachen, Server oder sonstige Tools zur Verfügung stellen

Spielregeln

Offizielle Images müssen bestimmte Spielregeln einhalten, werden dafür aber innerhalb des Docker Hubs bevorzugt behandelt

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

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, dass der Container tatsächlich läuft:

docker ps
CONTAINER ID      IMAGE                              PORTS                   ...
6f3f1d532659      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

  • Ein Webserver Verfügung stellt

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/
  • Lesen Sie Docker/Eigene Images bevor Sie der Anleitung des getting-started-Beispiels folgen

Probleme

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 Host und 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
Rootless Docker

Eine zweite Fehlerursache kann darin bestehen, dass Sie unter Linux mit Rootless Docker arbeiten

  • Ohne root-Rechte kann Docker nicht über die »privilegierten« Ports kleiner als 1024 verfügen
  • Der Lösungsweg ist der gleiche: Verwenden einer 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

docker ps
CONTAINER ID        IMAGE                             ...    NAMES
3c8ac71262b8        docker / getting - started
nervous_williams
docker stop 3c8ac71262b8

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
Container löschen
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
Image 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