Blog
Como verificar o espaço em disco no Raspberry Pi
O Raspberry Pi continua sendo um dos computadores de placa única mais amplamente utilizados em 2026. As pessoas executam tudo nele — bloqueadores de anúncios Pi-hole, servidores Home Assistant, configurações de jogos RetroPie, centrais de mídia Jellyfin ou Kodi e até mesmo experimentos leves de IA em modelos mais recentes como o Pi 5 e o Pi 500. Independentemente do caso de uso, o espaço de armazenamento se torna um problema antes do esperado.
A maioria dos sistemas Raspberry Pi ainda inicializa a partir de cartões microSD, geralmente com capacidade entre 32 GB e 256 GB. Ao mesmo tempo, a inicialização a partir de SSDs e NVMe conectados por USB tem se tornado cada vez mais popular, graças ao melhor desempenho do USB e ao suporte oficial do bootloader. Embora o armazenamento de maior capacidade seja agora comum, ele também fica cheio rapidamente.
Uma instalação limpa do Raspberry Pi OS não parece grande à primeira vista. A versão Lite geralmente ocupa cerca de 4–8 GB, enquanto a edição Desktop com Chromium e LibreOffice instalados consome aproximadamente 8–12 GB. No uso real, no entanto, o uso do disco cresce rapidamente. Logs do sistema, caches de pacotes, contêineres Docker, mídias baixadas e arquivos temporários de atualizações regulares podem levar o uso para mais de 20 ou até 50 GB em poucas semanas.
Quando o armazenamento fica escasso, problemas surgem. Instalações de pacotes falham com erros de “Sem espaço no dispositivo”. Puxadas de imagens Docker falham porque o sistema de arquivos raiz está cheio. Sistemas se tornam instáveis quando o uso do disco se aproxima de 100%. Em cartões microSD, operar perto da capacidade máxima também acelera o desgaste e aumenta o risco de corrupção.
Essas questões são comuns porque o uso do disco raramente é monitorado. Os sistemas de arquivos nem sempre são expandidos após a gravação de uma imagem. Logs e dados do Docker crescem sem limites. Serviços de longa duração que escrevem com frequência pioram a situação ao longo do tempo.
Saber verificar o espaço em disco é, portanto, essencial para qualquer projeto com Raspberry Pi. Este guia apresenta comandos simples de terminal para verificações rápidas, maneiras de descobrir exatamente o que está usando seu armazenamento e métodos práticos para manter o uso do disco sob controle. Quer você esteja executando um servidor de mídia ou um nó de sensor sem interface gráfica, essas habilidades ajudarão a manter seu Raspberry Pi estável e confiável.
Comandos Básicos e Essenciais: df e lsblk
A maneira mais rápida de verificar o espaço em disco em um Raspberry Pi é com dois comandos integrados: `df` e `lsblk`. Eles não exigem pacotes adicionais e fornecem uma visão imediata e de alto nível da sua situação de armazenamento.
Abra um terminal (via SSH, diretamente no desktop ou através de uma sessão remota) e comece com o comando mais comumente utilizado.
Verificar o uso geral do disco com df
df -h
A opção -h exibe os tamanhos em um formato legível por humanos (GB, MB em vez de bytes brutos).
Abaixo está uma saída típica de um Raspberry Pi 5 executando o Raspberry Pi OS (Trixie), utilizando um cartão microSD de 64 GB e um SSD USB conectado:
Sistema de arquivos Tamanho Usado Disponível Uso% Montado em
/dev/root 59G 12G 45G 21% /
/dev/mmcblk0p1 512M 128M 384M 25% /boot/firmware
/dev/sda1 931G 250G 681G 27% /media/pi/SSD
tmpfs 3,8G 0 3,8G 0% /dev/shm
tmpfs 1,6G 1,2M 1,6G 1% /run
tmpfs 5,0M 0 5,0M 0% /run/lock
Colunas-chave para entender
- Sistema de Arquivos O dispositivo ou partição. (/dev/root representa o sistema de arquivos raiz principal, independentemente de residir em um cartão microSD ou SSD.)
- Tamanho: Capacidade total do sistema de arquivos.
- Usado Espaço atualmente em uso.
- Disponível: Espaço disponível para novos dados.
- Use%:Porcentagem de espaço utilizado. (Procure manter esse valor abaixo de 85–90%, especialmente em cartões microSD.)
- Montado em: Onde o sistema de arquivos aparece na árvore de diretórios. (/ é o sistema de arquivos raiz; /boot/firmware contém arquivos relacionados à inicialização nas versões Trixie e posteriores.)
Em Trixie (e versões recentes do Bookworm), o sistema de arquivos raiz frequentemente aparece como /dev/root em vez de um nome de dispositivo direto, como /dev/mmcblk0p2. Isso é normal — é um link simbólico para a partição real.
Se você se preocupa apenas com o sistema de arquivos principal (que geralmente é o que enche primeiro), você pode direcioná-lo diretamente:
df -h /
A partir de qualquer diretório, você também pode verificar a qual sistema de arquivos esse caminho pertence:
df -h .
Identificar discos e partições com lsblk
Enquanto o df mostra o uso, o lsblk exibe quais dispositivos de armazenamento existem e como estão organizados.
lsblk -f
Exemplo de saída em um Raspberry Pi inicializando a partir de NVMe (uma configuração comum em sistemas Pi 5 e Pi 500):
NOME TIPO DE SISTEMA DE ARQUIVOS TAMANHO PONTOS DE MONTAGEM
mmcblk0 119,1 G
├─mmcblk0p1 vfat 512 M /boot/firmware
nvme0n1 238,5 G
├─nvme0n1p1 ext4 200G /
└─nvme0n1p2 ext4 38G /home
sda 931G
└─sda1 exfat 931G /media/pi/External
Este resultado demonstra claramente:
- Dispositivos (mmcblk0 = microSD, nvme0n1 = NVMe SSD, sda = unidade USB)
- Partições em cada dispositivo
- Tipos de sistema de arquivos (ext4, vfat, exfat)
- Pontos de montagem
Utilize `lsblk` sempre que anexar novo armazenamento, mudar para inicialização a partir de SSD ou NVMe, ou quando desejar confirmar se uma unidade está montada onde você espera.
Monitoramento ao vivo durante atividades intensas
Para tarefas de longa duração, como downloads, backups ou compilações do Docker, pode ser útil monitorar o uso de disco em tempo real:
watch -n 5 df -h /
Isso atualiza a exibição a cada cinco segundos e permite que você observe o aumento do Use% à medida que os dados são gravados.
Quando devemos nos preocupar?
Se o sistema de arquivos raiz ultrapassar 90% de uso, especialmente em um cartão microSD, é recomendável agir rapidamente. O uso elevado do disco acelera o desgaste, aumenta o risco de erros de gravação e pode provocar falhas do tipo “Não há mais espaço no dispositivo” — mesmo quando o comando `df` ainda mostra alguns gigabytes livres. Blocos reservados e o esgotamento de inodes podem causar problemas antes que o disco esteja tecnicamente cheio.
Encontrando o que está ocupando espaço: du, truques avançados do du e identificando os culpados
Comandos como `df` e `lsblk` mostram quanto espaço em disco está sendo utilizado, mas não explicam o que está utilizando esse espaço. Para identificar os verdadeiros consumidores de espaço, você precisa do `du`.
O comando `du` estima o uso de disco para diretórios e arquivos, permitindo que você navegue até encontrar os maiores consumidores.
Comece no seu diretório pessoal
Um primeiro passo rápido é verificar as pastas de nível superior em seu diretório inicial:
du -sh ~/*
Isso lista o tamanho de cada item em seu diretório pessoal (por exemplo, Downloads, Documentos, .cache).
A opção -s resume cada diretório, e -h mantém a saída legível por humanos.
Em instalações de desktop, isso frequentemente revela grandes caches de navegador, mídia baixada ou arquivos de projeto remanescentes.
Escanear o sistema de arquivos raiz em busca de diretórios grandes
Para obter uma visão mais abrangente, escaneie o sistema de arquivos raiz e ordene os diretórios por tamanho. Alguns caminhos exigem acesso de root, portanto, use sudo:
sudo du -h --max-depth=1 / | sort -hr | head -n 15
O que este comando faz:
- Escaneia o sistema de arquivos raiz (/)
- Limita a saída ao primeiro nível de diretório (–max-depth=1)
- Classifica os resultados por tamanho, em ordem decrescente (sort -hr)
- Exibe somente as 15 primeiras entradas
Uma saída típica em um Raspberry Pi pode parecer com isto:
55G /media
2,5G /usr
800M /var
300M /opt
200M /home
Valores grandes sob /media são comuns se você montar unidades externas ou armazenar vídeos e fotos lá.
Em muitos sistemas Raspberry Pi, especialmente em configurações de 2026, `/var` é um culpado frequente devido a logs e dados de contêineres.
Áreas comuns de problemas a serem verificadas
Ao identificar um diretório suspeito, concentre-se nestas fontes comuns de crescimento de disco.
Registros do sistema e journald
Nas versões recentes do Raspberry Pi OS (Trixie e posteriores), o systemd-journald utiliza por padrão armazenamento volátil na RAM. Caso o registro persistente seja habilitado, os logs se acumularão em /var/log/journal.
Verifique o uso atual de logs com:
journalctl --uso-de-disco
Registros persistentes podem facilmente atingir centenas de megabytes se os serviços forem excessivamente detalhados ou apresentarem erros repetidamente.
Dados do Docker
Se você executa contêineres Docker (comuns para Home Assistant, add-ons Pi-hole ou servidores de mídia), o armazenamento Docker é frequentemente o maior consumidor de espaço.
Verificar o uso de disco do Docker com:
docker system df
Por padrão, os logs de contêineres armazenados em /var/lib/docker/containers/*-json.log crescem ilimitadamente, a menos que a rotação de logs seja configurada. O armazenamento overlay (overlay2) pode atingir dezenas de gigabytes ao longo do tempo.
Cache de pacotes APT
Os arquivos de pacotes baixados se acumulam após atualizações e upgrades:
sudo du -sh /var/cache/apt
Este diretório é seguro para limpeza após a instalação dos pacotes.
Encontrando arquivos grandes em qualquer lugar
Para localizar arquivos individuais maiores que 100 MB em todo o sistema:
sudo find / -type f -size +100M -exec ls -lh {} \; 2>/dev/null | sort -hr | head -n 10
Redirecionar erros para /dev/null evita a poluição por mensagens de permissão negada em diretórios do sistema.
Os principais consumidores de espaço em disco em um Raspberry Pi
Em configurações reais de Raspberry Pi, os maiores culpados geralmente são:
- Imagens, contêineres e volumes do Docker não podados
- Caches de navegador sob ~/.cache (especialmente Chromium em sistemas desktop)
- Mídia baixada, backups ou dados de teste em /home/pi
- Arquivos de log, dados temporários de atualização e pacotes antigos em /var
Execute scaneamentos regularmente após grandes atualizações, alterações de contêineres ou novos projetos. Assim que você souber o que está consumindo espaço, a próxima seção apresentará ferramentas interativas e visuais que tornam a exploração e a limpeza mais rápidas e seguras.
Ferramentas Interativas e Visuais: ncdu, Analisadores GUI e Além
Após o uso do `du` para identificar diretórios grandes, ferramentas interativas facilitam muito a exploração e a limpeza. Elas transformam números brutos em algo navegável, o que é especialmente útil via SSH ou em sistemas Raspberry Pi com recursos limitados.
ncdu: a ferramenta mais prática para a maioria dos usuários
Para a maioria dos usuários de Raspberry Pi em 2026, a ferramenta de destaque será o ncdu (NCurses Disk Usage). Ele oferece uma interface textual rápida que pode ser navegada com o teclado, mesmo em sistemas headless. Utiliza muito pouca CPU e memória, permitindo a exclusão de arquivos diretamente pelo terminal.
Instale-o a partir dos repositórios padrão do Raspberry Pi OS (Trixie):
sudo apt update
sudo apt install ncdu
Para analisar todo o sistema de arquivos raiz:
sudo ncdu -x /
A opção -x mantém a varredura dentro do sistema de arquivos atual e ignora unidades externas montadas. Isso evita varreduras longas de dispositivos de armazenamento USB ou de rede de grande porte.
Assim que o ncdu iniciar:
- Use as setas para navegar
- Pressione Enter ou a seta para a direita para abrir um diretório
- Pressione d para marcar um arquivo ou diretório para exclusão (confirme com y)
- Pressione ? para visualizar o menu de ajuda completo
- Pressione q para sair
O ncdu é excelente para descobrir grandes consumidores de espaço ocultos, como dados do Docker em /var/lib/docker, logs acumulados em /var/log ou caches grandes em ~/.cache. Para muitos usuários de Raspberry Pi, é a maneira mais rápida de liberar espaço em disco sem instalar um ambiente de desktop completo.
Opção da GUI: Analisador de Uso de Disco (Baobab)
Se você estiver executando a edição completa Desktop do Raspberry Pi OS (XFCE no Trixie), poderá usar o Analisador de Uso de Disco integrado (nome do pacote: baobab).
Instale-o, se necessário:
sudo apt install baobab
Inicie-o a partir do menu do aplicativo
Ferramentas do Sistema → Analisador de Uso de Disco, ou inicie-o pelo terminal:
baobá
A ferramenta solicita que você escaneie seu diretório pessoal ou o sistema de arquivos completo. Escanear o sistema de arquivos raiz (/) oferece a visualização mais completa.
O Baobab oferece:
- Um gráfico em anel mostrando os tamanhos de diretórios (anéis internos são pastas de nível superior)
- Um treemap ou visualização em lista com dimensionamento proporcional
- Navegação com clique para zoom e opções de clique com o botão direito para excluir ou mover arquivos
Essa abordagem visual ajuda usuários novos a identificar rapidamente padrões, como o diretório `/var` dominando devido a logs ou dados de contêineres.
Além de verificações pontuais: monitoramento de longo prazo
Para projetos de execução contínua, como servidores de mídia ou sistemas Home Assistant, considere o monitoramento de longo prazo em vez de verificações manuais. Uma configuração comum utiliza a coleta de métricas (por exemplo, Telegraf ou node exporters) combinada com dashboards em Grafana para visualizar tendências de uso de disco ao longo do tempo.
Esta abordagem vai além da resolução básica de problemas, mas ajuda a identificar um crescimento lento e constante antes que o espaço em disco se torne um problema.
Comparação de ferramentas
| Ferramenta | Digitar | Melhor para | Desktop necessário | Excluir arquivos |
|---|---|---|---|---|
df / du | CLI (básico) | Visão geral rápida e varreduras | Não | Não |
ncdu | CLI (interativo) | Exploração e limpeza aprofundadas | Não | Sim |
| Báobá | Interface Gráfica do Usuário | Análise visual e aprendizado | Sim | Sim |
| Pilha Grafana | Painel da Web | Monitoramento contínuo ao longo do tempo | No (navegador) | Não |
Estas ferramentas preenchem a lacuna entre verificações básicas e o gerenciamento prático de disco. Para a maioria das situações, o ncdu é a melhor opção inicial. Se você prefere feedback visual, o Baobab é uma alternativa sólida.
Prevenção, Limpeza, Automação e Melhores Práticas
Verificar o espaço em disco é reativo. Prevenir problemas de espaço em disco é proativo.
Em 2026, muitos sistemas Raspberry Pi—especialmente configurações Pi 5 e Pi 500 inicializando a partir de SSD ou NVMe—terão armazenamento muito maior do que sistemas mais antigos baseados em microSD. Esse espaço extra muitas vezes leva os usuários a ignorar a manutenção até que algo quebre. Alguns hábitos simples podem manter projetos de longa duração estáveis e previsíveis.
Sempre expanda o sistema de arquivos após a criação da imagem.
Após a gravação do Raspberry Pi OS em um cartão microSD ou SSD maior, o espaço não utilizado nem sempre é alocado automaticamente. Certifique-se de que o sistema de arquivos foi expandido:
sudo raspi-config
Navegue até Opções Avançadas → Expandir Sistema de Arquivos e, em seguida, reinicie.
Este passo assegura que o sistema operacional possa utilizar a capacidade total do disco.
Realizar limpeza regular
Uma limpeza leve e rotineira evita falhas repentinas. Executar essas etapas semanalmente ou mensalmente geralmente é suficiente.
Limpeza de pacotes APT
Remover pacotes não utilizados e arquivos de instalação em cache:
sudo apt update
sudo apt autoremove
sudo apt clean
Isso limpa com segurança o /var/cache/apt e remove dependências obsoletas.
Registros do sistema (journald)
No Raspberry Pi OS baseado em Bookworm e Trixie, o systemd-journald utiliza armazenamento volátil (RAM) por padrão. Os logs são limpos na reinicialização, a menos que o registro persistente seja explicitamente habilitado.
Verifique o uso atual dos logs:
journalctl --uso-de-disco
Se você ativar o registro persistente e desejar limitar o crescimento, edite:
/etc/systemd/journald.conf
Descomente e defina:
Storage=persistent
RuntimeMaxUse=100M
Em seguida, reinicie o journald:
sudo systemctl restart systemd-journald
Isto limita o uso do *log* e previne o crescimento silencioso em /var/log/journal.
Manutenção Específica de Docker
Para usuários de Raspberry Pi executando Docker (Home Assistant, Pi-hole, servidores de mídia), o armazenamento do Docker é frequentemente o maior consumidor de disco.
Para remover contêineres, imagens, redes e volumes não utilizados:
docker system prune -a --volumes
⚠️ Isso exclui todos os dados Docker não utilizados. Não execute caso dependa de contêineres parados ou imagens não utilizadas.
Para evitar que os logs dos contêineres se tornem descontrolados, configure a rotação de logs no daemon.json ou docker-compose.yml:
"log-driver": "json-file",
"log-opts": {
"max-size": "50m",
"max-file": "5"
}
Reinicie o Docker após aplicar as alterações.
Preferir inicialização por SSD ou NVMe
Inicializar a partir de SSD ou NVMe em modelos suportados (Pi 5 e Pi 500) fornece:
- Melhor desempenho de E/S
- Sem desgaste no microSD por escritas constantes
- Gestão mais fácil de armazenamento maior
É possível gravar o Raspberry Pi OS diretamente em um drive NVMe utilizando o Raspberry Pi Imager.
Definir ordem de inicialização via:
raspi-config → Opções avançadas → Ordem de boot → NVMe/USB primeiro
Automatizar alertas de uso de disco
A automação ajuda a identificar problemas precocemente. Uma simples verificação diária de disco pode prevenir surpresas.
Criar um roteiro:
nano /home/pi/check_disk.sh
#!/bin/bash
USAGE=$(df -h / | awk 'NR==2 {gsub("%","",$5); print $5}')
if [ "$USAGE" -gt 85 ]; then
echo "Aviso de uso do disco: ${USAGE}%" \
| mail -s "Alerta de disco do Raspberry Pi" your@email.com
fi
Torná-lo executável:
chmod +x /home/pi/check_disk.sh
Adicione ao cron:
crontab -e
Executar diariamente às 3 da manhã:
0 3 * * * /home/pi/check_disk.sh
Para monitoramento avançado, soluções baseadas em métricas como o Telegraf com dashboards Grafana podem visualizar tendências de uso de disco ao longo do tempo.
Dicas de Solução de Problemas
O comando df mostra menos espaço do que o esperado.
Certifique-se de que o sistema de arquivos foi expandido. Em sistemas ext4, verifique também os blocos reservados:
sudo tune2fs -l /dev/root | grep "Contagem de blocos reservados"
O Docker enche disco silenciosamente
Sempre realize a poda após os experimentos e habilite a rotação de logs.
Considerações Finais
Utilize `df -h` para verificações rápidas.
Utilize du e ncdu para identificar os reais consumidores de espaço.
Utilize ferramentas visuais quando elas ajudarem a identificar padrões mais rapidamente.
Aplique limites preventivos e automação simples para estabilidade de longo prazo.
Cinco minutos de manutenção regular podem manter um Raspberry Pi confiável por meses — seja ele executando um sistema de automação residencial, um servidor de mídia ou um nó de sensor remoto.
Se o seu projeto com Raspberry Pi for mais do que um experimento pessoal — e você estiver pensando em transformar um protótipo em hardware real —PCBCool Podemos ajudar. Somos um provedor de EMS que atende tanto empresas quanto fabricantes individuais, sem quantidade mínima de pedido. Desde a fabricação e montagem de PCB até a produção em pequenos lotes, ajudamos a transformar ideias em produtos funcionais – sem as barreiras que normalmente acompanham a fabricação.
Perguntas Frequentes (FAQ)
Registros, dados de contêineres, caches e arquivos temporários crescem continuamente em sistemas sempre ativos.
R: Recomenda-se pelo menos 10–15% de espaço livre para um funcionamento estável.
Blocos reservados ou esgotamento de inodos podem causar falhas antes que o disco seja totalmente utilizado.
Sim. Aumenta o desgaste, retarda as escritas e eleva o risco de corrupção.
A: Melhora a confiabilidade e o desempenho, mas não impede o crescimento descontrolado do disco.
Sim. Imagens, volumes e logs permanecem até serem explicitamente removidos.
Sim. Os caches do Chromium podem crescer vários gigabytes ao longo do tempo.
O armazenamento montado em /media é separado do sistema de arquivos raiz.
Nem sempre. Às vezes, é necessária uma expansão manual após a imagem.
A: Somente se o journald estiver configurado para armazenamento volátil.
Os caches de pacotes, dependências antigas e arquivos temporários são retidos a menos que sejam limpos.
Sim. Os limites de inodos podem ser atingidos mesmo quando há espaço disponível.
Sim, caso os arquivos não estejam ativamente em uso por serviços em execução.
É melhor alocar dados com alta frequência de escrita em SSD ou em armazenamento externo.
Raramente, mas pacotes remanescentes podem permanecer após atualizações.
Os serviços em segundo plano, logs e tarefas agendadas escrevem continuamente.
Sim. Armazenamento de rede montado pode ocultar limites de disco local.
Sim, para uso leve, mas a separação melhora a estabilidade em cargas de trabalho pesadas.
Arquivos temporários e logs voláteis são limpos na inicialização.
Loki atua no comércio internacional e em PCBs desde 2021, com experiência em fabricação, montagem e comunicação com clientes de PCBs. Na PCBCool, ele apoia a publicação de conteúdo técnico e auxilia na conexão de solicitações de clientes com o gerente de conta adequado para acompanhamento eficiente de projetos.
