Disco cheio por arquivos órfãos? Como limpar volumes no Docker

Por que o Docker consome tanto espaço em disco?

Quem utiliza ferramentas de containerização no dia a dia certamente já se deparou com um aviso incômodo de sistema operacional informando que o armazenamento chegou ao limite. Na prática, isso significa que a máquina física está sufocada por gigabytes de arquivos temporários que perderam a utilidade. O Docker foi desenhado para ser rápido e isolado, mas essa arquitetura faz com que ele guarde cada pedaço de download, cache de compilação e histórico de versões antigas para acelerar novas execuções. O problema é que, com o passar dos meses, esses arquivos ficam órfãos, ou seja, continuam ocupando espaço físico mesmo quando a aplicação correspondente já foi apagada ou substituída por uma versão mais recente.

Para entender como o problema se forma, vale lembrar que cada container depende de imagens base que são baixadas da internet. Quando atualizamos uma aplicação, o Docker baixa uma nova imagem e marca a antiga como none, conhecida popularmente como imagem dangling ou pendurada. Além disso, os volumes criados para reter dados importantes frequentemente sobrevivem aos containers que lhes deram origem, virando ilhas de dados esquecidas. Antes de sair apagando tudo no susto, vale a pena conferir boas práticas complementares para otimizar o ambiente, a exemplo do que discutimos sobre como limpar o cache do Docker e recuperar espaço em disco em manutenções anteriores.

Identificando o tamanho do problema no seu servidor

Antes de aplicar qualquer comando de limpeza, o primeiro passo sensato é descobrir exatamente onde o espaço está sendo desperdiçado. O Docker possui uma ferramenta nativa fantástica para essa investigação chamada system df. Quando executada no terminal, ela exibe um painel claro dividindo o armazenamento entre imagens, containers, volumes locais e cache de compilação. Na prática, esse comando funciona como uma radiografia rápida que mostra o tamanho total alocado e a porcentagem exata que está efetivamente em uso pelas aplicações ativas naquele momento.

Para rodar essa análise, basta abrir o terminal e digitar o comando abaixo com privilégios adequados:

docker system df

O resultado mostrará colunas detalhadas com o espaço total e o espaço reclaimable, que representa o volume exato de dados que pode ser recuperado com segurança. Se o número de espaço recuperável for alto, significa que há muita gordura acumulada que pode ser eliminada sem nenhum risco para os serviços que estão rodando em produção. Esse diagnóstico evita que você tome decisões baseadas apenas em achismos, focando o esforço de limpeza exatamente onde o gargalo de armazenamento é maior.

Removendo containers parados e imagens órfãs

Quando encerramos um container utilizando comandos comuns, ele geralmente permanece registrado no sistema com o status de parado. Esses registros guardam configurações e logs que raramente voltam a ser consultados, mas continuam consumindo metadados e espaço em disco. Para eliminar todos os containers que não estão em execução de uma só vez, utilizamos o comando de poda específico para containers. Na prática, essa ação faz uma varredura geral e limpa o histórico obsoleto de todas as instâncias inativas do ambiente.

O comando padrão para realizar essa limpeza de containers inativos é o seguinte:

docker container prune

O terminal solicitará uma confirmação de segurança antes de prosseguir com a exclusão definitiva. Após confirmar, o sistema removerá todas as instâncias paradas e devolverá o espaço correspondente ao sistema operacional. Na sequência, podemos fazer o mesmo com as imagens órfãs que não estão vinculadas a nenhum container ativo, utilizando o comando de poda de imagens. Se você também lida com outras ferramentas de infraestrutura no dia a dia, vale a pena conferir procedimentos semelhantes para manter o sistema limpo, como como limpar o cache do APT e recuperar espaço no Linux.

Limpando volumes não utilizados sem perder dados

Os volumes do Docker são mecanismos projetados para persistir dados gerados por e para containers, garantindo que informações importantes não desapareçam quando o container é destruído. O grande problema ocorre quando um container é removido permanentemente, mas seu volume correspondente é esquecido no disco, transformando-se em um arquivo órfão que consome gigabytes silenciosamente. Para resolver isso com segurança, utilizamos o comando de limpeza de volumes, que diferencia com inteligência quais volumes estão conectados a containers ativos e quais estão completamente abandonados.

Execute o comando abaixo para varrer e remover os volumes que não possuem nenhuma ligação atual:

docker volume prune

É fundamental destacar que o Docker é inteligente o suficiente para não apagar volumes que estejam em uso por containers ativos, mesmo que estejam parados momentaneamente. Contudo, antes de rodar esse comando em servidores de produção, é sempre prudente verificar se não há nenhum container desativado que precise ser reiniciado posteriormente com aqueles dados específicos. Caso tenha dúvidas sobre quais volumes existem na máquina, você pode listar todos eles previamente com docker volume ls para inspecionar os nomes e garantir que nenhuma informação crítica será perdida no processo.

Executando a limpeza geral com o system prune

Se você deseja automatizar todo o processo de faxina de uma só vez, sem precisar rodar comandos separados para containers, imagens e redes, o Docker oferece uma solução drástica e abrangente chamada system prune. Na prática, esse comando age como uma limpeza de primavera completa, varrendo todos os recursos inativos do sistema de uma só vez. Ele remove containers parados, redes que não estão sendo utilizadas por ninguém, imagens sem tags e todo o cache de compilação acumulado ao longo do tempo.

Para executar a limpeza geral com o modo agressivo que também atinge imagens não utilizadas, utilize o parâmetro adicional:

docker system prune -a --volumes

O uso da flag -a garante que todas as imagens que não estão sendo usadas por containers ativos sejam removidas, e não apenas aquelas sem tags. Já o parâmetro --volumes assegura que os volumes não utilizados também entrem no pacote de exclusão. Essa rotina é extremamente útil em ambientes de desenvolvimento ou servidores de testes, onde o acúmulo de lixo digital ocorre com muita frequência. Em ambientes de produção, no entanto, deve ser utilizada com cautela para evitar a remoção acidental de imagens base que demorariam muito tempo para serem baixadas novamente. Para aprofundar esses conceitos na prática em produção, confira também nossa análise técnica sobre Como ver logs do Kubernetes em tempo real com o Stern.

Considerações finais

Manter um ambiente Docker limpo e organizado é uma prática indispensável para evitar surpresas desagradáveis com discos cheios em momentos críticos de operação. Vimos que ferramentas nativas como os comandos de poda tornam essa tarefa rápida, permitindo recuperar gigabytes preciosos de armazenamento com poucos cliques no terminal. Integrar essas rotinas de manutenção preventiva ao ciclo de vida da infraestrutura garante mais estabilidade e previsibilidade para os servidores.

Adotar o hábito de verificar o consumo de disco regularmente e descartar o que não tem utilidade prolonga a vida útil dos recursos de hardware e simplifica o dia a dia técnico. Seja em servidores de homelab ou em ambientes corporativos robustos, o gerenciamento consciente de containers e volumes é um diferencial que separa uma operação caótica de um sistema limpo, confiável e eficiente.