Docker prune: як звільнити місце на VPS
Диск VPS заповнений через Docker? Перевірте образи, контейнери, кеш і томи, визначте джерело зайнятого місця та безпечно застосуйте потрібну prune-операцію.
Спочатку визначте, що використовує дисковий простір, а вже потім видаляйте непотрібні дані
Docker використовує дисковий простір на VPS у чотирьох місцях: images, зупинені контейнери, build cache і локальні volumes. Спочатку виконайте docker system df, щоб визначити, де саме використовується простір, а потім запустіть найточнішу команду prune, яка його звільнить. Порядок має значення, оскільки остання команда в цьому посібнику, docker volume prune -a, видаляє дані, і скасувати цю дію неможливо.
Почніть із файлової системи, а не з Docker.
df -h /
sudo du -xh --max-depth=1 /var/lib/docker | sort -h
sudo du -xh --max-depth=1 /var/lib/containerd | sort -hdf показує, наскільки критичною є ситуація. du показує, де саме використовується простір. Прапорець -x обмежує du однією файловою системою, тому команда не переходить через mount у окремий volume і не враховує його двічі. Важливість каталогів залежить від storage backend. У новій інсталяції Docker Engine 29.0 або новішої версії containerd image store використовується за замовчуванням, а вміст images і snapshots контейнерів зберігається в /var/lib/containerd. Саме тому потрібен другий рядок du. Незалежно від backend, важливі два каталоги в /var/lib/docker: volumes містить дані volumes, а containers — метадані контейнерів і log files. На host, оновленому зі старішої версії Docker, зберігається класична структура overlay2, доки ви не перемкнете storage backend. У цій структурі важливі ще три каталоги: overlay2 містить layers images і контейнерів, buildkit — build cache, а image — метадані layers. docker info | grep -i driver-type виводить io.containerd.snapshotter.v1 у containerd image store і нічого в overlay2. У containerd image store зберігаються як стиснена, так і розпакована копія кожного layer, тому ті самі images займають більше дискового простору, ніж у overlay2.
Окремо розглянемо sudo і shell wildcards, оскільки вони часто спричиняють проблеми. Каталог /var/lib/docker належить root і недоступний для читання звичайному користувачу, тому ls /var/lib/docker повертає Permission denied. Команда на кшталт sudo du -sh /var/lib/docker/* також завершується помилкою, оскільки shell розгортає * ще до запуску sudo, а shell не може прочитати цей каталог. Саме тому в усіх наведених нижче командах замість wildcard використовується find або --max-depth.
Тепер перегляньмо дані самого Docker.
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.87GBЦі значення отримано на одному конкретному комп’ютері, тому вони нічого не говорять про вашу систему. Важливо розуміти структуру результату. TOTAL рахує об’єкти, ACTIVE — об’єкти, які зараз використовуються, а RECLAIMABLE — оцінку Docker щодо простору, який можна звільнити командою prune для відповідного рядка.
У RECLAIMABLE є два моменти, які часто вводять в оману. Спільні image layers враховуються один раз для кожного image, який їх використовує, тому в рядку images зазвичай указано більше простору, ніж можна фактично звільнити. Крім того, RECLAIMABLE ніколи не враховує log files контейнерів, оскільки Docker не вважає log file об’єктом, який можна звільнити. Якщо du показує для каталогу значно більший розмір, ніж вказано в docker system df, причина полягає в log files. Нижче є окремий розділ про це.
Додайте -v, щоб отримати розподіл за окремими об’єктами.
docker system df -vЦя команда розділяє зведені дані на окремий розділ для кожного типу об’єктів. У розділі images додаються стовпці SHARED SIZE і UNIQUE SIZE, щоб можна було побачити фактичний розмір одного image. У розділі volumes додається лічильник LINKS — кількість контейнерів, підключених до цього volume. Запам’ятайте LINKS: значення 0 означає, що жоден контейнер не використовує volume. Саме з цієї умови починається виконання кожної команди очищення volumes.
Завислі та невикористані образи
Ці два терміни не є взаємозамінними. Фільтри працюють по-різному, оскільки йдеться про різні об’єкти.
Завислий образ — це образ без тегу. У docker images він відображається як <none>. Під час кожної перебудови створюється такий образ: docker build -t myapp:latest . переносить тег myapp:latest на новий образ, а старий образ зберігає всі свої шари, але втрачає ім’я. На нього нічого не посилається, і він не видаляється автоматично.
Невикористаний образ — це будь-який образ, тегований або нетегований, на який наразі не посилається жоден контейнер. Наприклад, postgres:16, завантажений минулого місяця, на який не посилається жоден запущений або зупинений контейнер, є невикористаним, але не завислим.
docker image prune # dangling images only
docker image prune -a # every image no container refers toСпочатку ця команда запитує підтвердження.
WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N]Уважно прочитайте цей запит. Фраза «пов’язані з ними» означає наявний об’єкт контейнера, запущений або зупинений. Якщо ви виконали docker compose down, контейнери видалено, тому кожен образ, який використовували ці сервіси, тепер є невикористаним, а -a видаляє їх усі. Ви не втрачаєте нічого, що неможливо відновити, але під час наступного docker compose up -d усі образи буде повторно завантажено або перебудовано. На невеликому VPS це потребує додаткового трафіку та часу на складання. Тому перед очищенням важливо знати що видаляє docker compose down, а що залишає запущеним stop.
Фільтр виключає з обробки нещодавно створені образи.
docker image prune -a --filter "until=240h"Ця команда видаляє невикористані образи, створені понад 240 годин (10 днів) тому, і залишає новіші образи. Значення until приймає рядок тривалості у форматі Go, наприклад 240h, або абсолютну мітку часу, наприклад 2026-08-01T00:00:00.
Що таке кеш збірки і чому він займає так багато місця
BuildKit — це builder, який Docker використовує за замовчуванням для docker build і docker compose build, починаючи з Docker Engine 23.0. Він кешує результат кожного кроку кожного Dockerfile, який обробляє. У класичній структурі overlay2 цей кеш зберігається в /var/lib/docker/buildkit. Саме завдяки кешу повторна збірка завершується за кілька секунд, тобто він працює як належить. Docker Engine за замовчуванням виконує для кешу garbage collection: кеш, який не використовували протягом 60 днів, видаляється, а решта очищається лише після перевищення лімітів, які Docker Engine визначає за розміром диска. На невеликому VPS це може означати, що диск уже майже повністю заповнений. Якщо зібрати той самий образ п’ятдесят разів із кроком COPY, який щоразу змінюється, до запуску очищення накопичиться п’ятдесят наборів шарів.
Кеш збірки не відображається в docker image prune. Це окремий тип об’єктів із власною командою.
docker builder prune # dangling cache
docker builder prune -a # all unused cache
docker builder prune --filter until=168h # cache untouched for 7 daysЖодна з цих операцій не впливає на ваші образи або дані. Єдина плата за очищення кешу збірки — наступна збірка один раз триватиме довше. На VPS, де образи регулярно збираються повторно, Build Cache часто є найбільшим рядком у docker system df, тому це найбезпечніший великий об’єкт для видалення.
Команди prune у порядку від безпечних до деструктивних
Виконуйте команди по черзі та зупиніться, щойно df -h / знову працюватиме нормально. Після завершення кожна команда виводить рядок Total reclaimed space:.
docker container pruneвидаляє зупинені контейнери. Їхні доступні для запису шари також видаляються, тому всі дані, записані контейнером за межами volume, буде видалено разом із контейнером. Volumes не змінюються.docker image pruneвидаляє лише dangling images. Це найбезпечніша команда для очищення images.docker builder pruneвидаляє dangling build cache. Єдиний наслідок — наступна збірка триватиме довше.docker image prune -aвидаляє всі images, на які не посилається жоден контейнер. Наслідком буде повторне завантаження або повторна збірка.docker system pruneвиконує перші три операції одночасно та додатково видаляє невикористовувані networks.docker volume pruneвидаляє невикористовувані anonymous volumes.docker volume prune -aвидаляє невикористовувані volumes, зокрема named volumes. Саме ця команда видаляє бази даних.
docker system prune перед запуском повідомляє власну область дії.
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]Volumes навмисно не включено до цього списку. Додавання --volumes включає anonymous volumes до області дії. Додавання -a розширює операцію з images: замість dangling images вона охоплює всі невикористовувані images. Повний docker system prune -a --volumes -f на production host — це спосіб втратити дані під час спроби звільнити місце.
Чому очищення томів видаляє вашу базу даних
Цей розділ варто прочитати двічі.
Том вважається невикористовуваним, якщо до нього не підключено жодного контейнера. Це єдина перевірка. Docker не перевіряє, чи порожній том, чи оголошений він у compose-файлі, або чи містить єдину копію вашої бази даних. LINKS 0 у docker system df -v означає «невикористовувані», а docker volume prune -a вважає кожен невикористовуваний том таким, що його можна видалити, якщо доданий вами фільтр label не виключає цей том.
Тепер виконайте дві звичайні дії одну за одною. Ви запускаєте docker compose down, щоб коректно перезапустити стек. Ця команда видаляє контейнери й залишає іменовані томи на місці, саме так, як зазначено в документації. Тепер ваш том Postgres не підключено до жодного контейнера. Через десять хвилин ви запускаєте docker volume prune -a, щоб звільнити місце, і база даних зникає. Обидві команди спрацювали правильно. Але їхня послідовність знищила дані.
Починаючи з Docker Engine 23.0 (API version 1.42), команда без додаткових параметрів має вужчу область дії, ніж раніше.
WARNING! This will remove anonymous local volumes not used by at least one container.Анонімний том створює Docker, зазвичай тому, що образ оголошує VOLUME, а ви не вказали для нього ім’я. У таких томах зазвичай зберігаються дані, які ви не планували зберігати. Іменований том, який ви вказали у compose-файлі, видаляється лише після додавання -a. Старі версії Docker видаляли обидва типи томів за допомогою команди без додаткових параметрів, тому не покладайтеся на звички, сформовані на сервері, який згодом було оновлено. Ця відмінність стає зрозумілою лише після того, як ви дізнаєтеся, чим іменовані томи відрізняються від bind mounts, оскільки bind mount взагалі не є томом Docker і жодна команда prune не торкнеться його.
Перевірте перед видаленням. Замініть myapp_pgdata на ім’я тому, який перевіряєте.
docker volume ls -f dangling=true
docker volume inspect myapp_pgdata
sudo ls -la /var/lib/docker/volumes/myapp_pgdata/_dataФільтр dangling=true для тому означає «не має посилань», а не «порожній». Перегляд _data покаже, що саме міститься всередині. Якщо ви знайшли там каталог pgdata або mysql, зупиніться та створіть копію, перш ніж продовжувати. Таке саме знищення може відбутися через docker compose down -v: ця команда видаляє іменовані томи, оголошені у compose-файлі, крім тих, що позначені як external, і нічого не запитує перед цим.
Том — це єдиний об’єкт на Docker host, який не можна відновити під час повторного розгортання. Саме тому дані томів потрібно зберігати в резервній копії restic, яка запускається поза сервером, куди помилково вказаний прапорець не зможе дістатися.
Коли нічого не видаляється: файли журналів контейнерів
Ви видалили всі непотрібні дані, docker system df майже нічого не показує для звільнення, а диск усе ще заповнений. Перевірте журнали.
sudo find /var/lib/docker/containers -name '*-json.log' -exec du -h {} + | sort -h | tail -10Кожен контейнер записує стандартний вивід і стандартний потік помилок у JSON-файл у каталозі /var/lib/docker/containers/. У типовій інсталяції параметр max-size не задано, тобто розмір журналу необмежений. Тому один контейнер, що застряг у циклі аварійного перезапуску, може записувати дані, доки розділ не заповниться. Команда prune не видаляє ці файли, оскільки контейнери, які їх створюють, запущені. За визначенням, такі контейнери не можна видалити цією командою.
Не видаляйте файл. Виконання rm для відкритого файлу журналу нічого не звільняє, оскільки daemon Docker все ще утримує відкритий файловий дескриптор, а ядро зберігає блоки виділеними, доки цей дескриптор не буде закрито. df зовсім не зменшиться. Натомість очистіть файл через truncate. Це збереже той самий inode і дасть daemon змогу продовжити запис.
sudo find /var/lib/docker/containers -name '*-json.log' -exec truncate -s 0 {} +
df -h /Це тимчасове рішення. docker logs для цих контейнерів тепер нічого не повертає, а файли одразу знову починають збільшуватися. Справжнє рішення — ротація журналів. Її розглянуто в наступному розділі.
Вимірюйте до і після кожної операції
Не здогадуйтеся, що саме зробила операція prune. Спочатку виконайте вимірювання, потім одну команду, а після цього повторіть вимірювання.
df -h /
docker system df
docker builder prune -f --filter until=168h
docker image prune -f
docker system df
df -h /Порівняйте два результати df. Лише це число визначає, чи продовжує сервер обслуговувати запити. Команда docker system df показує, який саме рядок змінився, а кожна операція prune виводить власне значення Total reclaimed space:.
Якщо df не змінилося, але docker system df повідомляє про звільнення місця, видалені блоки утримує відкритий дескриптор файлу. Це описана вище проблема з файлом журналу. Якщо змінилися обидва значення, але диск знову заповнюється протягом дня, проблема пов’язана зі зростанням даних, а не з очищенням. Потрібні ротація журналів і заплановане завдання.
Як запобігти повторному заповненню диска
Обмежте розмір журналів. Створіть або відредагуйте /etc/docker/daemon.json.
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}Це обмежить журнали кожного контейнера, створеного після перезапуску, до 30 MB. Кожне значення в log-opts має бути рядком, зокрема числові значення. Перевірте коректність синтаксичного аналізу файлу перед перезапуском, оскільки некоректний daemon.json повністю заблокує запуск daemon і разом із ним зупинить усі контейнери.
python3 -m json.tool /etc/docker/daemon.json
sudo systemctl restart docker
docker info | grep -i 'logging driver'Тепер docker info має показувати Logging Driver: json-file. Самі обмеження відображаються в розділі LogConfig файлу docker inspect для контейнера, створеного після перезапуску. Це важлива деталь: цей параметр застосовується лише до нових контейнерів. Наявні контейнери зберігають конфігурацію, з якою їх було створено, тому їх потрібно створити повторно.
docker compose up -d --force-recreateТаке саме обмеження можна задати для окремого сервісу у compose-файлі. Це кращий варіант, якщо один сервіс створює надто багато журналів і потребує окремого значення.
services:
app:
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"Налаштуйте вибіркове очищення. Запускайте його щотижня та обмежте dangling images і старий build cache. Ніколи не додавайте -a або --volumes до запланованого завдання, оскільки завдання, яке запуститься, коли stack вимкнено, видалить images цього stack, а з --volumes воно почне видаляти ваші дані.
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-pruneОстанній рядок запускає script вручну один раз, щоб ви побачили його вивід до першого автоматичного запуску. Файл має бути executable, а його ім’я не повинно містити крапку, оскільки run-parts пропускає все, що не є executable, а також усе, що має розширення.
Налаштуйте сповіщення про вільне місце. Очищення після заповнення диска — це відновлення. Сповіщення на рівні 80 відсотків — це профілактика.
usage=$(df --output=pcent / | tr -dc '0-9')
[ "$usage" -ge 80 ] && echo "root filesystem at ${usage} percent full"Додайте це до cron і використайте наявний notifier. Вільне місце — лише частина проблеми, тому поєднайте це сповіщення з моніторингом стану диска на VPS, оскільки несправний і повний диск зупиняють контейнери, але потребують різних способів усунення.
Усе описане вище передбачає стандартне встановлення з data root у /var/lib/docker. Якщо ви перенесли його за допомогою ключа data-root у daemon.json, замініть шлях у кожній команді. У сховищі images на containerd параметр data-root не переносить дані images і контейнерів у /var/lib/containerd, оскільки це розташування визначається параметром root у /etc/containerd/config.toml. Правильне налаштування цієї структури на новому сервері є частиною налаштування Docker на VPS, і визначити її заздалегідь значно простіше, ніж після того, як 40 GB контейнерів опиняться не в тому розділі.
FAQ
Чи видаляє docker system prune мої томи?
Ні. Звичайна команда видаляє зупинені контейнери, невикористовувані мережі, неприєднані образи та невикористовуваний кеш складання. У запиті на підтвердження перелічено саме цей набір. Томи обробляються лише після додавання --volumes. Починаючи з Docker Engine 23.0, цей прапорець стосується анонімних томів, а не іменованих. Іменовані томи видаляють команди docker volume prune -a і docker compose down -v. Саме з цими двома командами потрібно бути обережними.
Чому після запуску docker prune диск усе ще заповнений?
Є дві поширені причини. Перша — файли журналів контейнерів у /var/lib/docker/containers/. Жодна команда prune їх не обробляє, і вони зростають без обмежень, доки не налаштовано max-size. Друга — видалений файл, який процес усе ще тримає відкритим. Якщо під час роботи контейнера видалити журнал командою rm, daemon зберігає файловий дескриптор, а ядро не звільняє блоки. Тому df не показує змін. Порівняйте sudo du -xh --max-depth=1 /var/lib/docker із docker system df, щоб визначити, яка причина стосується вашого випадку.
У чому різниця між docker image prune і docker image prune -a?
Звичайна команда видаляє лише неприєднані образи, тобто образи, які втратили свій тег, майже завжди через повторне складання. Форма -a видаляє всі образи, на які не посилається жоден наявний контейнер, зокрема позначені тегами образи, які ви навмисно завантажили. Після виконання docker compose down контейнери видалено, тому -a також видалить образи цього стека. Дані не буде втрачено безповоротно: під час наступного запуску образи буде завантажено або зібрано повторно. Однак за повільного з’єднання це може тривати довго.
Як заборонити журналам Docker заповнювати диск?
У /etc/docker/daemon.json задайте max-size і max-file у розділі log-opts, а потім перезапустіть daemon командою sudo systemctl restart docker. Це налаштування застосовується лише до контейнерів, створених після перезапуску. Тому вже запущені контейнери потрібно створити повторно за допомогою docker compose up -d --force-recreate. Ті самі два параметри можна задати для кожного сервісу у compose-файлі під ключем logging. Це потрібно, якщо один сервіс створює значно більше журналів, ніж інші.
Чи безпечно запускати docker system prune із cron job?
Звичайна команда docker system prune -f безпечна на хості, де всі стеки постійно працюють. Проте вона видаляє зупинені контейнери. Тому буде видалено контейнер, який ви навмисно зупинили та планували запустити пізніше. Безпечніший запланований job — це docker image prune -f разом із docker builder prune -f --filter until=168h. Він звільняє два ресурси, які зростають найшвидше, і не може торкнутися томів. Ніколи не плануйте виконання -a або --volumes.