Pesquisar
Português
Conteúdo
  1. Tutorial de Docker
Primeiros passos
  1. O que é Docker
  2. Instalar Docker
  3. Tour pela interface do Docker Desktop
  4. Primeiro contêiner
  5. Imagens (Image)
  6. Ciclo de vida dos contêineres
  7. Parâmetros do docker run
  8. Consultar logs e depurar
Imagens e Dockerfile
  1. Introdução ao Dockerfile
  2. gerar automaticamente com docker init
  3. Guia de instruções do Dockerfile
  4. Cache de build e otimização
  5. Builds em múltiplos estágios
  6. Publicar no Docker Hub
Dados e redes
  1. Volume e persistência de dados
  2. Redes e comunicação entre contêineres
  3. Variáveis de ambiente e .env
Docker Compose
  1. Introdução ao Docker Compose
  2. Sintaxe do compose.yaml
  3. Comandos do Docker Compose
  4. Exemplo prático: configurar WordPress
Exemplos práticos
  1. Aplicações Python
  2. Aplicações Node.js
  3. Nginx e proxy reverso
  4. MySQL
  5. PostgreSQL
  6. Redis
Operação e tópicos avançados
  1. Liberar espaço em disco
  2. Boas práticas de segurança
  3. Rootless e Podman
  4. Imagens multiplataforma
  5. Build automático com GitHub Actions
  6. Implantar em um servidor na nuvem
  7. Fundamentos internos
  8. Guia de mensagens de erro comuns
  9. Referência rápida de comandos Docker
Referência de comandos
  1. docker build
  2. docker pull
  3. docker push
  4. docker rmi
  5. docker exec
  6. docker ps
  7. docker stop
  8. docker rm
  9. docker logs
  10. docker stats
  11. docker cp
  12. docker save
  13. docker inspect
  14. docker system
  15. docker volume
  16. docker network
  17. docker compose up
  18. docker compose down

Comando docker system: tutorial para ver o uso de disco, limpar dados e monitorar eventos

docker system permite consultar o uso de dados do Docker, limpar dados não utilizados e obter informações e eventos do sistema. Para fazer a limpeza, consulte Liberar espaço em disco e veja como gerenciar o espaço ocupado pelo Docker.

Sintaxe

docker system df [OPTIONS]
docker system prune [OPTIONS]
docker info [OPTIONS]
docker events [OPTIONS]

docker info e docker system info, assim como docker events e docker system events, são aliases para os mesmos comandos.

Parâmetros

ComandoParâmetroDescrição
docker system df--format modeloUsa um modelo personalizado para a saída; aceita table, json ou modelos Go
docker system df-v, --verboseExibe informações detalhadas sobre o uso de espaço
docker system prune-a, --allRemove todas as imagens não utilizadas, e não apenas as imagens órfãs
docker system prune--filter condiçãoFiltra os itens da limpeza por condição, como label=<key>=<value>
docker system prune-f, --forceNão solicita confirmação
docker system prune--volumesLimpa volumes anônimos
docker info-f, --format modeloUsa um modelo personalizado para a saída; aceita json ou modelos Go
docker events-f, --filter condiçãoFiltra os eventos exibidos pela condição especificada
docker events--format modeloUsa um modelo personalizado para a saída; aceita json ou modelos Go
docker events--since horárioExibe eventos criados após o horário especificado
docker events--until horárioContinua transmitindo eventos até o horário especificado

Exemplos

Consultar o uso de disco e os detalhes

$ docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          5         3         420.2MB   239.7MB (57%)
Containers      3         3         139.3kB   0B (0%)
Local Volumes   1         1         3.854MB   0B (0%)
Build Cache     0         0         0B        0B

$ docker system df -v | head -20
Images space usage:

REPOSITORY   TAG           IMAGE ID       CREATED         SIZE      SHARED SIZE   UNIQUE SIZE   CONTAINERS
myweb        snapshot      56e3f92534ca   7 seconds ago   92.1MB    0B            92.08MB       0
nginx        1.30-alpine   47928bf67eb6   3 days ago      93.5MB    12.94MB       80.6MB        1
registry     3             01cd312e6702   3 days ago      86.9MB    12.94MB       73.93MB       1
<none>       <none>        0bf6577d7774   3 days ago      161MB     12.93MB       147.6MB       0
alpine       3.23          ff7f0c727dd7   3 days ago      13MB      12.93MB       86.86kB       1

Containers space usage:

CONTAINER ID   IMAGE               COMMAND                  LOCAL VOLUMES   SIZE      CREATED          STATUS          NAMES
0c009f73010b   alpine:3.23         "sleep 600"              0               4.1kB     42 seconds ago   Up 41 seconds   small
63b9a2f9c63f   nginx:1.30-alpine   "/docker-entrypoint.…"   0               115kB     44 seconds ago   Up 43 seconds   web
35357aad74b1   registry:3          "/entrypoint.sh /etc…"   1               20.5kB    2 minutes ago    Up 2 minutes    registry

Local Volumes space usage:

VOLUME NAME                                                        LINKS     SIZE
21ea99090ddead0461eb5a6efd670e1d9cf58fe9c23d5f8618db5868fb6170aa   1         3.854MB
  • O resumo geral lista, para imagens, contêineres, volumes locais e cache de build, as quantidades totais e ativas, o tamanho e o espaço recuperável.
  • -v lista o uso de cada imagem e contêiner; os detalhes das imagens também incluem o tamanho compartilhado, o tamanho exclusivo e a quantidade de contêineres que as utilizam.
  • head -20 mantém apenas as 20 primeiras linhas da saída; por isso, os detalhes exibidos não incluem o restante do conteúdo.

Limpar dados não utilizados

$ docker system prune -f
Deleted Images:
untagged: sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
deleted: sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
deleted: sha256:16b124a2d3eacd620d917ead6fd26cbf1f1d7117fa94122398971931cfe2d403
deleted: sha256:f79a7876c6644b273e4eec899344e51c66959237a2f71188db8cb98d7311521c

Total reclaimed space: 147.6MB

$ docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          4         3         272.6MB   92.08MB (33%)
Containers      3         3         139.3kB   0B (0%)
Local Volumes   1         1         3.854MB   0B (0%)
Build Cache     0         0         0B        0B
  • -f faz com que o comando de limpeza ignore a solicitação de confirmação. O exemplo remove dados de imagens não utilizadas e informa que recuperou 147.6MB.
  • Antes e depois da limpeza, há 3 contêineres; a quantidade de imagens cai de 5 para 4, e o tamanho total diminui de 420.2MB para 272.6MB.
  • --all limpa todas as imagens não utilizadas, e --volumes limpa volumes anônimos; confirme antes quais dados você precisa manter.

Obter informações do sistema com modelos de formato

$ docker info --format '{{.ServerVersion}} {{.Driver}} {{.Containers}} containers, {{.Images}} images'
29.9.2 overlayfs 3 containers, 5 images
  • --format limita a saída à versão do servidor, ao driver de armazenamento e às quantidades de contêineres e imagens especificadas no modelo.
  • O exemplo mostra a versão do servidor 29.9.2 e o driver de armazenamento overlayfs.

Consultar eventos por horário e condição

$ timeout 3 docker events --since 30s --format '{{.Type}} {{.Action}} {{.Actor.Attributes.name}}' ; true
container top web
container top web
container kill busy
network disconnect bridge
container die busy
container destroy busy
image save sha256:47928bf67eb62a1863cb08d9ecb52d3e704304ba614eaee17884204677702951
image save sha256:47928bf67eb62a1863cb08d9ecb52d3e704304ba614eaee17884204677702951
image untag nginx:1.30-alpine
image load sha256:47928bf67eb62a1863cb08d9ecb52d3e704304ba614eaee17884204677702951
container exec_create: sh -c echo hello > /usr/share/nginx/html/hi.txt web
container exec_start: sh -c echo hello > /usr/share/nginx/html/hi.txt web
container exec_die web
container export web
image tag myweb:snapshot
image import sha256:56e3f92534ca8c5aedd8de576ae2433f1864d3d3b51de847a8dc8dd7d503da4d
container create sharp_gould
container attach sharp_gould
network connect bridge
container start sharp_gould
network disconnect bridge
container die sharp_gould
container destroy sharp_gould
container prune <no value>
network prune <no value>
image untag sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
image delete sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
builder prune <no value>

$ docker events --since 10s --until 0s --filter type=container --format '{{.Action}} {{.Actor.Attributes.name}}'
prune <no value>
create evt
attach evt
start evt
die evt
destroy evt
  • O primeiro exemplo começa a transmitir eventos dos últimos 30 segundos e usa o formato para exibir apenas o tipo, a ação e o nome; timeout 3 limita o tempo de execução.
  • O segundo exemplo usa --filter type=container para restringir os eventos a contêineres e define o intervalo com --since e --until.
  • O campo de nome do evento prune mostra <no value> porque esse evento não tem o valor de nome lido por este modelo.

Seções relacionadas

Exercícios

Exercício: liste apenas os eventos de contêiner dos últimos 10 segundos e exiba a ação do evento e o nome do contêiner.

Resposta 
docker events --since 10s --until 0s --filter type=container --format '{{.Action}} {{.Actor.Attributes.name}}'

Perguntas frequentes

O que significa UNIQUE SIZE em docker system df -v?

Ele mostra o tamanho exclusivo da imagem; a saída também lista SIZE e SHARED SIZE. Por exemplo, alpine:3.23 tem SIZE de 13MB, SHARED SIZE de 12.93MB e UNIQUE SIZE de 86.86kB.

docker system prune remove imagens em uso?

No exemplo, ele remove a imagem órfã que nenhum contêiner usa e informa que recuperou 147.6MB; após a limpeza, ainda há 3 contêineres ativos. --all amplia a limpeza para todas as imagens não utilizadas, e --volumes limpa volumes anônimos.

É possível mostrar apenas eventos de contêiner com docker events?

Sim, use --filter type=container. Com --since e --until, você limita o intervalo de tempo dos eventos; --format permite escolher os campos exibidos.

Como obter somente a versão do Docker e a quantidade de imagens usando docker info?

Use docker info --format para especificar os campos do modelo Go; a saída do exemplo é 29.9.2 overlayfs 3 containers, 5 images.

Atualizado 26 de outubro de 2026