Docker prune: liberare spazio su disco su un VPS
Scopri se immagini, container, cache di build o volumi occupano il disco del VPS, poi usa il prune più specifico per liberare spazio senza perdere dati.
Individua cosa utilizza lo spazio su disco prima di eliminare qualsiasi dato
Docker occupa spazio su disco su un VPS in quattro aree: immagini, container arrestati, cache di build e volumi locali. Esegui prima docker system df per individuare quale area contiene i dati, quindi usa il comando prune più mirato per liberare quello spazio. L'ordine è importante, perché l'ultimo comando di questa guida, docker volume prune -a, elimina i dati senza possibilità di annullare l'operazione.
Inizia dal filesystem, non da 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 mostra quanto è grave la situazione. du mostra dove viene utilizzato lo spazio. Il flag -x mantiene du nello stesso filesystem, quindi non segue un mount verso un volume separato e non conta lo spazio due volte. Le directory da controllare dipendono dal backend di storage. In una nuova installazione di Docker Engine 29.0 o versione successiva, il containerd image store è il backend predefinito e i contenuti delle immagini e gli snapshot dei container si trovano in /var/lib/containerd; per questo è presente la seconda riga du. Con entrambi i backend, due directory sotto /var/lib/docker sono importanti: volumes contiene i dati dei volumi, mentre containers contiene i metadati dei container e i file di log. Un host aggiornato da una versione precedente di Docker mantiene il layout overlay2 classico finché non lo si cambia. In questo layout sono importanti altre tre directory: overlay2 contiene i layer delle immagini e dei container, buildkit contiene la cache di build e image contiene i metadati dei layer. docker info | grep -i driver-type stampa io.containerd.snapshotter.v1 con il containerd image store e non stampa nulla con overlay2. Il containerd image store conserva sia la copia compressa sia quella estratta di ogni layer. Per questo le stesse immagini occupano più spazio su disco rispetto a overlay2.
Una nota su sudo e sui caratteri jolly della shell, perché causano spesso perdite di tempo. /var/lib/docker appartiene a root e non è leggibile dall'utente normale, quindi ls /var/lib/docker restituisce Permission denied. Anche un comando come sudo du -sh /var/lib/docker/* non funziona, perché la shell espande * prima che sudo venga eseguito e la shell non può leggere quella directory. Per questo tutti i comandi riportati di seguito usano find o --max-depth invece di un carattere jolly.
Ora passa alla visualizzazione fornita direttamente da 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.87GBQuesti valori provengono da una sola macchina e non dicono nulla sul tuo sistema. Osserva invece la struttura dei dati. TOTAL conta gli oggetti, ACTIVE conta quelli attualmente in uso e RECLAIMABLE è la stima di Docker dello spazio che un comando prune potrebbe liberare per quella riga.
Due aspetti di RECLAIMABLE possono trarre in inganno. Conta i layer condivisi delle immagini una volta per ogni immagine che li utilizza, quindi la riga delle immagini di solito indica più spazio di quello che puoi effettivamente liberare. Inoltre non include mai i file di log dei container, perché Docker non considera un file di log un oggetto eliminabile. Quando du mostra una directory molto più grande dello spazio indicato da docker system df, la causa sono i file di log. Di seguito è presente una sezione dedicata a questo caso.
Aggiungi -v per ottenere il dettaglio per singolo oggetto.
docker system df -vIl riepilogo viene suddiviso in una sezione per ogni tipo di oggetto. La sezione delle immagini aggiunge le colonne SHARED SIZE e UNIQUE SIZE, così puoi vedere quanto spazio occupa realmente una singola immagine. La sezione dei volumi aggiunge un conteggio LINKS, che indica il numero di container collegati al volume. Ricorda LINKS: un valore pari a 0 indica che nessun container utilizza il volume, ed è questa la condizione da cui parte ogni comando di prune dei volumi.
Immagini dangling e immagini inutilizzate
Questi due termini sembrano intercambiabili, ma non lo sono. I filtri si comportano in modo diverso perché gli oggetti sono diversi.
Un'immagine dangling è un'immagine senza tag. In docker images viene mostrata come <none>. Se esegui una nuova build, ne crei una: docker build -t myapp:latest . assegna il tag myapp:latest alla nuova immagine, mentre quella precedente conserva tutti i suoi layer ma perde il nome. Nessun oggetto vi fa riferimento e nessun processo la elimina automaticamente.
Un'immagine inutilizzata è un'immagine, con o senza tag, a cui nessun container fa attualmente riferimento. Una postgres:16 scaricata il mese scorso, a cui nessun container fa riferimento, in esecuzione o arrestato, è inutilizzata ma non dangling.
docker image prune # dangling images only
docker image prune -a # every image no container refers toIl secondo comando chiede prima una conferma.
WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N]Leggi attentamente la richiesta. "Associated to them" indica un oggetto container esistente, in esecuzione o arrestato. Se hai eseguito docker compose down, i container sono stati eliminati. Di conseguenza, ogni immagine utilizzata da quei servizi è ora inutilizzata e -a le elimina tutte. Non perdi nulla che non possa essere recuperato, ma il comando docker compose up -d successivo dovrà scaricare o ricreare tutto, consumando banda e tempo di build su un VPS di piccole dimensioni. Questo è un motivo pratico per sapere che cosa rimuove docker compose down e che cosa lascia in esecuzione stop prima di eliminare le immagini.
Un filtro esclude dall'operazione le immagini recenti.
docker image prune -a --filter "until=240h"Questo comando rimuove le immagini inutilizzate create più di 240 ore (10 giorni) fa e lascia inalterate quelle più recenti. Il valore until accetta una stringa di durata Go come 240h oppure un timestamp assoluto come 2026-08-01T00:00:00.
Che cos’è la cache delle build e perché cresce così tanto
BuildKit è il builder usato per impostazione predefinita da Docker per docker build e docker compose build a partire da Docker Engine 23.0. Memorizza nella cache il risultato di ogni passaggio di ogni Dockerfile che esegue e, nel layout overlay2 classico, conserva questa cache in /var/lib/docker/buildkit. La cache consente di completare la seconda build in pochi secondi, quindi sta svolgendo correttamente il suo compito. Docker Engine esegue comunque la garbage collection per impostazione predefinita: rimuove la cache non utilizzata da 60 giorni e ripulisce il resto solo quando supera i limiti calcolati da Docker Engine in base alle dimensioni del disco. Su un VPS di piccole dimensioni questo può avvenire quando il disco è già quasi pieno. Se esegui 50 volte la build della stessa immagine con un passaggio COPY che cambia a ogni esecuzione, prima dell’avvio della raccolta conserverai 50 insiemi di layer.
La cache delle build non è visibile in docker image prune. È un tipo di oggetto separato, con un comando dedicato.
docker builder prune # dangling cache
docker builder prune -a # all unused cache
docker builder prune --filter until=168h # cache untouched for 7 daysNessuno di questi comandi modifica le immagini o i dati. L’unico costo della cancellazione della cache delle build è che la build successiva sarà lenta una sola volta. Su un VPS che ricostruisce regolarmente le immagini, Build Cache è spesso la voce più grande in docker system df, quindi è l’elemento di grandi dimensioni più sicuro da eliminare.
I comandi prune, ordinati dal meno rischioso al più distruttivo
Scorri questo elenco e interrompi la procedura non appena df -h / torna in condizioni normali. Al termine, ogni comando stampa una riga Total reclaimed space:.
docker container prunerimuove i container arrestati. Elimina anche i relativi writable layer, quindi tutti i dati scritti da un container al di fuori di un volume vengono eliminati insieme al container. I volumi non vengono modificati.docker image prunerimuove soltanto le immagini dangling. È il comando sulle immagini con il rischio più basso.docker builder prunerimuove la build cache dangling. L'effetto è una sola build più lenta.docker image prune -arimuove tutte le immagini a cui non fa riferimento alcun container. Sarà necessario scaricarle nuovamente o ricostruirle.docker system pruneesegue contemporaneamente le prime tre operazioni e aggiunge le reti inutilizzate.docker volume prunerimuove i volumi anonimi inutilizzati.docker volume prune -arimuove i volumi inutilizzati, inclusi quelli con nome. È il comando che elimina i database.
docker system prune dichiara il proprio ambito prima dell'esecuzione.
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]I volumi sono esclusi intenzionalmente da questo elenco. Aggiungendo --volumes si includono anche i volumi anonimi. Aggiungendo -a si estende l'operazione sulle immagini, dalle sole immagini dangling a tutte le immagini inutilizzate. Un docker system prune -a --volumes -f completo su un host di produzione è il modo in cui si perdono dati mentre si cerca di liberare spazio.
Perché il pruning dei volumi elimina il database
Questa è la sezione da leggere due volte.
Un volume è considerato inutilizzato quando nessun container vi è collegato. Questo è l'unico controllo eseguito. Docker non verifica se il volume è vuoto, se un file Compose lo dichiara ancora o se contiene l'unica copia del database. LINKS 0 in docker system df -v significa inutilizzato e docker volume prune -a considera eliminabile ogni volume inutilizzato, a meno che un filtro label aggiunto dall'utente non lo escluda.
Ora eseguiamo due normali operazioni in sequenza. Esegui docker compose down per riavviare correttamente uno stack. Questo rimuove i container e lascia invariati i volumi denominati, esattamente come indicato nella documentazione. A questo punto il volume di Postgres non è collegato ad alcun container. Dieci minuti dopo esegui docker volume prune -a per liberare spazio e il database scompare. Entrambi i comandi hanno funzionato correttamente. È stata la sequenza a distruggere i dati.
A partire da Docker Engine 23.0 (versione API 1.42), il comando semplice è più limitato rispetto al passato.
WARNING! This will remove anonymous local volumes not used by at least one container.Un volume anonimo è un volume creato automaticamente da Docker, in genere perché un'immagine dichiara VOLUME e non gli hai assegnato un nome. Di norma contiene dati che non avevi richiesto di conservare. Un volume denominato, cioè quello inserito nel file Compose, viene rimosso solo quando aggiungi -a. Le versioni precedenti di Docker rimuovevano entrambi con il comando semplice. Non fare quindi affidamento su abitudini acquisite su un sistema che hai successivamente aggiornato. La differenza diventa comprensibile solo dopo aver visto come differiscono i volumi denominati dai bind mount, perché un bind mount non è affatto un volume Docker e nessun comando prune lo interesserà.
Controlla prima di eliminare. Sostituisci myapp_pgdata con il nome del volume da verificare.
docker volume ls -f dangling=true
docker volume inspect myapp_pgdata
sudo ls -la /var/lib/docker/volumes/myapp_pgdata/_dataIl filtro dangling=true applicato a un volume significa non referenziato, non vuoto. L'elenco _data mostra il contenuto effettivo. Se trovi una directory pgdata o mysql, fermati e crea una copia prima di procedere. La stessa distruzione può avvenire tramite docker compose down -v, che rimuove i volumi denominati dichiarati dal file Compose, ad eccezione di quelli contrassegnati con external, senza chiedere alcuna conferma.
Un volume è l'unico elemento di un host Docker che una ricostruzione non può ricreare. Per questo i dati dei volumi devono essere inclusi in un backup restic eseguito al di fuori del server, in modo che un flag digitato erroneamente non possa raggiungerli.
Quando nulla viene eliminato: i file di log dei container
Hai eliminato tutto ciò che era possibile eliminare, docker system df mostra quasi nulla di recuperabile, ma il disco è ancora pieno. Controlla i log.
sudo find /var/lib/docker/containers -name '*-json.log' -exec du -h {} + | sort -h | tail -10Ogni container scrive l’output standard e l’errore standard in un file JSON sotto /var/lib/docker/containers/. In un’installazione predefinita max-size non è impostato, quindi non esiste alcun limite. Un singolo container bloccato in un ciclo di crash può quindi scrivere finché la partizione non si riempie. Nessun comando prune rimuove questi file, perché i container che li producono sono in esecuzione e, per definizione, non possono essere eliminati.
Non eliminare il file. Eseguire rm su un file di log aperto non libera spazio, perché il daemon Docker mantiene aperto un file descriptor e il kernel conserva quei blocchi allocati finché quel riferimento non viene chiuso. df non si sposterà affatto. Usa invece truncate: mantiene lo stesso inode e consente al daemon di continuare a scrivere.
sudo find /var/lib/docker/containers -name '*-json.log' -exec truncate -s 0 {} +
df -h /È una soluzione temporanea. docker logs per quei container ora non restituisce nulla, ma i file ricominciano subito a crescere. La soluzione corretta è la rotazione dei log, descritta nella sezione successiva.
Misurare prima e dopo, ogni volta
Non dedurre mai l'effetto di un prune. Esegui una misurazione, un solo comando, quindi una seconda misurazione.
df -h /
docker system df
docker builder prune -f --filter until=168h
docker image prune -f
docker system df
df -h /Confronta i due output di df. Questo è l'unico numero che determina se il server continua a erogare il servizio. docker system df indica quindi quale riga è effettivamente cambiata, mentre ogni prune stampa il proprio valore Total reclaimed space:.
Se df non è cambiato, ma docker system df indica che è stato liberato spazio, un file aperto mantiene occupati i blocchi eliminati. Questo corrisponde al problema dei file di log descritto sopra. Se entrambi sono cambiati e il disco torna pieno entro un giorno, il problema è la crescita dei dati, non la pulizia. La soluzione consiste nella rotazione dei log e in un job pianificato.
Come evitare che il disco si riempia di nuovo
Limitare le dimensioni dei log. Creare o modificare /etc/docker/daemon.json.
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}Questa configurazione limita a 30 MB i log di ogni container creato dopo il riavvio. Ogni valore in log-opts deve essere una stringa, compresi i valori numerici. Verificare che il file sia valido prima di riavviare, perché un daemon.json non valido impedisce completamente l'avvio del demone e arresta con esso tutti i container.
python3 -m json.tool /etc/docker/daemon.json
sudo systemctl restart docker
docker info | grep -i 'logging driver'docker info dovrebbe ora restituire Logging Driver: json-file. I limiti sono visibili nella sezione LogConfig di docker inspect per un container creato dopo il riavvio. Questo è il dettaglio importante: l'impostazione si applica solo ai nuovi container. I container esistenti mantengono la configurazione con cui sono stati creati, quindi è necessario ricrearli.
docker compose up -d --force-recreateLo stesso limite può essere configurato per ogni servizio in un file Compose. Questa è la scelta migliore quando un servizio particolarmente verboso richiede un limite diverso.
services:
app:
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"Pianificare una pulizia mirata. Eseguirla settimanalmente, limitandola alle immagini dangling e alla cache di compilazione obsoleta. Non inserire mai -a o --volumes in un job pianificato, perché un job eseguito mentre uno stack è arrestato eliminerebbe le immagini di quello stack e, con --volumes, inizierebbe a operare sui dati.
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-pruneL'ultima riga esegue manualmente lo script una volta, così puoi verificarne l'output prima che venga eseguito senza supervisione. Il file deve essere eseguibile e il suo nome non deve contenere un punto, perché run-parts ignora tutto ciò che non è eseguibile e tutto ciò che ha un'estensione.
Impostare un avviso sullo spazio libero. Una pulizia eseguita dopo che il disco si è riempito è una procedura di ripristino. Un avviso all'80 percento è una misura preventiva.
usage=$(df --output=pcent / | tr -dc '0-9')
[ "$usage" -ge 80 ] && echo "root filesystem at ${usage} percent full"Inserire questa configurazione in cron usando il sistema di notifica già disponibile. Lo spazio libero rappresenta solo metà del problema, quindi associare l'avviso al monitoraggio dello stato del disco sul VPS, perché sia un disco in avaria sia un disco pieno arrestano i container e richiedono correzioni diverse.
Tutto quanto sopra presuppone un'installazione standard con la directory radice dei dati in /var/lib/docker. Se è stata spostata usando la chiave data-root in daemon.json, sostituire il percorso in ogni comando. Con l'archivio di immagini containerd, data-root non sposta i dati delle immagini e dei container in /var/lib/containerd, perché tale posizione è definita da root in /etc/containerd/config.toml. Configurare correttamente questo layout su un server nuovo rientra nella configurazione di Docker su un VPS ed è molto più semplice decidere il percorso prima di avere 40 GB di container nella partizione sbagliata.
FAQ
Docker system prune elimina i miei volumi?
No. Il comando senza opzioni rimuove i container arrestati, le reti inutilizzate, le immagini dangling e la cache di build inutilizzata. Il prompt di conferma elenca esattamente questi elementi. I volumi vengono inclusi solo quando aggiungi --volumes. A partire da Docker Engine 23.0, questa opzione riguarda i volumi anonimi, non quelli con nome. I volumi con nome vengono rimossi da docker volume prune -a e da docker compose down -v. Questi sono i due comandi da usare con cautela.
Perché il disco è ancora pieno dopo aver eseguito docker prune?
Le cause più comuni sono due. La prima sono i file di log dei container sotto /var/lib/docker/containers/. Nessun comando prune li modifica e possono crescere senza limiti finché non imposti max-size. La seconda è un file eliminato che un processo mantiene aperto. Se hai rimosso un log con rm mentre il relativo container era in esecuzione, il daemon conserva il file descriptor e il kernel non rilascia i blocchi. Di conseguenza, df non mostra alcuna variazione. Confronta sudo du -xh --max-depth=1 /var/lib/docker con docker system df per capire quale delle due situazioni si applica.
Qual è la differenza tra docker image prune e docker image prune -a?
Il comando senza opzioni rimuove solo le immagini dangling, cioè le immagini che hanno perso il tag, quasi sempre a causa di una rebuild. La forma -a rimuove tutte le immagini a cui nessun container esistente fa riferimento, incluse le immagini con tag che hai scaricato intenzionalmente. Dopo un docker compose down i container non esistono più, quindi -a rimuoverà anche le immagini utilizzate da quello stack. Nulla viene perso definitivamente, perché al successivo avvio le immagini vengono scaricate o ricostruite. Tuttavia, con una connessione lenta, l'operazione può richiedere molto tempo.
Come posso impedire che i log di Docker riempiano il disco?
Imposta max-size e max-file sotto log-opts in /etc/docker/daemon.json, quindi riavvia il daemon con sudo systemctl restart docker. L'impostazione si applica solo ai container creati dopo quel riavvio. Ricrea quindi quelli già in esecuzione con docker compose up -d --force-recreate. Puoi impostare le stesse due opzioni per ogni servizio in un file Compose, sotto una chiave logging. Questa soluzione è utile quando un servizio genera molti più log degli altri.
È sicuro eseguire docker system prune tramite un cron job?
Il comando docker system prune -f senza opzioni è sicuro su un host in cui tutti gli stack restano attivi. Tuttavia, rimuove i container arrestati. Pertanto, eliminerà anche un container che hai arrestato intenzionalmente e che intendevi riavviare in seguito. Il job pianificato più sicuro è docker image prune -f insieme a docker builder prune -f --filter until=168h. Questa combinazione libera le due categorie che crescono più rapidamente e non può modificare alcun volume. Non pianificare mai -a o --volumes.