Docker na VPS: różnice i najczęstsze problemy
Uruchomienie Dockera na VPS wymaga uwagi. Dowiedz się, dlaczego porty omijają UFW, jak zapobiec zapełnieniu dysku przez kontenery oraz jak uniknąć błędu OOM Killer przy braku RAM.
Co zmienia się podczas uruchamiania Docker na VPS
Docker na VPS korzysta z tego samego silnika i tych samych obrazów co Docker na laptopie, więc wszystkie znane polecenia działają w ten sam sposób. Zmienia się natomiast otoczenie. Laptop dysponuje zapasem pamięci, firewallem, którego nikt nie skanuje, oraz dyskiem o pojemności, którą rzadko trzeba monitorować. Wynajęty serwer ma sztywny limit pamięci, publiczny adres IP skanowany w ciągu kilku minut od uruchomienia oraz system plików root, który Docker zapełni bez pytania.
Cztery różnice powodują większość problemów na małych maszynach:
- Pamięć jest ograniczona, a jądro systemu rozwiązuje jej niedobór poprzez zabijanie procesów.
- Opublikowany port omija UFW (uncomplicated firewall), ponieważ Docker samodzielnie dopisuje własne reguły firewalla.
- Kontenery nie uruchamiają się ponownie po restarcie systemu, chyba że zostało to wcześniej skonfigurowane.
- Obrazy, kontenery, wolumeny i pamięć podręczna budowania (build cache) rosną, aż do zapełnienia dysku.
Każda z poniższych sekcji wskazuje przyczynę awarii, komunikat, który zobaczysz, oraz przewodnik, który szczegółowo rozwiązuje dany problem. Jeśli nie przygotowano jeszcze pliku compose, należy najpierw przeczytać Podstawy Docker Compose na VPS, a następnie wrócić do tej strony. Niniejszy dokument zakłada, że użytkownik potrafi już uruchomić stos usług.
Ile pamięci RAM zużywa kontener Docker?
Znacznie mniej, niż zakłada większość użytkowników. Kontener jest procesem wewnątrz cgroup (control group), a nie maszyną wirtualną, dlatego nie posiada własnego jądra systemu (guest kernel) ani sztywno przydzielonych zasobów. Koszt pamięci odpowiada zasobom faktycznie wykorzystywanym przez proces. Dzięki temu pełny stos technologiczny mieści się w 2 GB, podczas gdy ten sam stos uruchomiony na maszynach wirtualnych wymagałby znacznie więcej.
Poniższe wartości to typowe zużycie w stanie spoczynku dla standardowych obrazów na systemie Ubuntu 24.04 z domyślną konfiguracją, odczytane z docker stats kilka minut po uruchomieniu. Stanowią one punkt wyjścia do planowania, a nie benchmark obciążenia. Przed poleganiem na jakichkolwiek danych, w tym poniższych, należy uruchomić docker stats --no-stream na własnym serwerze.
Dane, na których opiera się ten wykres
[
{
"label": "nginx",
"idle_mb": 8,
"budget_mb": 64
},
{
"label": "Redis 7",
"idle_mb": 12,
"budget_mb": 128
},
{
"label": "Traefik v3",
"idle_mb": 40,
"budget_mb": 128
},
{
"label": "PostgreSQL 16",
"idle_mb": 45,
"budget_mb": 512
},
{
"label": "Uptime Kuma",
"idle_mb": 95,
"budget_mb": 256
},
{
"label": "MariaDB 11",
"idle_mb": 190,
"budget_mb": 512
},
{
"label": "Nextcloud (Apache)",
"idle_mb": 210,
"budget_mb": 768
}
]Obie kolumny pełnią różne funkcje. idle_mb to zużycie pamięci przez kontener w stanie bezczynności. budget_mb to wartość, którą należy zarezerwować podczas planowania, ponieważ rzeczywiste użycie nie ogranicza się do stanu spoczynku. PostgreSQL w stanie bezczynności zużywa około 45 MB, ale wymaga 512 MB, gdy aktywne są połączenia, operacje sortowania i pamięć podręczna. Planowanie należy opierać na kolumnie budżetowej, a diagnostykę na kolumnie stanu spoczynku.
Należy zwrócić uwagę na wartości w tych 7 wierszach. nginx w stanie spoczynku zużywa 8 MB, a Nextcloud 210 MB. Proxy działające przed aplikacjami jest niemal bezkosztowe. To baza danych oraz aplikacja PHP determinują wymagania sprzętowe serwera.
Ostrzeżenie dotyczące docker stats: wskaźnik zużycia pamięci obejmuje pamięć podręczną stron (page cache), która jest zapełniana podczas odczytu plików przez kontener, dlatego wartość ta rośnie przez pewien czas po starcie, a następnie stabilizuje się. Przed podjęciem decyzji o wystąpieniu wycieku pamięci należy monitorować proces przez godzinę.
Dobór VPS: co mieści się w 2 GB, 4 GB i 8 GB
Najpierw odejmij zasoby przypadające na hosta. Kernel, systemd, journald, sshd i Docker daemon korzystają z tej samej pamięci RAM co kontenery, a dockerd razem z containerd zajmuje około 100 MB. Potrzebna jest również wolna pamięć na page cache oraz na skok zużycia pamięci podczas budowania obrazu lub wykonywania zrzutu bazy danych.
Dane, na których opiera się ten wykres
[
{
"plan": "2 GB VPS",
"total_mb": 2048,
"host_reserve_mb": 768,
"container_mb": 1280
},
{
"plan": "4 GB VPS",
"total_mb": 4096,
"host_reserve_mb": 1024,
"container_mb": 3072
},
{
"plan": "8 GB VPS",
"total_mb": 8192,
"host_reserve_mb": 1536,
"container_mb": 6656
}
]host_reserve_mb obejmuje system operacyjny, Docker daemon oraz zapas, który pozwala utrzymać responsywność serwera pod obciążeniem. Pozostała pamięć to container_mb i tylko tę wartość można przeznaczyć na kontenery. Rezerwa rośnie wraz z planem: od 768 MB w najmniejszym wariancie do 1536 MB w największym, ponieważ większy serwer uruchamia więcej kontenerów, zapisuje więcej logów i potrzebuje większego page cache.
Plan 2 GB pozostawia 1280 MB na kontenery. Przeznacz 512 MB na PostgreSQL oraz 128 MB na Traefik, a połowa dostępnej pamięci będzie już zajęta. Pozostała pamięć wystarczy na dwie małe aplikacje, po około 256 MB każda. To rzeczywisty i użyteczny serwer. Nie wystarczy jednak na Nextcloud oraz klaster wyszukiwania.
Plan 4 GB pozostawia 3072 MB. W tej pamięci jednocześnie mieszczą się baza danych, reverse proxy, trzy aplikacje i kontener monitorujący. To najmniejszy wariant, który warto wybrać do istotnych zastosowań, ponieważ wolna pamięć absorbuje skutki nieudanego wdrożenia.
Plan 8 GB pozostawia 6656 MB z 8192 MB, a ograniczeniem zwykle staje się CPU albo przepustowość dysku, a nie pamięć. SSD Nodes nie oferuje nic mniejszego: jego najmniejszy plan ma 8 GB RAM (strona z cenami sprawdzona 2026-10-11), dlatego na tym hoście obowiązuje ten wiersz. Wiersze dla 2 GB i 4 GB opisują mniejsze serwery u innych dostawców. Rozmiar jednej z klas kontenerów wynika z konfiguracji, a nie z obciążenia: lokalny serwer modelu rezerwuje KV cache proporcjonalnie do rozmiaru okna kontekstu, dlatego zwiększenie wartości num_ctx w Ollama może dodać gigabajty do budżetu, zanim nadejdzie choćby jedno żądanie. Jeśli obliczenia wskazują, że stos się nie mieści, wybierz większy plan zamiast obchodzić ograniczenie optymalizacją: rzeczywisty koszt VPS pokazuje, ile miesięcznie są warte dodatkowe gigabajty.
Dwie zasady pomagają zachować poprawność obliczeń. Ustaw limit pamięci dla każdej usługi, aby pojedynczy proces zużywający nadmierną ilość pamięci nie wyczerpał zasobów całego serwera. Nie wykorzystuj całego budżetu, ponieważ docker compose build i pg_dump również potrzebują pamięci w najgorszym momencie. Limity pamięci w Docker Compose zawiera składnię oraz opisuje typowe pułapki.
Dlaczego kontener kończy działanie z kodem 137?
Przyczyną jest przerwanie procesu przez jądro systemu. Kod 137 to suma 128 oraz 9, gdzie sygnał 9 oznacza SIGKILL. Kontener zażądał więcej pamięci, niż mu przydzielono, co spowodowało interwencję mechanizmu out of memory (OOM) killer.
CONTAINER ID IMAGE STATUS
9f2c1a4d7b3e postgres:16 Exited (137) 4 minutes agoPotwierdź przyczynę zamiast zgadywać:
docker inspect my-db | grep -i oomkilled
sudo journalctl -k | grep -i "out of memory""OOMKilled": true oznacza, że kontener osiągnął limit własnej grupy cgroup, a dziennik jądra wskazuje proces, który został wybrany do zakończenia:
Memory cgroup out of memory: Killed process 2417 (postgres) total-vm:1284416kBJest to sytuacja korzystna, ponieważ skutki awarii ograniczają się do jednego kontenera. Sytuacja niebezpieczna występuje, gdy kontener nie posiada żadnego limitu. Bez ograniczeń jego pułapem jest zasób całego serwera, więc wyciek pamięci w jednej usłudze doprowadzi do wyczerpania zasobów hosta, a jądro wybierze ofiarę na podstawie rozmiaru w całym systemie. Wpis w dzienniku traci przedrostek Memory cgroup i przyjmuje postać Out of memory: Killed process 2417 (postgres). Wybranym procesem jest często baza danych, podczas gdy kontener, w którym wystąpił wyciek, nadal działa. Dlatego limit dla każdej usługi jest ważniejszy niż precyzyjne określenie wartości pojedynczego ograniczenia.
Swap zmienia czas reakcji, a nie matematykę zużycia pamięci. Większość obrazów VPS jest dostarczana bez partycji swap. Sprawdź to za pomocą swapon --show, które nie wyświetli żadnych danych, jeśli swap nie istnieje. Plik wymiany daje jądru miejsce na przeniesienie nieaktywnych stron pamięci, co zapewnia czas na wykrycie problemu.
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
free -hfree -h powinno teraz pokazywać niezerową wartość w wierszu Swap. Swap nie zwiększa ilości pamięci RAM. Serwer pod stałym obciążeniem pamięci staje się na tyle wolny, że połączenie SSH w celu naprawy może być niemożliwe, dlatego traktuj swap jako bufor alarmowy i zadbaj o odpowiednie limity.
Dlaczego UFW nie blokuje opublikowanego portu Docker?
Ruch sieciowy nigdy nie dociera do łańcucha chronionego przez UFW. Gdy port jest publikowany za pomocą -p 5432:5432 lub wpisu w pliku compose ports:, demon zapisuje regułę DNAT (destination network address translation) w tablicy nat oraz regułę akceptacji we własnym łańcuchu DOCKER. Pakiet skierowany do kontenera jest przekazywany bezpośrednio do niego, z pominięciem dostarczenia do hosta. W rezultacie ruch jest obsługiwany w ścieżce FORWARD i nigdy nie przechodzi przez reguły INPUT zdefiniowane w UFW.
Można to zaobserwować na serwerze:
sudo ufw status | grep 5432
sudo iptables -t nat -L DOCKER -n | grep 5432UFW może wyświetlać 5432 DENY IN Anywhere, podczas gdy tablica nat zawiera regułę DNAT tcp ... to:172.18.0.2:5432 dla tego samego portu. Z innej maszyny nc -vz your.server.ip 5432 nadal nawiązuje połączenie. Baza danych jest dostępna z publicznego Internetu, mimo że zapora sieciowa wskazuje na brak takiej możliwości.
Rozwiązaniem jest ograniczenie publikacji portów. Kontenery w ramach jednego projektu compose współdzielą sieć i komunikują się za pomocą nazw usług. Baza danych obsługująca wyłącznie aplikację obok nie wymaga wpisu ports:. W przypadku konieczności dostępu lokalnego, należy powiązać publikację z interfejsem loopback:
services:
db:
image: postgres:16
ports:
- "127.0.0.1:5432:5432"Po wykonaniu docker compose up -d, nc -vz your.server.ip 5432 z zewnątrz kończy się niepowodzeniem, a psql -h 127.0.0.1 -p 5432 na serwerze nadal działa poprawnie. W poprawnie skonfigurowanym stosie usług tylko reverse proxy publikuje porty, zazwyczaj 80 oraz 443. Artykuł Dlaczego opublikowane porty Docker omijają UFW opisuje łańcuch DOCKER-USER dla przypadków, w których publikacja portu jest niezbędna przy jednoczesnym zachowaniu filtrowania, natomiast Podstawy zapory sieciowej UFW omawia reguły hosta działające na niższym poziomie.
Dlaczego moje kontenery znikają po restarcie?
Ponieważ nie otrzymały polecenia powrotu. Kontener jest tworzony z polityką restartu no, jeśli nie ustawiono inaczej, więc po restarcie pozostaje zatrzymany, a daemon nie podejmuje żadnych działań. Restart na VPS nie jest rzadkością: aktualizacje jądra z unattended-upgrades, prace konserwacyjne dostawcy oraz wspomniana wyżej sekwencja OOM kończą się restartem.
Muszą zostać spełnione dwa warunki. Daemon musi uruchamiać się podczas startu systemu:
systemctl is-enabled dockerPolecenie to zwraca enabled w standardowej instalacji Ubuntu. Następnie każda usługa wymaga odpowiedniej polityki:
services:
app:
image: ghcr.io/example/app:1.4
restart: unless-stoppedOpcja unless-stopped przywraca kontener po restarcie i uwzględnia kontenery zatrzymane celowo. Opcja always restartuje również te kontenery, które zostały zatrzymane ręcznie, gdy tylko daemon zostanie zrestartowany, co bywa zaskoczeniem podczas debugowania. Sama edycja pliku nie wystarcza, ponieważ polityka restartu jest ustalana w momencie tworzenia kontenera. Należy wykonać docker compose up -d, aby kontener został utworzony ponownie, a następnie sprawdzić bieżącą wartość:
docker inspect my-app | grep -A3 RestartPolicyNastępnie należy celowo zrestartować serwer i wykonać docker compose ps w katalogu projektu. Stos, który przetrwa planowany restart, przetrwa również ten nieplanowany. Jeśli stos wymaga gwarancji kolejności uruchamiania lub wykonania jednorazowego zadania podczas startu, lepszym narzędziem jest jednostka systemd: uruchamianie Docker Compose podczas startu zawiera odpowiedni plik jednostki. Aby sprawdzić, czy kontener, który powrócił, rzeczywiście działa poprawnie, należy dodać kontrole stanu (healthchecks) w Compose.
Dlaczego dysk VPS jest pełny?
Ponieważ Docker przechowuje wszystko, dopóki nie zostanie mu wskazane, aby tego nie robił. Każdy pobrany tag obrazu, każdy zatrzymany kontener, każdy anonimowy wolumen pozostawiony po ponownym utworzeniu oraz każda warstwa pamięci podręcznej kompilacji pozostają na dysku. Większy dysk tylko odsuwa problem w czasie. Nawet dysk SSD o pojemności 160 GB w najmniejszym planie SSD Nodes (strona z cenami sprawdzona 2026-10-11) zapełni się w ten sam sposób na serwerze, który co tydzień pobiera i buduje obrazy, a mniejszy główny system plików szybciej doprowadzi do niedostępności usługi.
Pełny dysk nie wygląda jak awaria systemu. W ciągu tej samej godziny pojawiają się no space left on device z kontenera, z apt, z journald oraz z docker pull. PostgreSQL przestaje przyjmować zapisy. Serwer nadal działa, przez co problem trudniej zauważyć niż pętlę ponownych uruchomień.
Najpierw sprawdź stan, zanim coś usuniesz:
docker system df
df -h /docker system df dzieli całkowite zużycie na obrazy, kontenery, wolumeny lokalne i pamięć podręczną kompilacji, a obok każdej kategorii wyświetla kolumnę RECLAIMABLE. Na serwerze, na którym budowane są własne obrazy, pamięć podręczna kompilacji jest zwykle największą pozycją.
docker image prune -a
docker builder prune
docker system dfdocker image prune -a usuwa każdy obraz, którego nie używa żaden kontener. docker builder prune czyści pamięć podręczną kompilacji. Obie operacje są bezpieczne podczas działania usług, ponieważ elementy używane są pomijane. Niebezpieczne jest natomiast docker system prune --volumes. Najpierw usuwa zatrzymane kontenery, a następnie każdy anonimowy wolumen, którego nie używa już żaden kontener. Stos zatrzymany na weekend ma dokładnie taką strukturę. Jeśli baza danych przechowywała dane w anonimowym wolumenie, czyli w wolumenie tworzonym przez Docker, gdy obraz deklaruje wolumen, a plik compose niczego w tym miejscu nie montuje, dane zostaną usunięte razem z nim. Wolumeny nazwane pozostają po wykonaniu tego polecenia, ale docker volume prune --all usuwa również nieużywane wolumeny nazwane. Przed użyciem któregokolwiek z tych flag przeczytaj porównanie bind mounts i wolumenów nazwanych i najpierw wykonaj kopię zapasową.
Logi kontenerów są mniej widocznym źródłem przyrostu danych. Domyślny sterownik json-file nie ma limitu rozmiaru, dlatego jeden kontener generujący dużo komunikatów może zapisać gigabajty danych w /var/lib/docker/containers. Ustaw limit dla każdego kontenera w /etc/docker/daemon.json:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}Zastosuj zmianę za pomocą sudo systemctl restart docker. Polecenie ponownie uruchamia kontenery, dlatego wybierz odpowiedni moment. Limit dotyczy kontenerów utworzonych po zmianie. Uruchomione kontenery trzeba więc utworzyć ponownie za pomocą docker compose up -d --force-recreate, a następnie sprawdzić:
docker inspect my-app | grep -A5 LogConfig
sudo du -sh /var/lib/docker/containersDane wyjściowe inspect powinny wskazywać ustawioną wartość max-size. Jeśli wartość jest pusta, ten kontener został utworzony przed zmianą i nadal zapisuje dane bez limitu.
Nawyki utrzymujące mały serwer Docker w dobrej kondycji
Żaden z poniższych punktów nie wymaga panelu sterowania ani nauki obsługi dodatkowych narzędzi.
- Uruchamiaj
docker system dforazdf -h /pierwszego dnia każdego miesiąca. Dwa polecenia, trzydzieści sekund pracy i widać trendy na długo przed wystąpieniem awarii. - Przypisz każdej usłudze limit pamięci, nawet tym, które wydają się niewielkie. Limit sprawia, że awaria ogranicza się do restartu jednego kontenera, zamiast wpływać na cały host.
- Monitoruj serwer z zewnątrz, aby otrzymywać powiadomienia o wyczerpywaniu się pamięci lub miejsca na dysku, zanim zareaguje kernel. Uptime Kuma działa w kontenerze i w stanie spoczynku zużywa około 95 MB.
- Twórz kopie zapasowe wolumenów, a nie kontenerów. Kontener jest elementem tymczasowym, wolumen nie. Kopie zapasowe restic na VPS obejmują harmonogram oraz test przywracania danych.
- Przypinaj tagi obrazów w pliku compose i aktualizuj je w wybranym przez siebie dniu. Przy użyciu
latest, wersja pobrana podczas kolejnegodocker compose pullbędzie tą, która została wydana danego ranka.
Mały serwer VPS z Dockerem pozostaje stabilny przez lata, jeśli cztery parametry mieszczą się w normie: budżet pamięci, lista opublikowanych portów, polityka restartu dla każdej usługi oraz ilość wolnego miejsca na dysku. Wszystko inne to ten sam Docker, którego używasz lokalnie.
FAQ
Ile pamięci RAM jest potrzebne do uruchomienia Docker na VPS?
Sam Docker wymaga niewiele zasobów. daemon i containerd zajmują łącznie około 100 MB, a pozostałe wymagania wynikają z uruchomionych kontenerów. Najpierw należy uwzględnić pamięć dla hosta: 768 MB na 2048 MB dostępnych na system operacyjny, daemon i zapas, co pozostawia 1280 MB dla kontenerów. Baza danych zajmująca 512 MB, reverse proxy zajmujące 128 MB oraz dwie małe aplikacje mieszczą się w tym limicie. Rzeczywiste zużycie własnego stosu należy zmierzyć za pomocą docker stats --no-stream, zamiast opierać się na opublikowanych wartościach.
Czy można uruchomić Docker na VPS z 1 GB pamięci?
Tak, w przypadku jednego lub dwóch lekkich kontenerów. Przed rozpoczęciem należy dodać plik wymiany. Po uruchomieniu systemu operacyjnego i Docker daemon znika mniej więcej połowa zasobów VPS z 1 GB, co pozostawia miejsce na małą aplikację i reverse proxy, ale nie na bazę danych pod rzeczywistym obciążeniem. Budowanie obrazów na serwerze o takiej konfiguracji zakończy się niepowodzeniem albo spowoduje zakończenie działania innego procesu. Obrazy należy budować na innym hoście, a następnie pobierać gotowy obraz.
Czy UFW chroni kontener Docker?
Nie dotyczy to opublikowanych portów. Docker tworzy własne reguły DNAT i przekazywania, dlatego pakiet skierowany do opublikowanego portu kontenera jest przekazywany do kontenera zamiast dostarczany do hosta, a reguły INPUT zarządzane przez UFW go nie widzą. ufw deny 5432 może działać, mimo że ten port odpowiada na żądania z Internetu. Port należy opublikować na loopback za pomocą 127.0.0.1:5432:5432, pozostawić usługi wewnętrzne nieopublikowane albo filtrować ruch w łańcuchu DOCKER-USER.
Czy kontenery uruchomią się ponownie po restarcie VPS?
Tylko jeśli zostały utworzone z użyciem polityki restartu. Należy ustawić restart: unless-stopped dla każdej usługi, uruchomić docker compose up -d, aby kontenery zostały odtworzone z tą polityką, a następnie potwierdzić, że systemctl is-enabled docker wyświetla enabled. Następnie należy celowo uruchomić ponownie system i sprawdzić docker compose ps. Polityka restartu, której nigdy nie przetestowano, nie jest sprawdzoną polityką restartu.
Jak często należy usuwać obrazy Docker?
W przypadku większości małych serwerów wystarczy raz w miesiącu albo wtedy, gdy docker system df zgłasza możliwe do odzyskania miejsce, którego zaczyna brakować. docker image prune -a i docker builder prune są bezpieczne podczas działania usług, ponieważ używane obrazy i dane cache są pomijane. Należy unikać docker system prune --volumes, chyba że dokładnie wiadomo, które wolumeny nie mają odwołań, ponieważ polecenie usuwa anonimowe wolumeny każdego stosu, który akurat jest zatrzymany, a docker volume prune --all usuwa również nieużywane wolumeny nazwane.