Docker/Grundlagen/04 Portweiterleitung: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
K Textersetzung - „bzw. “ durch „oder “ |
||
| (11 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''' | |||
<noinclude> | |||
<bootstrap_jumbotron> | |||
<h2>Docker Portweiterleitung</h2> | |||
</bootstrap_jumbotron> | |||
</noinclude> | |||
== Beschreibung == | |||
; Portweiterleitung | |||
Neben dem schon vorgestellten hello-world-Image gibt es im Docker Hub ein weiteres Image, das für erste Experimente gedacht ist. | 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. | * 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! | * 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 | ; 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. | * 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. | ||
docker run -d -p 80:80 docker / getting - started | 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 | |||
* | * 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 | |||
Diese Kurzschreibweise ist nur für »offizielle« Images vorgesehen, die Basis-Images oder 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 | ; Spielregeln | ||
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 | 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, dass der Container tatsächlich läuft: | |||
docker ps | 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 | 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 | |||
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. | 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 | ||
== 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 | |||
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 | |||
docker run -d -p 8080:80 docker / getting - started | 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 | 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 | |||
Der getting-started-Container läuft im Hintergrund weiter, bis Sie ihn explizit beenden oder Ihren Rechner neu starten | ; 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 | 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 | |||
docker stop | ; 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 | |||
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/ | [[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