Docker: jak zwolnić miejsce na dysku VPS
Sprawdź zużycie przestrzeni poleceniem docker system df. Dowiedz się, jak bezpiecznie usunąć nieużywane obrazy, kontenery i cache, unikając utraty danych z wolumenów.
Sprawdź, co zajmuje miejsce na dysku, zanim cokolwiek usuniesz
Docker zajmuje miejsce na dysku VPS w czterech obszarach: obrazy, zatrzymane kontenery, pamięć podręczna budowania (build cache) oraz wolumeny lokalne. Najpierw uruchom docker system df, aby ustalić, który z nich zajmuje przestrzeń, a następnie wykonaj najbardziej precyzyjne czyszczenie. Kolejność ma znaczenie, ponieważ ostatnie polecenie w tym przewodniku, docker volume prune -a, usuwa dane bez możliwości ich przywrócenia.
Zacznij od systemu plików, a nie od Dockera.
df -h /
sudo du -xh --max-depth=1 /var/lib/docker | sort -h
sudo du -xh --max-depth=1 /var/lib/containerd | sort -hdf pokazuje skalę problemu. du wskazuje, gdzie zniknęło miejsce. Flaga -x ogranicza du do jednego systemu plików, dzięki czemu nie podąża za punktami montowania do oddzielnych wolumenów i nie zlicza ich dwukrotnie. Istotne katalogi zależą od backendu pamięci masowej. W świeżej instalacji Docker Engine 29.0 lub nowszej, domyślnie używany jest magazyn obrazów containerd, a zawartość obrazów i migawki kontenerów znajdują się w /var/lib/containerd, dlatego uwzględniono drugą linię du. Niezależnie od backendu, ważne są dwa katalogi w /var/lib/docker: volumes przechowuje dane wolumenów, a containers przechowuje metadane kontenerów i pliki dzienników. Host zaktualizowany ze starszej wersji Dockera zachowuje klasyczny układ overlay2 do momentu zmiany, a w tym układzie istotne są trzy kolejne: overlay2 przechowuje warstwy obrazów i kontenerów, buildkit przechowuje pamięć podręczną budowania, a image przechowuje metadane warstw. docker info | grep -i driver-type wyświetla io.containerd.snapshotter.v1 w przypadku magazynu obrazów containerd i nic w przypadku overlay2. Magazyn obrazów containerd przechowuje zarówno skompresowaną, jak i rozpakowaną kopię każdej warstwy, dlatego te same obrazy zajmują więcej miejsca niż w overlay2.
Uwaga dotycząca sudo oraz symboli wieloznacznych powłoki, ponieważ jest to częsta przyczyna strat czasu. /var/lib/docker jest własnością root i nie jest dostępny do odczytu dla zwykłego użytkownika, więc ls /var/lib/docker zwraca Permission denied. Polecenie typu sudo du -sh /var/lib/docker/* również zakończy się niepowodzeniem, ponieważ powłoka rozwija *, zanim sudo zostanie uruchomione, a powłoka nie ma uprawnień do odczytu tego katalogu. Każde poniższe polecenie używa find lub --max-depth zamiast symboli wieloznacznych właśnie z tego powodu.
Teraz widok z perspektywy Dockera.
docker system dfTYPE TOTAL ACTIVE SIZE RECLAIMABLE
Images 24 6 12.4GB 8.91GB (71%)
Containers 31 6 1.42GB 1.39GB (97%)
Local Volumes 14 5 6.03GB 4.11GB (68%)
Build Cache 212 0 9.87GB 9.87GBPowyższe liczby pochodzą z jednej maszyny i nie odnoszą się do Twojej. Zwróć uwagę na strukturę danych. TOTAL zlicza obiekty, ACTIVE zlicza te aktualnie używane, a RECLAIMABLE to szacunkowa ilość miejsca, którą Docker może odzyskać po wyczyszczeniu danej kategorii.
Dwie kwestie dotyczące RECLAIMABLE często zaskakują użytkowników. Zlicza ono współdzielone warstwy obrazów dla każdego obrazu, który z nich korzysta, więc wiersz obrazów zazwyczaj obiecuje więcej miejsca, niż faktycznie zostanie odzyskane. Ponadto nigdy nie uwzględnia plików dzienników kontenerów, ponieważ Docker nie traktuje plików dziennika jako obiektów możliwych do usunięcia. Jeśli du wskazuje katalog znacznie większy niż wynika to z docker system df, przyczyną są pliki dzienników; poniżej znajduje się sekcja na ten temat.
Dodaj -v, aby uzyskać szczegółowy podział na obiekty.
docker system df -vTo dzieli podsumowanie na sekcje według typu obiektu. Sekcja obrazów dodaje kolumny SHARED SIZE oraz UNIQUE SIZE, dzięki czemu można sprawdzić, jaki jest rzeczywisty koszt pojedynczego obrazu. Sekcja wolumenów dodaje licznik LINKS, który określa liczbę kontenerów podłączonych do danego wolumenu. Pamiętaj o LINKS, ponieważ wartość 0 oznacza, że żaden kontener nie korzysta z wolumenu, a jest to warunek początkowy dla każdego polecenia czyszczenia wolumenów.
Obrazy osierocone (dangling) a obrazy nieużywane
Te dwa pojęcia wydają się zamienne, lecz takie nie są. Filtry działają odmiennie, ponieważ obiekty te różnią się od siebie.
Obraz osierocony (dangling) to obraz bez przypisanej etykiety (tag). W poleceniu docker images widnieje on jako <none>. Taki obraz powstaje przy każdej przebudowie: docker build -t myapp:latest . przenosi etykietę myapp:latest na nowy obraz, a stary obraz zachowuje wszystkie swoje warstwy, tracąc przy tym nazwę. Żaden obiekt się do niego nie odwołuje i nic nie usuwa go automatycznie.
Obraz nieużywany to dowolny obraz, z etykietą lub bez, do którego nie odwołuje się obecnie żaden kontener. Obraz postgres:16 pobrany w zeszłym miesiącu, do którego nie odwołuje się żaden kontener (uruchomiony lub zatrzymany), jest nieużywany, ale nie jest osierocony.
docker image prune # dangling images only
docker image prune -a # every image no container refers toDrugie polecenie najpierw wyświetla zapytanie.
WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N]Należy uważnie przeczytać to zapytanie. Sformułowanie „powiązane z nimi” oznacza istniejący obiekt kontenera, uruchomiony lub zatrzymany. Jeśli wykonano docker compose down, kontenery zostały usunięte, więc każdy obraz używany przez te usługi jest teraz nieużywany, a -a usunie je wszystkie. Nie traci się niczego, czego nie można odzyskać, jednak kolejne docker compose up -d spowoduje ponowne pobranie lub przebudowanie całości, co na małym VPS wiąże się z kosztami transferu i czasem budowania. Jest to jeden z praktycznych powodów, dla których warto wiedzieć co usuwa docker compose down, a co pozostawia stop przed wykonaniem operacji czyszczenia (prune).
Filtr pozwala wykluczyć z zakresu działania niedawno utworzone obrazy.
docker image prune -a --filter "until=240h"To polecenie usuwa nieużywane obrazy utworzone ponad 240 godzin (10 dni) temu, pozostawiając nowsze bez zmian. Wartość until przyjmuje ciąg czasu w formacie Go, taki jak 240h, lub bezwzględny znacznik czasu, na przykład 2026-08-01T00:00:00.
Czym jest pamięć podręczna budowania i dlaczego zajmuje tak dużo miejsca
BuildKit to silnik budowania używany domyślnie przez Docker w docker build oraz docker compose build od wersji Docker Engine 23.0. Przechowuje on w pamięci podręcznej wynik każdego kroku każdego pliku Dockerfile, a w klasycznym układzie overlay2 przechowuje tę pamięć w /var/lib/docker/buildkit. Dzięki tej pamięci podręcznej kolejne budowanie kończy się w kilka sekund, więc spełnia ona swoje zadanie. Docker Engine domyślnie uruchamia proces usuwania nieużywanych danych (garbage collection): pamięć podręczna nieużywana przez 60 dni jest usuwana, a pozostała część jest przycinana dopiero po przekroczeniu limitów wyznaczonych przez Docker Engine na podstawie rozmiaru dysku. Na małym serwerze VPS może to oznaczać, że dysk jest już niemal całkowicie zapełniony. Jeśli zbudujesz ten sam obraz pięćdziesiąt razy, używając kroku COPY, który za każdym razem się zmienia, w systemie pozostanie pięćdziesiąt zestawów warstw, dopóki nie zadziała mechanizm czyszczenia.
Pamięć podręczna budowania jest niewidoczna dla docker image prune. Jest to oddzielny typ obiektu z własnym poleceniem.
docker builder prune # dangling cache
docker builder prune -a # all unused cache
docker builder prune --filter until=168h # cache untouched for 7 daysŻadne z tych działań nie wpływa na obrazy ani dane użytkownika. Jedynym kosztem wyczyszczenia pamięci podręcznej budowania jest to, że kolejne budowanie potrwa dłużej. Na serwerze VPS, gdzie obrazy są regularnie przebudowywane, Build Cache często zajmuje najwięcej miejsca w docker system df, co czyni ją najbezpieczniejszym dużym elementem do usunięcia.
Polecenia prune, uszeregowane od bezpiecznych do destrukcyjnych
Należy przechodzić przez tę listę, zatrzymując się, gdy df -h / odzyska sprawność. Każde polecenie po zakończeniu wyświetla linię Total reclaimed space:.
docker container pruneusuwa zatrzymane kontenery. Ich warstwy zapisu również są usuwane, więc wszelkie dane zapisane przez kontener poza wolumenem zostaną utracone. Wolumeny pozostają nienaruszone.docker image pruneusuwa wyłącznie nieużywane (dangling) obrazy. Jest to najbezpieczniejsze polecenie dotyczące obrazów.docker builder pruneusuwa nieużywaną pamięć podręczną budowania (build cache). Kosztem jest konieczność powolnego budowania w przyszłości.docker image prune -ausuwa każdy obraz, do którego nie odwołuje się żaden kontener. Kosztem jest konieczność ponownego pobrania lub zbudowania obrazu.docker system prunewykonuje trzy pierwsze operacje jednocześnie i dodaje usuwanie nieużywanych sieci.docker volume pruneusuwa nieużywane anonimowe wolumeny.docker volume prune -ausuwa nieużywane wolumeny, w tym wolumeny nazwane. Jest to polecenie, które usuwa bazy danych.
docker system prune przed uruchomieniem informuje o swoim zakresie działania.
WARNING! This will remove:
- all stopped containers
- all networks not used by at least one container
- all dangling images
- unused build cache
Are you sure you want to continue? [y/N]Wolumeny zostały celowo pominięte w tej liście. Dodanie --volumes przywraca anonimowe wolumeny do zakresu działania. Dodanie -a rozszerza krok dotyczący obrazów z samych nieużywanych (dangling) do wszystkich nieużywanych obrazów. Pełne polecenie docker system prune -a --volumes -f na serwerze produkcyjnym to sposób, w jaki użytkownicy tracą dane podczas próby zwolnienia miejsca.
Dlaczego czyszczenie wolumenów usuwa bazę danych
Tę sekcję należy przeczytać dwukrotnie.
Wolumen jest uznawany za nieużywany, gdy nie jest do niego podłączony żaden kontener. To jedyne kryterium. Docker nie sprawdza, czy wolumen jest pusty, czy plik compose nadal go deklaruje, ani czy zawiera jedyną kopię bazy danych. LINKS 0 w docker system df -v oznacza nieużywany, a docker volume prune -a traktuje każdy nieużywany wolumen jako przeznaczony do usunięcia, chyba że filtr label wyklucza go z operacji.
Wykonanie dwóch standardowych czynności jedna po drugiej prowadzi do utraty danych. Uruchomienie docker compose down w celu czystego restartu stosu usuwa kontenery, pozostawiając nazwane wolumeny na miejscu, zgodnie z dokumentacją. Wolumen Postgres pozostaje wtedy niepodłączony. Dziesięć minut później uruchomienie docker volume prune -a w celu zwolnienia miejsca powoduje usunięcie bazy danych. Oba polecenia zadziałały poprawnie. Sekwencja ta doprowadziła do zniszczenia danych.
Od wersji Docker Engine 23.0 (wersja API 1.42) podstawowe polecenie ma węższy zakres działania niż wcześniej.
WARNING! This will remove anonymous local volumes not used by at least one container.Wolumen anonimowy to taki, który Docker utworzył automatycznie, zazwyczaj dlatego, że obraz deklaruje VOLUME, a użytkownik nie nadał mu nazwy. Zazwyczaj przechowują one dane, których nie trzeba zachowywać. Wolumen nazwany, zdefiniowany w pliku compose, jest usuwany tylko po dodaniu flagi -a. Starsze wersje Docker usuwały oba typy wolumenów za pomocą podstawowego polecenia, dlatego nie należy polegać na nawykach wyrobionych na systemach, które zostały w międzyczasie zaktualizowane. Różnica staje się zrozumiała dopiero po zapoznaniu się z informacją czym różnią się wolumeny nazwane od bind mounts, ponieważ bind mount nie jest wolumenem Docker i żadne polecenie prune go nie usunie.
Przed usunięciem należy sprawdzić stan zasobów. Zamień myapp_pgdata na nazwę wolumenu, który jest weryfikowany.
docker volume ls -f dangling=true
docker volume inspect myapp_pgdata
sudo ls -la /var/lib/docker/volumes/myapp_pgdata/_dataFiltr dangling=true dla wolumenu oznacza brak odniesień, a nie pustą zawartość. Polecenie _data wyświetla faktyczną zawartość. Jeśli wewnątrz znajduje się katalog pgdata lub mysql, należy przerwać operację i wykonać kopię zapasową przed podjęciem dalszych kroków. Do analogicznego zniszczenia danych prowadzi docker compose down -v, które usuwa nazwane wolumeny zadeklarowane w pliku compose, z wyjątkiem tych oznaczonych jako external, nie prosząc przy tym o potwierdzenie.
Wolumen jest jedynym elementem na hoście Docker, którego nie można odtworzyć poprzez przebudowanie kontenera. Dlatego dane wolumenów powinny być częścią kopii zapasowej restic wykonywanej poza serwerem, gdzie błędnie wpisana flaga nie może ich usunąć.
Gdy czyszczenie nie pomaga: pliki dziennika kontenerów
Wszystko zostało wyczyszczone, docker system df nie wykazuje prawie żadnych danych możliwych do odzyskania, a dysk nadal jest pełny. Sprawdź dzienniki.
sudo find /var/lib/docker/containers -name '*-json.log' -exec du -h {} + | sort -h | tail -10Każdy kontener zapisuje swoje standardowe wyjście i standardowy błąd do pliku JSON w /var/lib/docker/containers/. W domyślnej instalacji max-size nie jest ustawione, co oznacza brak limitów. W rezultacie kontener zablokowany w pętli awarii zapisuje dane, aż partycja zostanie zapełniona. Żadne polecenie czyszczenia nie usuwa tych plików, ponieważ kontenery, które je generują, są uruchomione, co z definicji wyklucza je z procesu usuwania.
Nie usuwaj pliku. Wykonanie rm na otwartym pliku dziennika nic nie zwolni, ponieważ Docker daemon nadal utrzymuje otwarty deskryptor pliku, a jądro systemu zachowuje przydzielone bloki do momentu zamknięcia tego uchwytu. df nie zmieni się w ogóle. Zamiast tego wykonaj obcięcie pliku (truncate), co zachowa ten sam i-węzeł (inode) i pozwoli demonowi kontynuować zapis.
sudo find /var/lib/docker/containers -name '*-json.log' -exec truncate -s 0 {} +
df -h /To rozwiązanie tymczasowe. docker logs dla tych kontenerów teraz nie zwraca nic, a pliki natychmiast zaczynają rosnąć ponownie. Właściwym rozwiązaniem jest rotacja, która została opisana w następnej sekcji.
Mierz przed i po, za każdym razem
Nigdy nie zgaduj, jaki efekt przyniosło czyszczenie. Pobierz odczyt, wykonaj polecenie, pobierz kolejny odczyt.
df -h /
docker system df
docker builder prune -f --filter until=168h
docker image prune -f
docker system df
df -h /Porównaj dwa wyjścia df. To jedyna liczba, która decyduje o tym, czy serwer nadal może obsługiwać ruch. docker system df wskazuje, który wiersz faktycznie uległ zmianie, a każde czyszczenie wyświetla własną wartość Total reclaimed space:.
Jeśli df nie uległo zmianie, a docker system df wskazuje na zwolnienie miejsca, oznacza to, że otwarty uchwyt pliku blokuje usunięte bloki, co jest problemem z plikiem dziennika opisanym powyżej. Jeśli obie wartości uległy zmianie, a dysk zapełnia się ponownie w ciągu doby, problemem jest przyrost danych, a nie ich usuwanie. Rozwiązaniem jest rotacja logów oraz zaplanowane zadanie.
Jak zapobiec ponownemu zapełnieniu dysku
Ogranicz rozmiar logów. Utwórz lub edytuj /etc/docker/daemon.json.
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}To ustawienie ogranicza logi każdego kontenera utworzonego po restarcie do 30 MB. Każda wartość w log-opts musi być ciągiem znaków, nawet jeśli jest liczbą. Przed restartem sprawdź poprawność składni pliku, ponieważ błędny daemon.json uniemożliwi uruchomienie demona i wyłączy wszystkie kontenery.
python3 -m json.tool /etc/docker/daemon.json
sudo systemctl restart docker
docker info | grep -i 'logging driver'docker info powinno teraz zwracać Logging Driver: json-file. Same limity są widoczne w sekcji LogConfig polecenia docker inspect dla kontenera utworzonego po restarcie. Jest to istotny szczegół: ustawienie to dotyczy tylko nowych kontenerów. Istniejące kontenery zachowują konfigurację, z którą zostały utworzone, dlatego należy je odtworzyć.
docker compose up -d --force-recreateTen sam limit można ustawić dla poszczególnych usług w pliku compose, co jest lepszym rozwiązaniem, gdy jedna generująca dużo logów usługa wymaga indywidualnego limitu.
services:
app:
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"Zaplanuj ograniczone czyszczenie. Raz w tygodniu, z zakresem ograniczonym do nieużywanych obrazów i starej pamięci podręcznej budowania. Nigdy nie umieszczaj -a ani --volumes w zadaniu harmonogramu, ponieważ zadanie uruchomione w trakcie przestoju stosu usunie obrazy tego stosu, a przy użyciu --volumes rozpocznie usuwanie danych.
sudo tee /etc/cron.weekly/docker-prune >/dev/null <<'EOF'
#!/bin/sh
docker image prune -f
docker builder prune -f --filter until=168h
EOF
sudo chmod +x /etc/cron.weekly/docker-prune
sudo /etc/cron.weekly/docker-pruneOstatnia linia uruchamia skrypt ręcznie, aby sprawdzić jego wynik przed automatycznym wykonaniem. Plik musi być wykonywalny, a jego nazwa nie może zawierać kropki, ponieważ run-parts pomija pliki niewykonywalne oraz te posiadające rozszerzenie.
Alarmuj o wolnym miejscu. Czyszczenie wykonywane po zapełnieniu dysku to działanie naprawcze. Alarm przy 80 procentach to profilaktyka.
usage=$(df --output=pcent / | tr -dc '0-9')
[ "$usage" -ge 80 ] && echo "root filesystem at ${usage} percent full"Umieść to w cronie, korzystając z używanego systemu powiadomień. Wolne miejsce to tylko połowa obrazu sytuacji, dlatego połącz alarm z monitorowaniem kondycji dysku na VPS, ponieważ awaria dysku i jego zapełnienie skutkują zatrzymaniem kontenerów, a wymagają odmiennych działań naprawczych.
Wszystkie powyższe kroki zakładają standardową instalację z głównym katalogiem danych w /var/lib/docker. Jeśli przeniesiono go za pomocą klucza data-root w daemon.json, należy podstawić własną ścieżkę w każdym poleceniu. W przypadku magazynu obrazów containerd, data-root nie przenosi danych obrazów i kontenerów w /var/lib/containerd, ponieważ ta lokalizacja jest określona przez root w /etc/containerd/config.toml. Poprawne zaplanowanie układu na nowym serwerze jest częścią konfiguracji Docker na VPS i znacznie łatwiej podjąć tę decyzję przed zgromadzeniem 40 GB danych kontenerów na niewłaściwej partycji.
FAQ
Czy docker system prune usuwa moje wolumeny?
Nie. Standardowe polecenie usuwa zatrzymane kontenery, nieużywane sieci, osierocone obrazy oraz nieużywaną pamięć podręczną budowania, a monit potwierdzenia wyszczególnia dokładnie te elementy. Wolumeny są uwzględniane tylko po dodaniu flagi --volumes, a od wersji Docker Engine 23.0 flaga ta obejmuje jedynie wolumeny anonimowe, a nie nazwane. Wolumeny nazwane są usuwane za pomocą docker volume prune -a oraz docker compose down -v. To właśnie te dwa polecenia wymagają ostrożności.
Dlaczego po uruchomieniu docker prune dysk nadal jest pełny?
Istnieją dwie typowe przyczyny. Pierwszą są pliki dzienników kontenerów w /var/lib/docker/containers/, których żadne polecenie prune nie usuwa i które rosną bez ograniczeń, dopóki nie zostanie skonfigurowane max-size. Drugą przyczyną jest usunięty plik, który nadal jest otwarty przez proces: jeśli usunięto dziennik za pomocą rm podczas pracy kontenera, demon utrzymuje deskryptor pliku, a jądro nie zwalnia bloków, przez co df nie wykazuje zmian. Należy porównać wyniki sudo du -xh --max-depth=1 /var/lib/docker oraz docker system df, aby ustalić, z którym przypadkiem mamy do czynienia.
Jaka jest różnica między docker image prune a docker image prune -a?
Standardowe polecenie usuwa tylko osierocone obrazy, czyli takie, które utraciły swój tag, co niemal zawsze wynika z ponownego budowania. Wariant -a usuwa każdy obraz, do którego nie odwołuje się żaden istniejący kontener, w tym obrazy z tagami pobrane celowo. Po wykonaniu docker compose down kontenery przestają istnieć, więc -a usunie również obrazy powiązane z tym stosem. Nic nie zostaje trwale utracone, ponieważ kolejne uruchomienie wymusi ponowne pobranie lub zbudowanie obrazów, jednak przy wolnym łączu oznacza to długi czas oczekiwania.
Jak zapobiec zapełnianiu dysku przez dzienniki Docker?
Należy ustawić max-size oraz max-file w sekcji log-opts w pliku /etc/docker/daemon.json, a następnie zrestartować demona za pomocą sudo systemctl restart docker. Ustawienie to dotyczy tylko kontenerów utworzonych po restarcie, dlatego uruchomione kontenery należy odtworzyć za pomocą docker compose up -d --force-recreate. Te same dwie opcje można ustawić dla każdej usługi w pliku compose w sekcji logging, co jest zalecane, gdy jedna usługa generuje znacznie więcej logów niż pozostałe.
Czy uruchamianie docker system prune w zadaniu cron jest bezpieczne?
Standardowe polecenie docker system prune -f jest bezpieczne na hoście, na którym wszystkie stosy są uruchomione, jednak usuwa ono zatrzymane kontenery, więc usunie również kontener zatrzymany celowo w celu późniejszego restartu. Bezpieczniejszym zadaniem zaplanowanym jest docker image prune -f wraz z docker builder prune -f --filter until=168h, co zwalnia dwa najszybciej rosnące zasoby i nie wpływa na wolumeny. Nigdy nie należy planować zadań -a ani --volumes.