Docker/Grundlagen/04 Portweiterleitung: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
K Textersetzung - „bzw. “ durch „oder “
 
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
<noinclude>
----
{{Navigation|Docker/Grundlagen/03 Containerinteraktion|Docker/Grundlagen/05_Volumes}}
----
'''Docker/Grundlagen/04 Portweiterleitung'''
'''Docker/Grundlagen/04 Portweiterleitung'''
<noinclude>
<bootstrap_jumbotron>
<h2>Docker Portweiterleitung</h2>
</bootstrap_jumbotron>
</noinclude>


== Beschreibung ==
== Beschreibung ==
Zeile 9: Zeile 20:
; Container-Ports mit lokalen Ports verbinden
; 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:
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.
 
; Integration von Containern in das lokale Netzwerk
* Bei getting-started handelt es sich um einen einfachen Webserver, dessen Container als Hintergrunddienst ausgeführt wird.  
* 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.  
* 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:


Die Inbetriebnahme erfolgt Docker-typisch mit einem unscheinbaren, kurzen Kommando:
  docker run -d -p 80:80 docker/getting-started
  docker run -d -p 80:80 docker/getting-started


Zeile 20: Zeile 32:
* -p 80:80 verbindetPort 80 des Containers mit Port 80 des lokalen Rechners
* -p 80:80 verbindetPort 80 des Containers mit Port 80 des lokalen Rechners


; Sicherheitsrisiko durch Ports
=== 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!
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.  
  In manchen Fällen kann dies ein Sicherheitsrisiko sein.  


Dieses vermeiden Sie, wenn Sie die Port-Weiterleitung explizit auf localhost beschränken, z.&nbsp;B.&nbsp;mit docker run -p 127.0.0.1:8080:80.
Dieses vermeiden Sie, wenn Sie die Port-Weiterleitung explizit auf localhost beschränken, z.&nbsp;B.&nbsp;mit  
docker run -p 127.0.0.1:8080:80
 
; Achtung
: -p hostport:containerport!


; Siehe auch
; Siehe auch
* https://docs.docker.com/network
* https://docs.docker.com/network


; Offizielle Images
=== Offizielle Images ===
Im Unterschied zu den bisherigen Beispielen reicht es bei diesem Beispiel nicht, als Image-Name einfach nur getting-started anzugeben.
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:
Diese Kurzschreibweise ist nur für »offizielle« Images vorgesehen, die Basis-Images oder grundlegende Programmiersprachen, Server oder sonstige Tools zur Verfügung stellen
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.
 
; Spielregeln
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
docker/getting-started


Nach einigen Statusmeldungen (in der Regel muss Docker das Image zuerst herunterladen) passiert – scheinbar – nichts.  
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 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 beweist, dass der Container tatsächlich läuft:


  docker ps
  docker ps
Zeile 46: Zeile 69:


Die Spalte PORTS verrät, dass Port 80 des Containers mit Port 80 des Docker-Hosts
Die Spalte PORTS verrät, dass Port 80 des Containers mit Port 80 des Docker-Hosts
(also Ihres Rechners!) verbunden ist.
(also Ihres Rechners!) verbunden ist
* Um zu sehen, was auf Port 80 passiert, öffnen Sie auf Ihrem Webbrowser die Adresse localhost.
* 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


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


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.  
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.  
* 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/.
* 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
* 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


; Probleme mit Port 80
Eine mögliche Fehlerursache kann darin bestehen, dass Port 80 schon belegt ist, weil auf Ihrem Rechner bereits ein Webserver aktiv ist
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.  
* 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).
* 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!  
; 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 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
* 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.
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
  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
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 arbeiten.
; 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
* 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.&nbsp;B.&nbsp;8080.
* Der Lösungsweg ist der gleiche: Verwenden einer Portnummer, die größer ist als 1024 – z.&nbsp;B.&nbsp;8080
** Jede Zahl zwischen 1024 und 65535 funktioniert, sofern der Port nicht schon für eine andere Funktion reserviert ist.
** Jede Zahl zwischen 1024 und 65535 funktioniert, sofern der Port nicht schon für eine andere Funktion reserviert ist


; Aufräumen
; Aufräumen
Der getting-started-Container läuft im Hintergrund weiter, bis Sie ihn explizit beenden oder Ihren Rechner neu starten.
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.
* 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.
Um die Container-Ausführung zu beenden, ermitteln Sie zuerst mit ps seinen Namen oder seine ID
  docker ps
  docker ps


Zeile 93: Zeile 118:
  docker stop 3c8ac71262b8
  docker stop 3c8ac71262b8


Wenn Sie denselben Container später noch einmal starten möchten, führen Sie entsprechend docker start <id> oder <name> aus.
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.
* 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.
* 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
; Container löschen
* Das funktioniert nur, wenn er nicht läuft.
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
* 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.
; Image löschen
* Das ist wiederum nur möglich, nachdem Sie vorher alle davon abgeleiteten Container gelöscht haben.
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


<noinclude>
<noinclude>
[[Kategorie:Docker/Grundlagen]]
[[Kategorie:Docker/Grundlagen]]
</noinclude>
</noinclude>

Aktuelle Version vom 18. November 2026, 13:55 Uhr



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