Blog
Cómo comprobar el espacio en disco en Raspberry Pi
La Raspberry Pi sigue siendo una de las computadoras de placa única más utilizadas en 2026. La gente ejecuta todo en ella: bloqueadores de anuncios Pi-hole, servidores Home Assistant, configuraciones de juegos RetroPie, centros multimedia Jellyfin o Kodi, e incluso experimentos ligeros de IA en modelos más nuevos como la Pi 5 y la Pi 500. Independientemente del caso de uso, el espacio de almacenamiento se convierte en un problema antes de lo esperado.
La mayoría de los sistemas Raspberry Pi todavía arrancan desde tarjetas microSD, típicamente entre 32 GB y 256 GB. Al mismo tiempo, el arranque desde SSD y NVMe conectados por USB se ha vuelto cada vez más popular gracias a un mejor rendimiento de USB y al soporte oficial del gestor de arranque. Si bien el almacenamiento más grande es ahora común, también se llena rápidamente.
Una instalación limpia de Raspberry Pi OS no parece grande al principio. La versión Lite suele ocupar entre 4 y 8 GB, mientras que la edición de escritorio con Chromium y LibreOffice instalados consume aproximadamente de 8 a 12 GB. Sin embargo, en el uso real, el espacio en disco crece rápidamente. Registros del sistema, cachés de paquetes, contenedores de Docker, medios descargados y archivos temporales de actualizaciones periódicas pueden hacer que el uso supere los 20 o incluso los 50 GB en cuestión de semanas.
Una vez que el almacenamiento se agota, surgen problemas. Las instalaciones de paquetes fallan con errores de “No queda espacio en el dispositivo”. Las descargas de imágenes de Docker se interrumpen porque el sistema de archivos raíz está lleno. Los sistemas se vuelven inestables cuando el uso del disco se acerca al 100 por ciento. En las tarjetas microSD, funcionar cerca de su capacidad máxima también acelera el desgaste y aumenta el riesgo de corrupción.
Estos problemas son comunes porque rara vez se supervisa el uso del disco. Los sistemas de archivos no siempre se expanden después de flashear una imagen. Los registros y los datos de Docker crecen sin límites. Los servicios de larga duración que escriben con frecuencia empeoran la situación con el tiempo.
Saber cómo comprobar el espacio en disco es, por lo tanto, esencial para cualquier proyecto de Raspberry Pi. Esta guía muestra comandos de terminal sencillos para comprobaciones rápidas, formas de averiguar exactamente qué está utilizando su almacenamiento y métodos prácticos para mantener el uso del disco bajo control. Ya sea que esté ejecutando un servidor multimedia o un nodo de sensores sin cabeza, estas habilidades ayudarán a mantener su Raspberry Pi estable y confiable.
Comandos básicos y esenciales: df y lsblk
La forma más rápida de comprobar el espacio en disco en una Raspberry Pi es con dos comandos integrados: df y lsblk. No requieren paquetes adicionales y proporcionan una visión inmediata y general de su situación de almacenamiento.
Abre una terminal (a través de SSH, directamente en el escritorio o a través de una sesión remota) y comienza con el comando más utilizado.
Ver el uso general del disco con df
df -h
La opción -h muestra los tamaños en un formato legible para humanos (GB, MB en lugar de bytes brutos).
A continuación se muestra una salida típica de una Raspberry Pi 5 ejecutando Raspberry Pi OS (Trixie), utilizando una tarjeta microSD de 64 GB y un SSD USB conectado:
Sistema de archivos Tamaño Usado Libre Uso% Montado en
/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
Columnas clave para entender
- Sistema de archivos: El dispositivo o partición. (/dev/root representa el sistema de archivos raíz principal, ya sea que resida en una tarjeta microSD o en un SSD).
- Tamaño Capacidad total del sistema de archivos.
- Usado: Espacio actualmente en uso.
- Disponible Espacio disponible para nuevos datos.
- Use%:Porcentaje de espacio utilizado. (Intenta mantenerlo por debajo del 85-90 %, sobre todo en tarjetas microSD.)
- Montado en: Donde el sistema de archivos aparece en el árbol de directorios. (/ es el sistema de archivos raíz; /boot/firmware contiene archivos relacionados con el arranque en Trixie y versiones posteriores).
En Trixie (y lanzamientos tardíos de Bookworm), el sistema de archivos raíz a menudo aparece como /dev/root en lugar de un nombre de dispositivo directo como /dev/mmcblk0p2. Esto es normal; es un symlink a la partición real.
Si solo te preocupa el sistema de archivos principal (que suele ser el que se llena primero), puedes apuntarlo directamente:
df -h /
Desde cualquier directorio, también puedes comprobar a qué sistema de archivos pertenece esa ruta:
df -h .
Identifica discos y particiones con lsblk
Mientras que df muestra el uso, lsblk muestra qué dispositivos de almacenamiento existen y cómo están distribuidos.
lsblk -f
Ejemplo de salida en una Raspberry Pi arrancando desde NVMe (una configuración común en sistemas Pi 5 y Pi 500):
NOMBRE TIPO DE SISTEMA DE ARCHIVOS TAMAÑO PUNTOS DE MONTAJE
mmcblk0 119,1 GB
├─mmcblk0p1 vfat 512 MB /boot/firmware
nvme0n1 238,5 GB
├─nvme0n1p1 ext4 200 G /
└─nvme0n1p2 ext4 38 G /home
sda 931 G
└─sda1 exfat 931 G /media/pi/External
Esta salida muestra claramente:
- Dispositivos (mmcblk0 = microSD, nvme0n1 = SSD NVMe, sda = unidad USB)
- Particiones en cada dispositivo
- Tipos de sistemas de archivos (ext4, vfat, exfat)
- Puntos de montaje
Utilice lsblk siempre que adjunte un nuevo almacenamiento, cambie al arranque con SSD o NVMe, o desee confirmar que una unidad está montada donde espera.
Monitoreo en vivo durante actividad intensa
Para tareas de larga duración como descargas, copias de seguridad o compilaciones de Docker, puede ser útil observar cómo cambia el uso del disco en tiempo real:
watch -n 5 df -h /
Esto actualiza la salida cada cinco segundos y te permite ver cómo aumenta el valor de Use% a medida que se escriben los datos.
¿Cuándo deberías preocuparte?
Si el sistema de archivos raíz supera los 901 TP3T de uso, especialmente en una tarjeta microSD, debes actuar con rapidez. Un uso elevado del disco acelera su desgaste, aumenta el riesgo de errores de escritura y puede provocar errores del tipo “No hay espacio disponible en el dispositivo”, incluso cuando el comando `df` sigue mostrando unos pocos gigabytes libres. Los bloques reservados y el agotamiento de inodos pueden causar problemas antes de que el disco esté técnicamente lleno.
Buscando lo que usa espacio: du, trucos avanzados de du e identificación de culpables
Los comandos como df y lsblk muestran cuánto espacio en disco se está utilizando, pero no explican qué lo está utilizando. Para identificar los verdaderos "devoradores" de espacio, necesitas du.
El comando du estima el uso de disco para directorios y archivos, permitiéndole investigar hasta encontrar los mayores consumidores.
Empieza en tu directorio de inicio
Un primer paso rápido es revisar las carpetas de nivel superior en tu directorio de inicio:
du -sh ~/*
Esto lista el tamaño de cada elemento en tu directorio principal (por ejemplo, Descargas, Documentos, .cache).
La opción -s resume cada directorio y -h mantiene la salida legible para humanos.
En las instalaciones de escritorio, esto a menudo revela grandes cachés del navegador, medios descargados o archivos de proyecto sobrantes.
Explorar el sistema de archivos raíz en busca de directorios grandes
Para obtener una imagen más amplia, escanee el sistema de archivos raíz y ordene los directorios por tamaño. Algunas rutas requieren acceso de root, así que use sudo:
sudo du -h --max-depth=1 / | sort -hr | head -n 15
¿Qué hace este comando:
- Escanea el sistema de archivos raíz (/)
- Limita la salida al primer nivel de directorio (–max-depth=1)
- Ordena los resultados por tamaño, el más grande primero (sort -hr)
- Mostrar solo las 15 primeras entradas
La salida típica en una Raspberry Pi podría verse así:
55 GB /media
2,5 GB /usr
800 MB /var
300 MB /opt
200 MB /home
Valores grandes en /media son comunes si montas unidades externas o almacenas videos y fotos allí.
En muchos sistemas Raspberry Pi, especialmente en configuraciones de 2026, /var es un culpable frecuente debido a los registros y datos de contenedores.
Áreas problemáticas comunes a revisar
Una vez que identifique un directorio sospechoso, concéntrese en estas fuentes comunes de crecimiento de disco.
Registros del sistema y journald
En las versiones recientes de Raspberry Pi OS (Trixie y posteriores), systemd-journald utiliza por defecto almacenamiento volátil en RAM. Si el registro persistente está habilitado, los registros se acumulan en /var/log/journal.
Verificar el uso actual de los registros con:
journalctl --uso-de-disco
Los registros persistentes pueden crecer fácilmente hasta cientos de megabytes si los servicios son ruidosos o cometen errores repetidamente.
Datos de Docker
Si ejecutas contenedores Docker (común para Home Assistant, complementos de Pi-hole o servidores multimedia), el almacenamiento de Docker suele ser el mayor consumidor de espacio.
Verificar el uso del disco de Docker con:
docker system df
Por defecto, los registros del contenedor almacenados en /var/lib/docker/containers/*-json.log crecen sin límites a menos que se configure una rotación de registros. El almacenamiento de superposición (overlay2) puede alcanzar decenas de gigabytes con el tiempo.
Caché de paquetes APT
Los archivos de paquetes descargados se acumulan después de actualizaciones y mejoras:
sudo du -sh /var/cache/apt
Este directorio es seguro para limpiar una vez que se instalan los paquetes.
Encontrar archivos grandes en cualquier lugar
Para localizar archivos individuales de más de 100 MB en todo el sistema:
sudo find / -type f -size +100M -exec ls -lh {} \; 2>/dev/null | sort -hr | head -n 10
Redirigir errores a /dev/null evita el desorden de mensajes de permiso denegado en directorios del sistema.
Los acaparadores típicos de espacio en disco en Raspberry Pi
En configuraciones reales de Raspberry Pi, los mayores culpables suelen ser:
- Imágenes, contenedores y volúmenes de Docker sin podar
- Cachés del navegador en ~/.cache (especialmente Chromium en sistemas de escritorio)
- Medios descargados, copias de seguridad o datos de prueba en /home/pi
- Archivos de registro, datos temporales de actualización y paquetes antiguos en /var
Ejecuta escaneos du regularmente después de actualizaciones importantes, cambios en contenedores o proyectos nuevos. Una vez que sepas qué está consumiendo espacio, la siguiente sección presenta herramientas interactivas y visuales que hacen que la exploración y la limpieza sean más rápidas y seguras.
Herramientas Interactivas y Visuales: ncdu, Analizadores GUI y Más Allá
Después de usar du para identificar directorios grandes, las herramientas interactivas facilitan mucho la exploración y la limpieza. Convierten los números brutos en algo navegable, lo cual es especialmente útil a través de SSH o en sistemas Raspberry Pi con recursos limitados.
ncdu: la herramienta más práctica para la mayoría de los usuarios
Para la mayoría de los usuarios de Raspberry Pi en 2026, la herramienta destacada será ncdu (NCurses Disk Usage). Proporciona una interfaz rápida basada en texto que puedes navegar con el teclado, incluso en sistemas sin cabeza. Utiliza muy poca CPU y memoria y te permite eliminar archivos directamente desde la terminal.
Instálalo desde los repositorios predeterminados del Raspberry Pi OS (Trixie):
sudo apt update
sudo apt install ncdu
Para analizar todo el sistema de archivos raíz:
sudo ncdu -x /
La opción -x mantiene el escaneo dentro del sistema de archivos actual y omite unidades externas montadas. Esto evita escaneos largos de grandes unidades de almacenamiento USB o de red.
Una vez que ncdu se inicia:
- Usa las flechas para navegar
- Presiona Enter o la flecha derecha para abrir un directorio
- Presiona d para marcar un archivo o directorio para su eliminación (confirma con y)
- Pulsa ? para ver el menú de ayuda completo
- Presiona q para salir
ncdu es excelente para descubrir los "devoradores" ocultos de espacio, como los datos de Docker bajo /var/lib/docker, los registros acumulados en /var/log o las cachés grandes en ~/.cache. Para muchos usuarios de Raspberry Pi, es la forma más rápida de liberar espacio en disco sin instalar un entorno de escritorio completo.
Opción de GUI: Analizador de uso de disco (Baobab)
Si estás ejecutando la edición completa de escritorio de Raspberry Pi OS (XFCE en Trixie), puedes usar el Analizador de Uso de Disco incorporado (nombre del paquete: baobab).
Instálalo si es necesario:
sudo apt install baobab
Lánzalo desde el menú de aplicaciones
Herramientas del sistema → Analizador de uso de disco, o inícialo desde la terminal:
baobab
La herramienta te pide que escanees tu directorio principal o todo el sistema de archivos. Escanear el sistema de archivos raíz (/) proporciona la vista más completa.
Baobab proporciona:
- Un gráfico de anillos que muestra los tamaños de los directorios (los anillos interiores son carpetas de nivel superior)
- Un mapa de árbol o vista de lista con tamaño proporcional
- Navegación con clic para hacer zoom y opciones de clic derecho para eliminar o mover archivos
Este enfoque visual ayuda a los usuarios más nuevos a identificar rápidamente patrones, como /var dominando debido a datos de registros o contenedores.
Más allá de las comprobaciones puntuales: monitorización a largo plazo
Para proyectos que siempre están encendidos, como servidores multimedia o sistemas de Home Assistant, considera la monitorización a largo plazo en lugar de comprobaciones manuales. Una configuración común utiliza la recolección de métricas (por ejemplo, Telegraf o exportadores de nodos) combinada con paneles en Grafana para visualizar las tendencias de uso del disco a lo largo del tiempo.
Este enfoque va más allá de la solución básica de problemas, pero ayuda a detectar un crecimiento lento y constante antes de que el espacio en disco se convierta en un problema.
Comparación de herramientas
| Herramienta | Escribir | Mejor para | Escritorio requerido | Borrar archivos |
|---|---|---|---|---|
df / du | CLI (básico) | Vistas generales y escaneos rápidos | No | No |
ncdu | CLI (interactivo) | Exploración profunda y limpieza | No | Sí |
| Baobab | Interfaz gráfica de usuario | Análisis visual y aprendizaje | Sí | Sí |
| Pila de Grafana | Panel web | Seguimiento continuo a lo largo del tiempo | No (navegador) | No |
Estas herramientas cierran la brecha entre las comprobaciones básicas y la gestión práctica del disco. Para la mayoría de las situaciones, ncdu es la mejor primera opción. Si prefiere una respuesta visual, Baobab es una alternativa sólida.
Prevención, Limpieza, Automatización y Mejores Prácticas
Verificar el espacio en disco es reactivo. Prevenir problemas de espacio en disco es proactivo.
En 2026, muchos sistemas Raspberry Pi, especialmente las configuraciones Pi 5 y Pi 500 que arrancan desde SSD o NVMe, tendrán un almacenamiento mucho mayor que las compilaciones antiguas basadas en microSD. Ese espacio adicional a menudo lleva a los usuarios a ignorar el mantenimiento hasta que algo se rompe. Unos pocos hábitos sencillos pueden mantener los proyectos de larga duración estables y predecibles.
Siempre expande el sistema de archivos después de tomar imágenes
Después de flashear Raspberry Pi OS a una tarjeta microSD o SSD más grande, el espacio no utilizado no siempre se asigna automáticamente. Asegúrate de que el sistema de archivos se expanda:
sudo raspi-config
Navegar a Opciones Avanzadas → Ampliar Sistema de Archivos, luego reiniciar.
Este paso asegura que el sistema operativo pueda usar la capacidad total de la unidad.
Realizar limpieza regular
La limpieza ligera y rutinaria previene fallas repentinas. Realizar estos pasos semanal o mensualmente suele ser suficiente.
Limpieza de paquetes de APT
Eliminar paquetes no utilizados y archivos de instalación en caché:
sudo apt update
sudo apt autoremove
sudo apt clean
Esto limpia de forma segura /var/cache/apt y elimina las dependencias obsoletas.
Registros del sistema (journald)
En Raspberry Pi OS basado en Bookworm y Trixie, systemd-journald usa almacenamiento volátil (RAM) por defecto. Los registros se borran al reiniciar a menos que se habilite explícitamente el registro persistente.
Revisar el uso actual de los registros:
journalctl --uso-de-disco
Si habilita el registro persistente y desea limitar su crecimiento, edite:
/etc/systemd/journald.conf
Descomenta y establece:
Almacenamiento=persistente
RuntimeMaxUse=100M
Luego, reinicia journald:
sudo systemctl restart systemd-journald
Esto limita el uso de registros e impide el crecimiento silencioso debajo de /var/log/journal.
Mantenimiento específico de Docker
Para los usuarios de Raspberry Pi que ejecutan Docker (Home Assistant, Pi-hole, servidores multimedia), el almacenamiento de Docker es a menudo el mayor consumidor de disco.
Para eliminar contenedores, imágenes, redes y volúmenes no utilizados:
docker system prune -a --volumes
⚠️ Esto elimina todos los datos de Docker no utilizados. No lo ejecutes si dependes de contenedores detenidos o imágenes no utilizadas.
Para evitar que los registros de contenedores se descontrolen, configure la rotación de registros en daemon.json o docker-compose.yml:
"log-driver": "json-file",
"log-opts": {
"max-size": "50 MB",
"max-file": "5"
}
Reinicia Docker después de aplicar los cambios.
Prefiero arrancar desde SSD o NVMe
Arranque desde SSD o NVMe en modelos compatibles (Pi 5 y Pi 500) proporciona:
- Rendimiento de E/S más rápido
- No desgaste de microSD por escrituras constantes
- Gestión más sencilla de un almacenamiento mayor
Puede flashear Raspberry Pi OS directamente a NVMe usando Raspberry Pi Imager.
Establecer orden de arranque a través de:
raspi-config → Opciones avanzadas → Orden de arranque → NVMe/USB primero
Automatizar alertas de uso de disco
La automatización ayuda a detectar problemas temprano. Una simple verificación diaria del disco puede prevenir sorpresas.
Crea un guion:
nano /home/pi/check_disk.sh
#!/bin/bash
USAGE=$(df -h / | awk 'NR==2 {gsub("%","",$5); print $5}')
if [ "$USAGE" -gt 85 ]; then
echo "Advertencia de uso del disco: ${USAGE}%" \
| mail -s "Alerta de disco de Raspberry Pi" your@email.com
fi
Hazlo ejecutable:
chmod +x /home/pi/check_disk.sh
Añadirlo a cron:
crontab -e
Ejecutar diariamente a las 3 AM:
0 3 * * * /home/pi/check_disk.sh
Para monitorización avanzada, soluciones basadas en métricas como Telegraf con paneles de Grafana pueden visualizar tendencias de uso de disco a lo largo del tiempo.
Consejos para solucionar problemas
df muestra menos espacio del esperado
Asegúrate de que el sistema de archivos esté expandido. En sistemas ext4, verifica también los bloques reservados:
sudo tune2fs -l /dev/root | grep "Reserved block count"
Docker llena el disco silenciosamente
Siempre poda después de los experimentos y habilita la rotación de registros.
Consideraciones finales
Usa df -h para comprobaciones rápidas.
Utilice du y ncdu para identificar los consumidores reales de espacio.
Utiliza herramientas visuales cuando te ayuden a ver patrones más rápido.
Aplica límites preventivos y automatización simple para la estabilidad a largo plazo.
Cinco minutos de mantenimiento regular pueden mantener un Raspberry Pi fiable durante meses, ya sea ejecutando un sistema de automatización del hogar, un servidor multimedia o un nodo de sensores remoto.
Si tu proyecto de Raspberry Pi es más que un experimento personal —y estás pensando en convertir un prototipo en hardware real—PCBCool podemos ayudar. Somos un proveedor de EMS que atiende tanto a empresas como a creadores individuales, sin cantidad mínima de pedido. Desde la fabricación y el ensamblaje de PCB hasta la producción en pequeños lotes, ayudamos a convertir las ideas en productos funcionales, sin las barreras que normalmente conlleva la fabricación.
Preguntas frecuentes (PF)
Los registros, datos de contenedores, cachés y archivos temporales crecen continuamente en sistemas que están siempre encendidos.
R: Se recomienda disponer de al menos 10-151 TP3T de espacio libre para garantizar un funcionamiento estable.
Los bloques reservados o el agotamiento de inodos pueden causar fallos antes de que el disco se utilice por completo.
Sí. Aumenta el desgaste, ralentiza las escrituras y eleva el riesgo de corrupción.
Mejora la fiabilidad y el rendimiento, pero no previene el crecimiento descontrolado del disco.
Sí. Las imágenes, volúmenes y registros permanecen hasta que se eliminan explícitamente.
Sí. Las cachés de Chromium pueden crecer varios gigabytes con el tiempo.
El almacenamiento montado en /media está separado del sistema de archivos raíz.
A: No siempre. A veces se requiere expansión manual después de la obtención de imágenes.
A: Solo si journald está configurado para almacenamiento volátil.
Las cachés de paquetes, las dependencias antiguas y los archivos temporales se conservan a menos que se limpien.
Sí. Los límites de inodos se pueden alcanzar incluso cuando parece haber espacio disponible.
Sí, si los archivos no están activamente en uso por servicios en ejecución.
Es mejor colocar los datos que se escriben mucho en SSD o almacenamiento externo.
Raramente, pero los paquetes residuales pueden permanecer después de las actualizaciones.
Los servicios en segundo plano, los registros y las tareas programadas escriben continuamente.
Sí. El almacenamiento en red montado puede ocultar los límites del disco local.
Sí para uso ligero, pero la separación mejora la estabilidad en cargas de trabajo pesadas.
Los sistemas de archivos temporales y los registros volátiles se borran al arrancar.
Loki ha trabajado en comercio internacional y en PCB desde 2021, con experiencia en fabricación de PCB, ensamblaje y comunicación con clientes. En PCBCool, apoya la publicación de contenido técnico y ayuda a conectar las consultas de los clientes con el gerente de cuenta adecuado para un seguimiento eficiente de los proyectos.