Cheatsheet ncdu - Analisador de Uso de Disco NCurses
ncdu (NCurses Disk Usage) é um analisador interativo de uso de disco que roda inteiramente no terminal. Ele escaneia uma árvore de diretório uma vez, então deixa você navegar por ela classificada por tamanho, detalhar subdirectórios, e deletar arquivos ou pastas no mesmo local. Porque precisa apenas de um terminal, é a ferramenta ir-para para encontrar o que está comendo espaço em um servidor headless ou remoto sobre SSH.
Instalação
| Plataforma | Comando |
|---|
| Ubuntu/Debian | sudo apt install ncdu |
| Fedora/RHEL | sudo dnf install ncdu |
| Arch Linux | sudo pacman -S ncdu |
| openSUSE | sudo zypper install ncdu |
| Alpine | sudo apk add ncdu |
| macOS (Homebrew) | brew install ncdu |
| FreeBSD | sudo pkg install ncdu |
Uso Básico
| Comando | Descrição |
|---|
ncdu | Escaneia o diretório atual |
ncdu / | Escaneia todo o filesystem |
ncdu /var/log | Escaneia um caminho específico |
ncdu -x / | Fique em um filesystem (não cruze mount points) |
sudo ncdu / | Escaneia com root para incluir arquivos protegidos |
ncdu --help | Mostra todas as opções |
Teclas de Navegação
| Tecla | Ação |
|---|
↑ / ↓ ou j / k | Move a seleção |
→ / Enter ou l | Entra no diretório selecionado |
← ou h | Sobe para o diretório pai |
n | Classifica por nome |
s | Classifica por tamanho (padrão) |
C | Classifica por contagem de itens |
a | Alterna tamanho aparente vs uso de disco |
g | Alterna exibição de percentual / gráfico |
? | Tela de ajuda |
q | Sair |
Gerenciando Arquivos
| Tecla | Ação |
|---|
d | Deleta o arquivo ou diretório selecionado |
i | Mostra informações sobre o item selecionado |
t | Alterna diretórios-antes-de-arquivos na classificação |
e | Mostra/oculta arquivos ocultos |
r | Recalcula (rescanseia) o diretório atual |
Exportar e Importar (Fluxos de Trabalho Remotos)
ncdu pode salvar um scan em um arquivo e visualizá-lo depois ou em outro lugar — ótimo para auditar um servidor sem manter uma sessão SSH aberta.
| Comando | Descrição |
|---|
ncdu -o scan.json / | Escaneia e exporta resultados para um arquivo |
ncdu -o- / > scan.json | Exporta para stdout (redirecione para um arquivo) |
ncdu -f scan.json | Abre um scan previamente salvo (offline) |
ssh host 'ncdu -o- /' > scan.json | Escaneia uma box remota, navegue localmente |
Opções Vale a Pena Conhecer
| Opção | Descrição |
|---|
-x | Não cruze limites de filesystem |
--exclude PATTERN | Pule caminhos que correspondem a um glob |
--exclude-kernfs | Pule pseudo-filesystems (/proc, /sys) |
-r | Modo somente-leitura (desabilita delete) |
-q | Atualização quieta/mais lenta em links lentos |
--color dark | Habilita um esquema de cor |
Fluxos de Trabalho Comuns
# Encontra os maiores space hogs em um servidor, com segurança (somente-leitura)
sudo ncdu -x -r /
# Audita um host remoto sem uma sessão interativa
ssh prod-box 'ncdu -o- -x /' > prod-scan.json
ncdu -f prod-scan.json
# Limpa um diretório de cache de build interativamente
ncdu ~/.cache # navigate, press d to delete
ncdu vs Outras Ferramentas de Uso de Disco
| Ferramenta | Estilo | Melhor para |
|---|
| ncdu | TUI interativo | Navegar + deletar, servidores remotos |
| dust | Árvore one-shot+barras | Visão geral visual rápida (Rust) |
| duf | Tabelas de Mounts/uso | ”Quão cheios estão meus discos?“ |
| du | Texto simples | Scripting e pipelines |
Recursos
