Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

Porty w Dockerze: jak działa mapowanie portów?

Dwie bramy w niebieskiej ścianie połączone koralową drogą pakietów

Usługa może działać w kontenerze i nadal być niedostępna pod adresem VPS-a. Port aplikacji, port kontenera i opublikowany port hosta trzeba odczytywać w kontekście miejsca, z którego wykonujesz połączenie. Sam zapis EXPOSE nie otwiera aplikacji dla użytkowników internetu.

Zaczniemy od małego serwera HTTP dostępnego tylko na pętli zwrotnej hosta. Przykład korzysta z przydzielonego automatycznie portu, więc nie trzeba zajmować portu używanego przez inną aplikację.

Jak czytać zapis mapowania

W krótkiej składni 8080:8000 liczba po lewej oznacza port hosta, a po prawej port kontenera. Aplikacja musi rzeczywiście nasłuchiwać na 8000. Docker nie zmieni jej konfiguracji tylko dlatego, że podałeś tę liczbę w Compose.

Zapis 127.0.0.1:8080:8000 dodatkowo wskazuje adres hosta. Przy standardowej sieci bridge z NAT ogranicza punkt dostępu do pętli zwrotnej. Natomiast mapowanie bez adresu może udostępnić usługę na wszystkich interfejsach.

Klient Adres w przykładowym projekcie
Proces w kontenerze web 127.0.0.1:8000
Inna usługa we wspólnej sieci web:8000
Proces na hoście 127.0.0.1:port-przydzielony

Podstawy wspólnej sieci i nazw usług opisuje Docker network. Nie używaj opublikowanego portu hosta jako domyślnej drogi między sąsiednimi kontenerami.

Uruchom przykład z wolnym portem

W osobnym katalogu zapisz compose.yaml:

services:
  web:
    image: python:3.13-slim
    command: ["python", "-m", "http.server", "8000", "--bind", "0.0.0.0"]
    working_dir: /tmp
    ports:
      - "127.0.0.1::8000"
    mem_limit: 64m
    cpus: 0.25

Puste miejsce między dwoma dwukropkami oznacza pominięty numer portu hosta. Docker przydzieli go automatycznie. Port kontenera pozostaje równy 8000.

docker compose -p ports-demo up -d
docker compose -p ports-demo port web 8000

Drugie polecenie zwróci adres z przydzielonym numerem. Użyj dokładnie tego wyniku w żądaniu:

curl --fail http://127.0.0.1:PRZYDZIELONY_PORT/

Zastąp PRZYDZIELONY_PORT liczbą. Jeśli aplikacja dopiero startuje, sprawdź jej logi i ponów odczyt po gotowości. W teście tego projektu uzyskano HTTP 200 na pętli zwrotnej. Nie sprawdzano publicznej dostępności usługi i nie wystawiano jej na wszystkich adresach hosta.

Komunikat o zerwanym połączeniu tuż po starcie nie musi oznaczać błędnego mapowania. Na przykład proces może jeszcze nie nasłuchiwać. Gotowość aplikacji to osobny temat, opisany w poradniku healthcheck.

Dlaczego bind aplikacji ma znaczenie

W przykładzie serwer używa --bind 0.0.0.0 wewnątrz kontenera. Oznacza to nasłuchiwanie na jego interfejsach IPv4. Nie jest to to samo co publikacja na wszystkich interfejsach VPS-a.

Gdy aplikacja w kontenerze słucha wyłącznie na własnym 127.0.0.1, ruch docierający do interfejsu kontenera może nie zostać przyjęty. Wtedy zmiana portu hosta nie pomoże. Najpierw sprawdź ustawienie serwera, potem regułę publikacji.

Adresy 0.0.0.0 i 127.0.0.1 pełnią różne role. Pierwszy jest adresem wiązania oznaczającym wszystkie interfejsy IPv4, drugi pętlą zwrotną. Do połączenia z innego komputera używa się właściwego adresu serwera lub domeny.

EXPOSE, expose i ports

EXPOSE w Dockerfile dokumentuje port przewidziany przez obraz. expose w Compose opisuje port usługi bez publikowania go na hoście. ports tworzy mapowanie.

Żadnej z pierwszych dwóch deklaracji nie traktuj jak zapory między kontenerami we wspólnej sieci. O dostępności decyduje rzeczywisty nasłuch i konfiguracja sieci. Przykłady obrazu znajdziesz w poradniku Dockerfile.

TCP i UDP również trzeba rozróżnić. Domyślne mapowanie dotyczy TCP; dla UDP dopisz właściwy protokół. Aplikacja korzystająca z obu może potrzebować dwóch jawnych mapowań.

Kontrola istniejącego wdrożenia

docker compose ps
docker port NAZWA_KONTENERA
docker inspect --format '{{json .NetworkSettings.Ports}}' NAZWA_KONTENERA

Te polecenia pokazują stan utworzonego kontenera. Sam plik YAML nie dowodzi, że wdrożenie już przyjęło zmianę. Po edycji zastosuj właściwy proces odtworzenia usługi, zamiast zakładać, że zwykły restart zmieni mapowanie.

Przy komunikacie o zajętym porcie ustal, kto już go używa. Nie zatrzymuj losowych usług. Możesz wybrać inny port hosta albo skierować ruch przez istniejący reverse proxy. Podstawową pracę z projektem zbiera ściąga Dockera.

Mapowanie a firewall i reverse proxy

Nie zakładaj, że reguły zapory skonfigurowane bez uwzględnienia Dockera automatycznie obejmują opublikowane porty. Docker tworzy własne reguły sieciowe, dlatego dostęp trzeba sprawdzić z właściwego miejsca.

Dokumentacja odnotowuje również historyczną pułapkę wersji starszych niż 28.0.0, w których publikacja do localhost mogła być dostępna z tego samego segmentu L2. Sprawdź wersję silnika oraz aktualne reguły, zamiast traktować jeden zapis jako uniwersalny audyt bezpieczeństwa.

Gdy proxy działa na hoście, mapowanie do localhost może być właściwym zapleczem. Gdy proxy jest kontenerem, zwykle wystarcza wspólna sieć i nazwa usługi. Praktyczne wdrożenie omawia Docker na VPS.

Jeżeli połączenie jest odrzucane, przejdź kolejno przez DNS, adres hosta, mapowanie, nasłuch i gotowość. Pomocna jest diagnostyka Connection refused.

Zakończenie demonstracji

docker compose -p ports-demo down

Wykonaj je w katalogu przykładu. Usuwa projekt demonstracyjny, a nie sieci wszystkich aplikacji. W ćwiczeniu nie ma danych wymagających zachowania w wolumenie.

Najczęstsze pytania

Która liczba w 8080:80 jest portem hosta?

Pierwsza, czyli 8080. Aplikacja w kontenerze musi nasłuchiwać na 80.

Dlaczego EXPOSE nie udostępnia strony?

To deklaracja obrazu. Publikacja wymaga mapowania, a program musi działać i nasłuchiwać.

Jak uniknąć konfliktu portów w teście?

Pomiń port hosta i odczytaj przydzielony numer przez docker compose port.

Czy baza wymaga publikacji portu dla aplikacji w Compose?

Nie, jeśli obie usługi mają właściwą wspólną sieć. Aplikacja korzysta wtedy z nazwy usługi i portu bazy.

Źródła

Data publikacji: 19.11.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *