Guía de Referencia de ncdu - Analizador de Uso de Disco NCurses
ncdu (NCurses Disk Usage) es un analizador de uso de disco interactivo que se ejecuta completamente en la terminal. Escanea un árbol de directorios una vez, luego te permite navegarlo ordenado por tamaño, profundizar en subdirectorios y eliminar archivos o carpetas en el acto. Porque solo necesita una terminal, es la herramienta de referencia para encontrar qué está consumiendo espacio en un servidor sin cabeza o remoto a través de SSH.
Instalación
| 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 | Descripción |
|---|
ncdu | Escanear el directorio actual |
ncdu / | Escanear todo el sistema de archivos |
ncdu /var/log | Escanear una ruta específica |
ncdu -x / | Mantenerse en un sistema de archivos (no cruzar puntos de montaje) |
sudo ncdu / | Escanear con root para incluir archivos protegidos |
ncdu --help | Mostrar todas las opciones |
Teclas de Navegación
| Tecla | Acción |
|---|
↑ / ↓ o j / k | Mover la selección |
→ / Enter o l | Entrar en el directorio seleccionado |
← o h | Ir al directorio padre |
n | Ordenar por nombre |
s | Ordenar por tamaño (predeterminado) |
C | Ordenar por número de elementos |
a | Alternar tamaño aparente vs uso de disco |
g | Alternar pantalla de porcentaje / gráfico |
? | Pantalla de ayuda |
q | Salir |
Gestionando Archivos
| Tecla | Acción |
|---|
d | Eliminar el archivo o directorio seleccionado |
i | Mostrar información sobre el elemento seleccionado |
t | Alternar directorios-antes-que-archivos en orden |
e | Mostrar/ocultar archivos ocultos |
r | Recalcular (rescanear) el directorio actual |
Exportar e Importar (Flujos de Trabajo Remotos)
ncdu puede guardar un escaneo en un archivo y verlo después o en otro lugar — excelente para auditar un servidor sin mantener una sesión SSH abierta.
| Comando | Descripción |
|---|
ncdu -o scan.json / | Escanear y exportar resultados a un archivo |
ncdu -o- / > scan.json | Exportar a stdout (redireccionar a un archivo) |
ncdu -f scan.json | Abrir un escaneo guardado previamente (sin conexión) |
ssh host 'ncdu -o- /' > scan.json | Escanear una máquina remota, navegarla localmente |
Opciones Vale la Pena Conocer
| Opción | Descripción |
|---|
-x | No cruzar límites del sistema de archivos |
--exclude PATTERN | Saltar rutas que coincidan con un glob |
--exclude-kernfs | Saltar pseudo-sistemas de archivos (/proc, /sys) |
-r | Modo solo lectura (deshabilitar eliminar) |
-q | Actualización silenciosa/más lenta en enlaces lentos |
--color dark | Habilitar esquema de color |
Flujos de Trabajo Comunes
# Find the biggest space hogs on a server, safely (read-only)
sudo ncdu -x -r /
# Audit a remote host without an interactive session
ssh prod-box 'ncdu -o- -x /' > prod-scan.json
ncdu -f prod-scan.json
# Clean a build cache directory interactively
ncdu ~/.cache # navigate, press d to delete
ncdu vs Otras Herramientas de Uso de Disco
| Herramienta | Estilo | Mejor para |
|---|
| ncdu | TUI interactiva | Navegar + eliminar, servidores remotos |
| dust | Árbol+barras de una sola vez | Resumen visual rápido (Rust) |
| duf | Tablas de montajes/uso | ”¿Cuán llenos están mis discos?“ |
| du | Texto plano | Scripts y pipelines |
Recursos
