Docker pozwala uruchamiać aplikacje w kontenerach, czyli wydzielonych środowiskach z potrzebnymi bibliotekami i narzędziami. Dzięki temu łatwiej uruchomić ten sam projekt na swoim komputerze i na serwerze.
Załóżmy, że jedna aplikacja potrzebuje Pythona 3.11, a druga wersji 3.12. Zamiast dopasowywać cały system do obu projektów, przygotowujesz dla każdego osobny obraz. Docker uruchamia z tych obrazów kontenery.
Najpierw wyjaśnię podstawowe pojęcia. Następnie uruchomisz prostą aplikację i sprawdzisz jej logi. Na końcu przeniesiesz konfigurację do pliku Docker Compose. Ćwiczenia dotyczą kontenerów linuksowych na własnym komputerze.
Docker - co to jest i jaki problem rozwiązuje?
Docker służy do przygotowania środowiska aplikacji i uruchamiania go na różnych maszynach. Najpierw budujesz lub pobierasz obraz, czyli pakiet z programem i jego zależnościami. Następnie tworzysz z niego kontener, w którym działa program.
Dzięki temu projekty mogą korzystać z różnych wersji bibliotek. Każdy dostaje własne środowisko, więc aktualizacja jednego nie musi zmieniać plików drugiego.
Możesz też przekazać taki obraz innej osobie. Nie musi wtedy odtwarzać listy bibliotek z pamięci ani instalować ich ręcznie.
Warto rozdzielić trzy nazwy:
| Nazwa | Do czego służy |
|---|---|
| Docker Engine | Silnik, który tworzy i uruchamia kontenery |
| Docker Desktop | Aplikacja do pracy z Dockerem na komputerze |
| Docker Hub | Rejestr, z którego pobierasz obrazy |
To różne elementy ekosystemu. Korzystanie z kontenerów na serwerze nie oznacza konieczności instalowania tam graficznej aplikacji Desktop.
Obraz, kontener i Dockerfile - trzy różne rzeczy
Dockerfile to przepis, obraz to gotowy pakiet, a kontener to środowisko utworzone z tego pakietu. Obraz zawiera między innymi kod i biblioteki. Gdy chcesz zmienić jego zawartość, budujesz nowy obraz.
Obrazy składają się z warstw. Wspólna warstwa może służyć kilku obrazom, co ogranicza powielanie tych samych danych.
| Pojęcie | Co oznacza | Przykład zastosowania |
|---|---|---|
| Dockerfile | Instrukcje budowania obrazu | Dodanie kodu aplikacji i instalacja zależności |
| Obraz | Gotowy pakiet potrzebny do utworzenia kontenera | Wydanie aplikacji przygotowane do wdrożenia |
| Kontener | Instancja utworzona z obrazu | Działająca aplikacja albo zakończone zadanie |
| Rejestr obrazów | Miejsce przechowywania i udostępniania obrazów | Docker Hub lub prywatny rejestr |
Jeden obraz może posłużyć do utworzenia kilku kontenerów. Nie oznacza to, że będą współdzieliły wszystkie zmiany w plikach. Każdy otrzymuje własną warstwę zapisu, chyba że świadomie udostępnisz im wspólne dane.
Dockerfile nie jest natomiast opisem całej infrastruktury. Odpowiada na pytanie, jak zbudować obraz. Połączenia między usługami, porty i miejsca przechowywania danych wygodniej opisać osobno, na przykład w Compose.

Jak działa Docker po wydaniu polecenia?
Po wpisaniu docker run zwykle dzieją się cztery rzeczy:
- Klient w terminalu wysyła polecenie do usługi Docker Engine.
- Jeśli obrazu brakuje na dysku, Docker go pobiera.
- Następnie tworzy kontener z ustawieniami podanymi w poleceniu.
- Na koniec uruchamia program wewnątrz kontenera.
Usługa zarządzająca kontenerami to demon Dockera. Może działać na tym samym komputerze co terminal lub na zdalnym serwerze.
Kontenery linuksowe korzystają z mechanizmów jądra systemu. Namespaces oddzielają między innymi widok procesów i sieci. Natomiast cgroups pozwalają kontrolować zużycie zasobów.
Na początek wystarczy zapamiętać: kontener to wydzielone środowisko dla procesów aplikacji. Nie uruchamia własnego jądra systemu.
Wniosek praktyczny: sam fakt użycia kontenera nie przydziela aplikacji dowolnej ilości pamięci. Nadal korzysta ona z zasobów maszyny, na której działa.
Docker a maszyna wirtualna
Maszyna wirtualna ma własny system operacyjny i jądro. Kontenery linuksowe współdzielą jądro środowiska, w którym są uruchamiane. Dzięki temu nie trzeba uruchamiać osobnego systemu dla każdej aplikacji.
| Cecha | Kontener linuksowy | Maszyna wirtualna |
|---|---|---|
| Jądro systemu | Współdzielone z hostem kontenerów | Własne jądro systemu gościa |
| Podstawowa jednostka | Środowisko procesu aplikacji | Cały system operacyjny |
| Typowe zastosowanie | Uruchamianie usług i zadań | Oddzielenie pełnych systemów |
| Koszt dodatkowego środowiska | Zwykle mniejszy | Obejmuje kolejny system gościa |
Oba rozwiązania mogą działać razem. Przykładowo VPS może być maszyną wirtualną, wewnątrz której uruchamiasz kilka kontenerów.
Docker może jednak sam korzystać z wirtualizacji. Na przykład Docker Desktop na macOS uruchamia kontenery linuksowe w środowisku z jądrem Linux. Dopiero wewnątrz niego kontenery współdzielą jądro.
Do czego służy Docker w codziennej pracy?
Najłatwiej ocenić przydatność Dockera przez zadanie, które chcesz wykonać. Samo przeniesienie programu do kontenera nie jest jeszcze usprawnieniem.
Środowiska developerskie i testowe
Jeżeli projekt wymaga aplikacji, bazy danych i dodatkowej usługi, wspólny opis środowiska ogranicza liczbę ręcznych instrukcji dla nowych osób. Zamiast prośby o odtworzenie konfiguracji z pamięci przekazujesz pliki projektu.
Praktyczny przykład: testujesz zmianę w aplikacji korzystającej z bazy. Przygotowujesz osobne środowisko z testowymi danymi, zamiast eksperymentować na bazie używanej przez działającą stronę. Kontenery ułatwiają taki podział, ale poprawny wybór danych nadal należy do Ciebie.
Własny serwer i self-hosting
Możesz podzielić projekt na usługę aplikacji, bazę i proces wykonujący zadania w tle. Dzięki temu opisujesz ich konfigurację oddzielnie.
Dla początkującego administratora istotne są konkretne pytania: gdzie aplikacja zapisuje pliki, jak komunikuje się z bazą i co trzeba zachować przy aktualizacji. Dopiero odpowiedzi na nie pozwalają sensownie zaplanować wdrożenie.
Automatyzacja i zadania jednorazowe
Kontener nie musi działać bez przerwy. Możesz użyć go do wykonania skryptu, wygenerowania pliku albo przetworzenia danych. Po zakończeniu głównego procesu kontener może pozostać zatrzymany. Nie jest to automatycznie awaria. Cykl uruchomienia zależy od polecenia wykonywanego w środku.
Dobrym kryterium jest powtarzalność: jeżeli często odtwarzasz te same zależności na różnych maszynach, warto rozważyć opisanie tego środowiska jako obrazu.
Pierwszy kontener Docker krok po kroku
Do ćwiczenia potrzebujesz:
- działającego Docker Desktop lub Docker Engine w trybie kontenerów linuksowych,
- dostępu do internetu,
- wolnego portu
8080.
Poniżej zaczynamy od sprawdzenia gotowej instalacji. Wszystkie polecenia wykonuj w terminalu na swoim komputerze.
1. Sprawdź połączenie z Dockerem
W terminalu wykonaj:
docker version
Zwróć uwagę na informacje o kliencie i serwerze. Jeżeli klient nie może połączyć się z demonem, najpierw uruchom odpowiednią usługę albo Docker Desktop. Ponawianie polecenia tworzącego kontener nie rozwiąże braku połączenia.
2. Uruchom aplikację demonstracyjną
Wpisz jako jedną linię:
docker run --name tt-demo -d -p 127.0.0.1:8080:80 docker/welcome-to-docker
Poszczególne elementy oznaczają:
--name tt-demonadaje kontenerowi nazwę używaną w kolejnych poleceniach.-duruchamia go w tle.-p 127.0.0.1:8080:80kieruje ruch z lokalnego portu8080do portu80kontenera.docker/welcome-to-dockerwskazuje obraz demonstracyjny używany w dokumentacji Dockera.
Otwórz w przeglądarce http://127.0.0.1:8080. Powinna pojawić się strona demonstracyjna. To lokalna aplikacja.
3. Sprawdź stan i logi
docker ps
docker logs tt-demo
Jeżeli aplikacja nie odpowiada, sprawdź również zatrzymane kontenery:
docker ps -a
Przy konflikcie portu możesz użyć mapowania 127.0.0.1:8081:80. Wtedy w przeglądarce wpisz port 8081. Jeśli nazwa tt-demo jest już zajęta, sprawdź istniejący kontener przed utworzeniem kolejnego.
4. Zakończ przykład
Poniższe polecenia dotyczą wyłącznie utworzonego kontenera demonstracyjnego:
docker stop tt-demo
docker rm tt-demo
Zatrzymanie i usunięcie to różne operacje. Pierwsza kończy działanie procesu, druga usuwa kontener. Pobrany obraz może pozostać na dysku.
Polecenia do sprawdzania kontenerów, logów i zużycia zasobów znajdziesz w ściądze Docker i Compose. Jeśli proces kończy się zaraz po starcie, przejdź przez diagnostykę wyłączającego się kontenera.
Porty: dlaczego aplikacja nie zawsze jest dostępna?
Port aplikacji w kontenerze i port na komputerze to dwa różne punkty. Mapowanie 8080:80 oznacza: połącz port 8080 hosta z portem 80 kontenera. Nie zmienia konfiguracji samej aplikacji na port 8080.
Pomijając adres hosta w mapowaniu, domyślnie publikujesz port na wszystkich jego adresach. Dlatego w przykładzie używamy 127.0.0.1. Wyjaśnia to dokumentacja publikowania portów, która wskazuje również historyczny wyjątek dla wersji Engine starszych niż 28.0.0. Ćwiczenie wykonuj na aktualnej instalacji i przy standardowej konfiguracji sieci.
W typowej sieci Compose kontenery odnajdują się po nazwach usług. Jeżeli baza ma nazwę db, aplikacja łączy się z usługą db na porcie bazy, a nie z localhost swojego kontenera. Nie trzeba publikować portu bazy na hoście wyłącznie po to, by korzystała z niej druga usługa w tej samej sieci.
Gdy publikacja portu kończy się błędem, sprawdź poradnik Docker: port is already allocated. Osobno opisuję brak połączenia kontenera z bazą, gdzie znaczenie mają adres usługi i wspólna sieć.
Gdzie Docker przechowuje dane?
Dane zapisane wyłącznie w zapisywalnej warstwie kontenera znikają przy jego usunięciu. Samo zatrzymanie kontenera ich nie kasuje. Do trwałego przechowywania danych możesz użyć wolumenu, którego cykl życia jest oddzielny od kontenera.
W praktyce rozdziel:
- Obraz aplikacji, który można pobrać lub zbudować ponownie.
- Konfigurację, potrzebną do poprawnego uruchomienia.
- Dane użytkowników, których nie odtworzysz z samego obrazu.
Wolumenem zarządza Docker. Możesz go podłączyć do nowego kontenera po usunięciu starego.
Natomiast bind mount udostępnia konkretny plik lub katalog z komputera. Przydaje się na przykład wtedy, gdy edytujesz pliki lokalnie i chcesz od razu widzieć je w kontenerze.
Trwałość nie oznacza jednak kopii zapasowej. Jeśli wolumen i baza działają na tym samym serwerze, utrata tego serwera może oznaczać utratę danych. Zaplanuj osobny backup i sprawdź odtwarzanie. Dla bazy danych sposób wykonania spójnej kopii dobierz do używanego silnika.

Różnicę między warstwą kontenera, bind mountem i wolumenem możesz zobaczyć w teście trwałości danych po usunięciu kontenera. Do eksperymentu dołączone są wyniki i skrypt.
Docker Compose: konfiguracja zapisana w pliku
Przy kolejnych usługach ręczne polecenia stają się trudniejsze do utrzymania. Docker Compose pozwala opisać aplikację w YAML i zarządzać jej usługami razem. W pliku zapisujesz między innymi używane obrazy i mapowania portów.
Po zakończeniu poprzedniego ćwiczenia utwórz osobny katalog. Zapisz w nim plik compose.yaml:
services:
web:
image: docker/welcome-to-docker
ports:
- "127.0.0.1:8080:80"
Uruchom polecenia z tego katalogu:
docker compose -p tt-nauka config
docker compose -p tt-nauka up -d
docker compose -p tt-nauka ps
docker compose -p tt-nauka logs web
Polecenie config sprawdza i wyświetla konfigurację. Następnie up -d uruchamia usługę w tle. Za pomocą ps sprawdzasz stan, a logs web odczytujesz logi. Nazwa projektu tt-nauka oddziela to ćwiczenie od innych projektów Compose. Aplikacja jest dostępna pod tym samym lokalnym adresem co wcześniej.
Po ćwiczeniu usuń jego kontener i sieć projektu:
docker compose -p tt-nauka down
Jedna usługa wystarcza do poznania składni. Rozbudowując projekt, pamiętaj jednak, że uruchomiony kontener bazy nie musi jeszcze oznaczać gotowej bazy. Samo określenie kolejności startu nie wystarcza; Compose obsługuje oczekiwanie na poprawny healthcheck przy warunku service_healthy.
Pełny przykład aplikacji i proxy opisuję w poradniku Docker Compose: uruchomienie kilku kontenerów razem. Możesz też pobrać gotową konfigurację Nginx z Compose do własnych prób.
Czego Docker nie rozwiązuje automatycznie?
Zgodność platformy i wersji
Obraz przygotowany dla jednej architektury procesora nie zawsze zadziała natywnie na innej. Potrzebujesz odpowiedniego wariantu obrazu albo emulacji, która może obniżać wydajność. Obrazy wieloplatformowe pozwalają udostępnić kilka wariantów pod wspólnym odwołaniem.
W przykładach pominęliśmy tag obrazu, więc używane jest domyślne latest. To wygodne w ćwiczeniu, ale nie identyfikuje niezmiennej zawartości. W kontrolowanym wdrożeniu określ wersję, a gdy potrzebujesz jednoznacznie wskazać zawartość, użyj identyfikatora digest.
Bezpieczeństwo i utrzymanie
Kontener nie jest gwarancją bezpiecznego wykonania dowolnego kodu. Dostęp do demona Dockera oraz zbyt szerokie udostępnienie plików hosta mogą dać bardzo duże uprawnienia. Dlatego sprawdzaj pochodzenie obrazu i zakres wymaganych uprawnień.
Przed pierwszym wdrożeniem przygotuj odpowiedzi na pięć pytań:
- Z jakiego obrazu korzystam i jak będę go aktualizować?
- Które dane muszą przetrwać wymianę kontenera?
- Które porty rzeczywiście powinny być dostępne z zewnątrz?
- Jak sprawdzę, czy aplikacja działa poprawnie?
- Jak odtworzę usługę i dane po awarii?
Docker nie zastępuje tych decyzji. Jeśli uruchamiasz pojedynczy skrypt tylko raz, dodatkowa konfiguracja może być zbędna. Zyskujesz więcej, gdy regularnie odtwarzasz środowisko lub przekazujesz je innym osobom.
Czy Docker jest darmowy?
Trzeba odróżnić otwarte komponenty, takie jak Docker Engine, od warunków korzystania z Docker Desktop. Według dokumentacji Desktop jest bezpłatny między innymi do użytku osobistego, edukacji, niekomercyjnych projektów open source oraz dla małych firm spełniających oba warunki: mniej niż 250 pracowników i mniej niż 10 mln USD rocznego przychodu.
Użycie zawodowe poza bezpłatnym zakresem oraz przez podmioty rządowe wymaga płatnej subskrypcji. Przed wdrożeniem firmowym sprawdź zasady licencjonowania Docker Desktop. Te warunki nie oznaczają automatycznej opłaty za każdy kontener uruchomiony na serwerze z Docker Engine.
Najczęstsze pytania
Od czego zacząć naukę Dockera?
Zacznij od jednej aplikacji demonstracyjnej. Uruchom ją, sprawdź port, odczytaj logi, zatrzymaj i usuń kontener. Dopiero potem przenieś konfigurację do Compose i dodaj trwałe dane. Taka kolejność pozwala oddzielić problemy z Dockerem od problemów konkretnego projektu.
Czy Docker zastępuje VPS?
Nie. VPS dostarcza maszynę, na której mogą działać aplikacje. Docker organizuje ich uruchamianie w kontenerach. Możesz więc korzystać z Dockera na VPS-ie, ale nadal potrzebujesz zasobów obliczeniowych, miejsca na dysku i połączenia sieciowego. Kontenery i maszyny wirtualne mogą się uzupełniać.
Dlaczego kontener od razu się zatrzymuje?
Możliwe, że główny proces zakończył zadanie albo wystąpił błąd aplikacji. Sprawdź docker ps -a oraz docker logs NAZWA_KONTENERA. Dla zadania jednorazowego zakończenie może być prawidłowe; dla serwera WWW wymaga wyjaśnienia. Zachowanie kontenera zależy od uruchomionego polecenia.
Czy usunięcie kontenera usuwa bazę danych?
Może ją usunąć, jeśli pliki bazy były zapisane tylko w warstwie kontenera. Przy poprawnie podłączonym nazwanym wolumenie usunięcie samego kontenera nie usuwa wolumenu. Nadal możesz jednak skasować go osobną operacją, dlatego potrzebujesz również kopii zapasowej.
Dlaczego aplikacja nie widzi bazy pod localhost?
W typowej konfiguracji Compose localhost wewnątrz kontenera wskazuje ten kontener, nie oddzielną usługę bazy. Jeśli obie usługi są w tej samej sieci Compose, użyj nazwy usługi bazy i jej wewnętrznego portu, na przykład db:5432 dla tak skonfigurowanego PostgreSQL.
Czy Docker Compose wystarczy na początek?
Do poznania konfiguracji usług w jednym projekcie jest dobrym punktem startowym. Zacznij od małego środowiska, którego dane i połączenia rozumiesz. Jeśli później pojawią się wymagania dotyczące wielu serwerów lub odporności na awarie, oceniaj narzędzia pod te konkretne potrzeby, zamiast rozbudowywać infrastrukturę na zapas.
Źródła
- What is Docker? - architektura i podstawowe pojęcia, Docker Docs
- What is an image? - obrazy i warstwy, Docker Docs
- What is a container? - kontenery i maszyny wirtualne, Docker Docs
- Running containers - polecenia i odwołania do obrazów, Docker Docs
- Port publishing and mapping - publikowanie portów, Docker Docs
- Volumes - trwałe dane i cykl życia wolumenów, Docker Docs
- Docker Compose Quickstart - konfiguracja projektu, Docker Docs
- Networking in Compose - połączenia między usługami, Docker Docs
- Control startup and shutdown order in Compose, Docker Docs
- Docker Engine security - izolacja i uprawnienia, Docker Docs
- Multi-platform builds - zgodność systemów i architektur, Docker Docs
- Docker Desktop license agreement - warunki korzystania, Docker Docs
Data publikacji: 23.09.2026.

Dyskusja