Docker/Grundlagen/04 Portweiterleitung: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
|||
| Zeile 20: | 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: | ||
; 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: | |||
docker run -d -p 80:80 docker/getting-started | docker run -d -p 80:80 docker/getting-started | ||
| Zeile 31: | 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 | ||
=== Sicherheit === | |||
; Sicherheitsrisiko durch Ports | ; 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. B. mit docker run -p 127.0.0.1:8080:80 | 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 | |||
; Siehe auch | ; Siehe auch | ||
| Zeile 41: | Zeile 44: | ||
; 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 | |||
; Spielregeln | |||
Offizielle Images müssen bestimmte Spielregeln einhalten, werden dafür aber innerhalb des Docker Hubs bevorzugt behandelt: | 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. | 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. | Nach einigen Statusmeldungen (in der Regel muss Docker das Image zuerst herunterladen) passiert – scheinbar – nichts. | ||
| Zeile 62: | Zeile 70: | ||
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 – genau genommen ein Webserver – zur Verfügung stellt | Damit kommen Sie auf eine Website, die der von Docker ausgeführte Container – genau genommen ein Webserver – zur 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. | 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 mit Port 80 | ; Probleme mit Port 80 | ||
Nicht in jedem Fall führt das vorhin angegebene Kommando ''docker run'' zum Erfolg | 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 | 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 | ||
| Zeile 86: | Zeile 94: | ||
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 | 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. B. 8080 | * 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 | ** 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 104: | Zeile 112: | ||
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> | ||
Version vom 16. November 2026, 17:42 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
- 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 bzw. 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: 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
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 – genau genommen ein Webserver – zur 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 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 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
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