Docker prune: giải phóng dung lượng đĩa trên VPS
VPS đầy đĩa vì Docker? Xem image, container, build cache hay volume đang chiếm chỗ, rồi chạy lệnh prune hẹp nhất để dọn mà không mất dữ liệu.
Xác định thành phần đang chiếm dung lượng đĩa trước khi chạy prune
Docker chiếm dung lượng đĩa trên VPS ở 4 nơi: image, container đã dừng, build cache và volume cục bộ. Trước tiên hãy chạy docker system df để xác định thành phần nào đang chiếm dung lượng, sau đó chạy lệnh prune hẹp nhất có thể để giải phóng phần đó. Thứ tự rất quan trọng vì lệnh cuối trong hướng dẫn này, docker volume prune -a, sẽ xóa dữ liệu và không thể hoàn tác.
Hãy bắt đầu với filesystem, không phải 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 cho biết mức độ đầy của filesystem. du cho biết dung lượng đã được dùng ở đâu. Flag -x yêu cầu du chỉ làm việc trên một filesystem, không đi theo mount vào volume riêng và tính trùng dung lượng. Những thư mục cần kiểm tra phụ thuộc vào storage backend. Trên bản cài mới của Docker Engine 29.0 trở lên, containerd image store là mặc định. Nội dung image và snapshot của container nằm trong /var/lib/containerd, đó là lý do có dòng du thứ hai. Với cả hai backend, có 2 thư mục dưới /var/lib/docker cần chú ý: volumes chứa dữ liệu volume, còn containers chứa metadata của container và các file log. Host được nâng cấp từ Docker cũ vẫn giữ layout overlay2 classic cho đến khi bạn chuyển đổi. Với layout đó, cần chú ý thêm 3 thư mục: overlay2 chứa các layer của image và container, buildkit chứa build cache, còn image chứa metadata của layer. docker info | grep -i driver-type in io.containerd.snapshotter.v1 khi dùng containerd image store và không in gì khi dùng overlay2. Containerd image store giữ cả bản nén và bản đã giải nén của mỗi layer, nên cùng một bộ image sẽ tốn nhiều dung lượng đĩa hơn so với khi dùng overlay2.
Cần lưu ý về sudo và wildcard của shell vì chúng thường làm mất rất nhiều thời gian. /var/lib/docker thuộc sở hữu của root và user thông thường không thể đọc được, nên ls /var/lib/docker trả về Permission denied. Lệnh như sudo du -sh /var/lib/docker/* cũng thất bại vì shell sẽ mở rộng * trước khi sudo được chạy, trong khi shell không thể đọc thư mục đó. Mọi lệnh bên dưới đều dùng find hoặc --max-depth thay cho wildcard vì lý do này.
Bây giờ hãy xem thông tin do chính Docker cung cấp.
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.87GBCác số liệu này lấy từ một máy cụ thể và không cho biết tình trạng trên máy của bạn. Hãy xem cấu trúc của kết quả. TOTAL đếm tổng số object, ACTIVE đếm số object đang được sử dụng, còn RECLAIMABLE là ước tính của Docker về dung lượng có thể giải phóng từ dòng đó khi chạy prune.
Có 2 điểm về RECLAIMABLE thường gây nhầm lẫn. Nó tính các image layer dùng chung một lần cho mỗi image sử dụng layer đó, nên dòng image thường hứa hẹn nhiều dung lượng hơn thực tế có thể giải phóng. Nó cũng không bao giờ bao gồm file log của container vì Docker không xem file log là object có thể reclaim. Khi du báo một thư mục lớn hơn nhiều so với số liệu docker system df, nguyên nhân là các file log. Phần bên dưới sẽ nói về vấn đề này.
Thêm -v để xem chi tiết theo từng object.
docker system df -vKết quả được tách thành một phần cho từng loại object. Phần image thêm các cột SHARED SIZE và UNIQUE SIZE, giúp bạn biết chính xác một image chiếm bao nhiêu dung lượng. Phần volume thêm cột đếm LINKS, là số container đang gắn vào volume đó. Hãy nhớ LINKS vì giá trị 0 có nghĩa là không có container nào sử dụng volume, và đây là điều kiện mà mọi lệnh volume prune đều bắt đầu kiểm tra.
Phân biệt dangling image và unused image
Hai thuật ngữ này trông có vẻ thay thế cho nhau được, nhưng không phải vậy. Các bộ lọc hoạt động khác nhau vì chúng áp dụng cho các đối tượng khác nhau.
Dangling image là image không có tag. Nó hiển thị là <none> trong docker images. Mỗi lần rebuild, bạn tạo ra một image như vậy: docker build -t myapp:latest . chuyển tag myapp:latest sang image mới, còn image cũ giữ toàn bộ layer nhưng mất tên. Không có gì tham chiếu đến image đó và cũng không có cơ chế nào tự dọn nó.
Unused image là bất kỳ image nào, có tag hoặc không, mà hiện không có container nào tham chiếu đến. Một postgres:16 bạn đã pull tháng trước nhưng không có container nào tham chiếu đến, dù container đang chạy hay đã dừng, là unused và không phải dangling.
docker image prune # dangling images only
docker image prune -a # every image no container refers toLệnh thứ hai sẽ hỏi trước.
WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N]Đọc kỹ prompt đó. “Associated to them” nghĩa là một container object hiện có, đang chạy hoặc đã dừng. Nếu bạn chạy docker compose down, các container sẽ bị xóa. Khi đó, mọi image mà các service này đã dùng đều trở thành unused và -a sẽ xóa tất cả các image đó. Không mất dữ liệu nào mà bạn không thể lấy lại, nhưng lần docker compose up -d tiếp theo sẽ phải pull lại hoặc rebuild toàn bộ. Việc này tốn băng thông và thời gian build trên một VPS nhỏ. Đây là một lý do thực tế để biết docker compose down xóa gì và stop để lại gì đang chạy trước khi prune.
Bộ lọc sẽ loại các image mới khỏi phạm vi xử lý.
docker image prune -a --filter "until=240h"Lệnh này xóa các unused image được tạo từ hơn 240 giờ (10 ngày) trước và giữ lại các image mới hơn. Giá trị until nhận một chuỗi duration theo định dạng Go, chẳng hạn 240h, hoặc một timestamp tuyệt đối như 2026-08-01T00:00:00.
Build cache là gì và vì sao tăng quá lớn
BuildKit là builder mà Docker sử dụng mặc định cho docker build và docker compose build kể từ Docker Engine 23.0. Nó cache kết quả của từng bước trong mỗi Dockerfile mà nó chạy. Với layout overlay2 cổ điển, BuildKit lưu cache đó tại /var/lib/docker/buildkit. Cache giúp lần build thứ hai hoàn tất trong vài giây, nên nó đang hoạt động đúng. Docker Engine mặc định có chạy garbage collection cho cache này: cache không được sử dụng trong 60 ngày sẽ bị xóa. Phần còn lại chỉ được dọn khi vượt các giới hạn mà Docker Engine tính toán dựa trên dung lượng disk. Trên VPS nhỏ, điều này có thể xảy ra khi disk đã gần đầy. Nếu build cùng một image 50 lần với một bước COPY thay đổi mỗi lần, bạn sẽ giữ lại 50 bộ layer cho đến khi garbage collection bắt đầu.
Build cache không hiển thị trong docker image prune. Đây là một loại object riêng và có command riêng.
docker builder prune # dangling cache
docker builder prune -a # all unused cache
docker builder prune --filter until=168h # cache untouched for 7 daysKhông lệnh nào trong số này tác động đến image hoặc dữ liệu của bạn. Chi phí duy nhất khi xóa build cache là lần build tiếp theo sẽ chạy chậm một lần. Trên VPS thường xuyên rebuild image, Build Cache thường là mục lớn nhất trong docker system df. Vì vậy, đây thường là thứ lớn và an toàn nhất để xóa.
Các lệnh prune, sắp xếp từ an toàn đến có tính phá hủy
Thực hiện lần lượt từ trên xuống và dừng ngay khi df -h / hoạt động ổn định trở lại. Mỗi lệnh đều in một dòng Total reclaimed space: khi hoàn tất.
docker container prunexóa các container đã dừng. Writable layer của chúng cũng bị xóa, vì vậy mọi dữ liệu container ghi bên ngoài volume sẽ mất theo. Lệnh này không tác động đến volume.docker image prunechỉ xóa các image dangling. Đây là lệnh image an toàn nhất.docker builder prunexóa build cache dangling. Đổi lại, một lần build sẽ chạy chậm hơn.docker image prune -axóa mọi image không được container nào tham chiếu. Đổi lại, bạn phải pull lại hoặc build lại image.docker system prunethực hiện 3 bước đầu cùng lúc và xóa thêm các network không dùng.docker volume prunexóa các anonymous volume không dùng.docker volume prune -axóa mọi volume không dùng, bao gồm cả volume có tên. Đây là lệnh có thể xóa database.
docker system prune sẽ nêu phạm vi tác động của chính nó trước khi chạy.
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 được cố ý loại khỏi danh sách trên. Thêm --volumes sẽ đưa anonymous volume vào phạm vi xử lý. Thêm -a sẽ mở rộng bước xử lý image, từ chỉ image dangling sang mọi image không dùng. Chạy full docker system prune -a --volumes -f trên host production là cách khiến người dùng mất dữ liệu khi đang cố giải phóng dung lượng.
Vì sao prune volume xóa database của bạn
Đây là phần bạn nên đọc hai lần.
Một volume được tính là không được sử dụng khi không có container nào gắn vào nó. Đó là toàn bộ điều kiện kiểm tra. Docker không kiểm tra volume có rỗng hay không, file compose còn khai báo volume đó hay không, hoặc volume có chứa bản sao duy nhất của database hay không. LINKS 0 trong docker system df -v có nghĩa là không được sử dụng, còn docker volume prune -a xem mọi volume không được sử dụng là đối tượng có thể xóa, trừ khi một bộ lọc label do bạn thêm vào loại volume đó ra.
Bây giờ hãy đặt hai thao tác thông thường liên tiếp. Bạn chạy docker compose down để khởi động lại stack một cách sạch sẽ. Lệnh này xóa các container và giữ nguyên named volume, đúng với tài liệu mô tả. Volume Postgres của bạn lúc này không còn được gắn vào container nào. Mười phút sau, bạn chạy docker volume prune -a để giải phóng dung lượng, và database biến mất. Cả hai lệnh đều hoạt động đúng. Chính chuỗi thao tác này đã xóa dữ liệu.
Từ Docker Engine 23.0 (API version 1.42), lệnh không có tùy chọn hẹp hơn trước.
WARNING! This will remove anonymous local volumes not used by at least one container.Anonymous volume là volume do Docker tạo cho bạn, thường vì image khai báo VOLUME nhưng bạn không đặt tên cho volume. Những volume này thường chứa dữ liệu mà bạn không yêu cầu giữ lại. Named volume, tức loại volume bạn ghi trong file compose, chỉ bị xóa khi bạn thêm -a. Các phiên bản Docker cũ xóa cả hai loại bằng lệnh không có tùy chọn, vì vậy đừng dựa vào thói quen hình thành trên máy đã được bạn nâng cấp sau đó. Sự khác biệt này chỉ có ý nghĩa khi bạn biết named volume khác bind mount như thế nào, vì bind mount hoàn toàn không phải Docker volume và không có lệnh prune nào có thể tác động đến nó.
Hãy kiểm tra trước khi xóa. Thay myapp_pgdata bằng tên volume bạn đang kiểm tra.
docker volume ls -f dangling=true
docker volume inspect myapp_pgdata
sudo ls -la /var/lib/docker/volumes/myapp_pgdata/_dataBộ lọc dangling=true trên volume có nghĩa là không được tham chiếu, không phải rỗng. Liệt kê _data để xem bên trong volume thực sự có gì. Nếu thấy thư mục pgdata hoặc mysql ở đó, hãy dừng lại và sao lưu một bản trước khi làm tiếp. Việc xóa tương tự cũng xảy ra với docker compose down -v. Lệnh này xóa các named volume được file compose khai báo, ngoại trừ những volume được đánh dấu external, và không hỏi bạn trước.
Volume là thành phần duy nhất trên Docker host mà một lần rebuild không thể tạo lại. Vì vậy, dữ liệu trong volume phải được sao lưu bằng một job restic chạy bên ngoài server, để một flag gõ nhầm không thể tác động đến bản sao đó.
Khi không prune được gì: các file log của container
Bạn đã prune mọi thứ, docker system df hầu như không cho thấy gì có thể giải phóng, nhưng disk vẫn đầy. Hãy kiểm tra log.
sudo find /var/lib/docker/containers -name '*-json.log' -exec du -h {} + | sort -h | tail -10Mỗi container ghi standard output và standard error vào một file JSON bên dưới /var/lib/docker/containers/. Trong cài đặt mặc định, max-size không được đặt, tức là không có giới hạn. Vì vậy, một container mắc trong crash loop có thể ghi cho đến khi partition đầy. Không lệnh prune nào xóa được các file này, vì các container tạo ra chúng vẫn đang chạy, nên theo định nghĩa chúng không thể bị prune.
Không xóa file đó. Chạy rm trên một file log đang mở không giải phóng dung lượng nào, vì Docker daemon vẫn giữ file descriptor đang mở và kernel tiếp tục giữ các block được cấp phát cho đến khi handle đó đóng. df sẽ không thay đổi. Thay vào đó, hãy truncate file. Cách này giữ nguyên inode và cho phép daemon tiếp tục ghi.
sudo find /var/lib/docker/containers -name '*-json.log' -exec truncate -s 0 {} +
df -h /Đây chỉ là cách xử lý tạm thời. docker logs cho các container đó hiện không trả về gì, nhưng các file sẽ lập tức tăng kích thước trở lại. Cách xử lý đúng là cấu hình rotation, được trình bày trong phần tiếp theo.
Đo trước và sau, lần nào cũng vậy
Đừng đoán tác động của lệnh prune. Hãy đo một lần, chạy một lệnh, rồi đo lại.
df -h /
docker system df
docker builder prune -f --filter until=168h
docker image prune -f
docker system df
df -h /So sánh hai kết quả df. Đây là con số duy nhất cho biết server của bạn có tiếp tục phục vụ được hay không. Sau đó, docker system df cho biết chính xác dòng nào đã thay đổi, còn mỗi lệnh prune sẽ in ra số liệu Total reclaimed space: riêng.
Nếu df không thay đổi nhưng docker system df cho biết đã giải phóng dung lượng, một file handle đang mở vẫn giữ các block đã bị xóa. Đây chính là vấn đề với file log được nêu ở trên. Nếu cả hai đều thay đổi nhưng disk lại đầy trong vòng một ngày, bạn đang gặp vấn đề tăng trưởng dữ liệu chứ không phải vấn đề dọn dẹp. Cách xử lý là cấu hình rotation và thêm scheduled job.
Cách ngăn ổ đĩa đầy lại
Giới hạn kích thước log. Tạo hoặc chỉnh sửa /etc/docker/daemon.json.
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}Thiết lập này giới hạn log của mỗi container được tạo sau lần restart ở mức 30 MB. Mọi giá trị bên dưới log-opts phải là chuỗi, kể cả các giá trị số. Kiểm tra file có parse được trước khi restart, vì daemon.json sai định dạng sẽ khiến daemon không thể khởi động và làm tất cả container dừng theo.
python3 -m json.tool /etc/docker/daemon.json
sudo systemctl restart docker
docker info | grep -i 'logging driver'docker info lúc này phải trả về Logging Driver: json-file. Các giới hạn xuất hiện trong phần LogConfig của docker inspect trên một container được tạo sau lần restart. Đây là chi tiết quan trọng: thiết lập này chỉ áp dụng cho container mới. Container hiện có vẫn giữ cấu hình lúc được tạo, vì vậy hãy recreate chúng.
docker compose up -d --force-recreateBạn cũng có thể đặt cùng giới hạn này cho từng service trong file compose. Đây là lựa chọn phù hợp hơn khi một service nhiều log cần mức giới hạn riêng.
services:
app:
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"Lên lịch prune có phạm vi hẹp. Chạy hàng tuần, chỉ áp dụng cho image không còn được tham chiếu và build cache cũ. Không bao giờ đưa -a hoặc --volumes vào scheduled job, vì job chạy khi một stack đang dừng sẽ xóa image của stack đó; với --volumes, nó còn bắt đầu xóa dữ liệu của bạn.
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-pruneDòng cuối chạy script một lần bằng tay để bạn xem output trước khi script chạy tự động. File phải có quyền executable, và tên file không được chứa dấu chấm, vì run-parts bỏ qua mọi file không executable và mọi file có phần mở rộng.
Cảnh báo dung lượng trống. Chạy prune sau khi ổ đĩa đã đầy chỉ là khôi phục sự cố. Cảnh báo ở mức 80 phần trăm là biện pháp phòng ngừa.
usage=$(df --output=pcent / | tr -dc '0-9')
[ "$usage" -ge 80 ] && echo "root filesystem at ${usage} percent full"Đưa lệnh đó vào cron cùng notifier bạn đang sử dụng. Dung lượng trống chỉ phản ánh một nửa vấn đề, vì vậy hãy kết hợp cảnh báo này với giám sát tình trạng ổ đĩa trên VPS của bạn. Ổ đĩa sắp hỏng và ổ đĩa đầy đều khiến container dừng, nhưng hai tình huống này cần cách xử lý khác nhau.
Toàn bộ nội dung trên giả định bạn dùng bản cài đặt tiêu chuẩn với data root tại /var/lib/docker. Nếu đã chuyển vị trí này bằng key data-root trong daemon.json, hãy thay đường dẫn của bạn trong mọi lệnh. Với image store của containerd, data-root không chuyển dữ liệu image và container trong /var/lib/containerd, vì vị trí đó được thiết lập bởi root trong /etc/containerd/config.toml. Cấu hình đúng layout này ngay khi cài một máy mới là một phần của thiết lập Docker trên VPS, và quyết định trước sẽ dễ hơn nhiều so với việc có 40 GB container nằm trên sai partition.
FAQ
docker system prune có xóa volume của tôi không?
Không. Lệnh cơ bản xóa các container đã dừng, network không dùng, image mồ côi và build cache không dùng. Prompt xác nhận cũng liệt kê chính xác nhóm này. Volume chỉ được đưa vào phạm vi xử lý khi thêm --volumes. Từ Docker Engine 23.0, flag đó áp dụng cho volume ẩn danh, không áp dụng cho volume có tên. Volume có tên bị xóa bởi docker volume prune -a và docker compose down -v. Đây là hai lệnh cần đặc biệt cẩn thận.
Vì sao disk vẫn đầy sau khi chạy docker prune?
Có hai nguyên nhân thường gặp. Nguyên nhân thứ nhất là file log của container trong /var/lib/docker/containers/. Không lệnh prune nào đụng đến các file này, và chúng sẽ tăng không giới hạn cho đến khi bạn cấu hình max-size. Nguyên nhân thứ hai là một file đã bị xóa nhưng vẫn đang được process mở. Nếu bạn xóa log bằng rm trong khi container vẫn đang chạy, daemon vẫn giữ file descriptor. Kernel không giải phóng các block, nên df không báo thay đổi. So sánh sudo du -xh --max-depth=1 /var/lib/docker với docker system df để xác định trường hợp của bạn.
Sự khác nhau giữa docker image prune và docker image prune -a là gì?
Lệnh cơ bản chỉ xóa image mồ côi, tức các image đã mất tag, gần như luôn do một lần build lại. Dạng -a xóa mọi image mà không có container hiện tại nào tham chiếu, bao gồm cả các image có tag mà bạn đã chủ động pull. Sau docker compose down, các container đã bị xóa, nên -a cũng sẽ xóa các image của stack đó. Không có gì bị mất vĩnh viễn, vì lần start tiếp theo sẽ pull hoặc build lại chúng. Tuy nhiên, nếu đường truyền chậm thì quá trình này sẽ mất nhiều thời gian.
Làm thế nào để log của Docker không làm đầy disk?
Đặt max-size và max-file trong log-opts của /etc/docker/daemon.json, sau đó restart daemon bằng sudo systemctl restart docker. Setting này chỉ áp dụng cho các container được tạo sau lần restart đó. Vì vậy, hãy tạo lại các container đang chạy bằng docker compose up -d --force-recreate. Bạn có thể đặt cùng hai option cho từng service trong file compose, dưới key logging. Cách này phù hợp khi một service tạo log nhiều hơn đáng kể so với các service còn lại.
Chạy docker system prune trong cron job có an toàn không?
docker system prune -f cơ bản an toàn trên host nơi mọi stack luôn chạy. Tuy nhiên, lệnh này xóa các container đã dừng. Vì vậy, nó sẽ xóa cả container mà bạn đã chủ động dừng và dự định khởi động lại sau. Cron job an toàn hơn là docker image prune -f kèm docker builder prune -f --filter until=168h. Cách này giải phóng hai nhóm dữ liệu tăng nhanh nhất và không thể đụng đến volume. Không bao giờ lập lịch chạy -a hoặc --volumes.