Dwa kontenery działają na tym samym VPS-ie, ale aplikacja nie potrafi połączyć się z bazą. Częstą przyczyną jest adres localhost, który wewnątrz kontenera wskazuje ten kontener, a nie sąsiednią usługę. Docker network pozwala połączyć usługi przez osobną sieć i odwoływać się do nich po nazwach.
Pokażę to na dwóch małych kontenerach w Compose. Jeden udostępnia HTTP, drugi wykonuje żądanie. Żaden port nie będzie publikowany na hoście, a test nie wymaga zmiany działającej aplikacji.
Trzy adresy, których nie należy mylić
Rozróżnij adres wewnątrz kontenera, nazwę usługi w sieci Dockera oraz adres hosta dostępny dla użytkownika. Każdy służy do innego połączenia.
| Miejsce wykonania klienta | Przykładowy cel |
|---|---|
| W tym samym kontenerze co serwer | 127.0.0.1:8000 |
| W innym kontenerze tej samej sieci | web:8000 |
| Na hoście lub poza nim | Opublikowany adres i port hosta, jeśli skonfigurowany |
Jeżeli mapujesz 8080:8000, użytkownik hosta korzysta z portu 8080, ale sąsiedni kontener nadal łączy się z usługą na 8000. Mapowanie nie zmienia portu nasłuchiwania programu. Podstawy obrazu i kontenera opisuje wprowadzenie do Dockera.
Nazwa usługi zamiast stałego IP
Sieci bridge utworzone przez użytkownika zapewniają rozwiązywanie nazw kontenerów i aliasów. Compose tworzy dla projektu domyślną sieć, chyba że skonfigurujesz ją inaczej. Usługi we wspólnej sieci mogą odnajdywać się po nazwach z pliku projektu.
Nie zapisuj na stałe adresu IP kontenera odczytanego z inspect. Przy odtworzeniu kontenera adres może się zmienić. Nazwa usługi pozostaje właściwym punktem odniesienia, choć klient nadal musi umieć odnowić połączenie po zmianie lub awarii.
Domyślna sieć o nazwie bridge i własna sieć typu bridge nie mają identycznej wygody rozwiązywania nazw. Do projektu aplikacyjnego używaj jawnie zorganizowanej sieci lub domyślnej sieci Compose. Szczegóły pliku projektu wyjaśnia poradnik Compose.
Uruchom odizolowany przykład
W pustym 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
networks: [backend]
mem_limit: 64m
cpus: 0.25
client:
image: python:3.13-slim
command: ["sleep", "infinity"]
networks: [backend]
mem_limit: 64m
cpus: 0.25
networks:
backend:
internal: true
Uruchom projekt i sprawdź stan:
docker compose -p network-demo up -d
docker compose -p network-demo ps
internal: true tworzy sieć przeznaczoną do komunikacji wewnętrznej, bez zwykłego wyjścia na zewnątrz przez tę sieć. Nie jest to kompletna granica bezpieczeństwa wobec administratora hosta. Limity pamięci i CPU ograniczają zasoby demonstracji.
Serwer nasłuchuje na 0.0.0.0, więc przyjmuje połączenia przez interfejs kontenera. Gdyby nasłuchiwał wyłącznie na 127.0.0.1, klient w drugim kontenerze nie dotarłby do niego mimo poprawnego DNS.
Sprawdź DNS i HTTP osobno
Najpierw odczytaj rozwiązanie nazwy, następnie wykonaj żądanie:
docker compose -p network-demo exec -T client python -c "import socket; print(socket.gethostbyname('web'))"
docker compose -p network-demo exec -T client python -c "import urllib.request; print(urllib.request.urlopen('http://web:8000', timeout=5).status)"
W rzeczywistym teście tego projektu nazwa web została rozwiązana, a HTTP zwróciło 200. Próba połączenia z 127.0.0.1:8000 z kontenera klienta nie dotarła do serwera. To potwierdza różnicę między własną pętlą zwrotną a adresem sąsiedniej usługi.
Test nie mierzył wydajności sieci ani odporności na ataki. Wykorzystano dwa ograniczone zasobowo kontenery, bez publikowanych portów. Po zakończeniu usunięto wyłącznie projekt testowy.
Ports i expose nie są zamienne
ports publikuje port kontenera na hoście. Zapis bez konkretnego adresu hosta może udostępnić go szerzej, niż zamierzasz. Gdy potrzebujesz dostępu tylko lokalnego, rozważ jawne przypisanie do pętli zwrotnej i sprawdź zachowanie firewalla.
expose opisuje port usługi, ale nie jest mechanizmem publikowania na hoście ani zaporą między kontenerami. Kontenery we wspólnej sieci mogą komunikować się z nasłuchującym portem także bez tej deklaracji.
Nie wystawiaj portu bazy tylko po to, żeby połączyła się z nią aplikacja z tej samej sieci. Publiczny ruch zwykle powinien trafiać przez jeden kontrolowany punkt wejścia. Zasady wdrażania aplikacji opisuje Docker na VPS.
Kilka sieci w jednym projekcie
Możesz połączyć reverse proxy i aplikację siecią frontową, a aplikację i bazę osobną siecią backendową. Baza nie musi należeć do sieci proxy. Aplikacja należąca do obu sieci nadal wymaga właściwych uprawnień i zabezpieczeń.
To ogranicza bezpośrednią widoczność usług, lecz nie zastępuje uwierzytelnienia bazy. Nie zakładaj, że wszystko w jednej sieci jest zaufane. Udostępniaj poświadczenia tylko usługom, które rzeczywiście ich potrzebują.
Sieci zewnętrzne Compose przydają się przy łączeniu osobnych projektów. Ich cykl życia jest zarządzany oddzielnie. Przed usuwaniem sieci sprawdź, jakie kontenery są do niej podłączone. Nie wykonuj globalnego czyszczenia jako pierwszego kroku diagnostyki.
Kolejność diagnozy połączenia
Sprawdź, czy obie usługi należą do tej samej sieci. Następnie potwierdź DNS, port i adres nasłuchiwania. Dopiero potem badaj odpowiedź protokołu oraz uprawnienia aplikacji.
docker network inspect network-demo_backend
docker compose -p network-demo logs web
Nazwa sieci wynika tu z jawnego projektu i klucza backend. W innym projekcie może być inna. Connection refused zwykle oznacza inny etap awarii niż brak rozwiązania nazwy. Pomocna jest lista kroków diagnostycznych oraz ściąga Dockera.
Działająca sieć nie gwarantuje gotowości aplikacji. Serwer może jeszcze inicjalizować dane. Do kontroli usługi służy Docker Healthcheck, a klient nadal powinien umieć obsłużyć przejściową niedostępność.
Sprzątanie demonstracji
Po zakończeniu wykonaj w katalogu przykładu:
docker compose -p network-demo down
Polecenie dotyczy wskazanego projektu. Nie ma potrzeby restartowania Dockera, zmieniania reguł całego hosta ani usuwania sieci innych aplikacji.
Najczęstsze pytania
Dlaczego localhost nie prowadzi do bazy?
Wskazuje kontener wykonujący połączenie. Dla sąsiedniej usługi użyj jej nazwy w odpowiedniej wspólnej sieci i portu wewnętrznego.
Czy muszę dodać ports dla komunikacji kontenerów?
Nie, jeśli komunikują się przez wspólną sieć Dockera. Publikowanie portu służy dostępowi przez hosta.
Czy expose blokuje inne porty?
Nie. Nie traktuj tej deklaracji jako firewalla. Znaczenie mają nasłuchujące usługi, sieci i właściwe reguły dostępu.
Czy adres IP kontenera jest stały?
Nie należy tego zakładać. W zwykłym projekcie korzystaj z nazw usług i obsługuj ponowne połączenie po ich odtworzeniu.
Źródła
- Podstawy sieci kontenerów, Docker Docs.
- Własne sieci bridge i DNS, Docker Docs.
- Sieci w Compose, Docker Docs.
- Publikowanie portów, Docker Docs.
- Inspekcja sieci, Docker Docs.
Data publikacji: 05.11.2026.

Dyskusja