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
- Publikowanie portów, Docker Docs.
- Usługi i mapowania Compose, Docker Docs.
- Sieci projektu, Docker Docs.
- Instrukcja EXPOSE, Docker Docs.
- Odczyt portu Compose, Docker Docs.
- Docker i firewall, Docker Docs.
Data publikacji: 19.11.2026.

Dyskusja