El enfoque seguro consiste en tratar la estabilización de las escrituras, la recuperación de espacio de trabajo, la ejecución únicamente de un balance filtrado y la verificación de los datos antes de volver al servicio normal como una secuencia de controles observables, no como un solo comando.
En un sistema de archivos Btrfs de un servidor doméstico casi lleno, el riesgo práctico es que Btrfs informe ENOSPC o pase a ser de solo lectura cuando se agote el espacio de metadatos. Registra la identidad actual y el punto de recuperación, empieza por el diferenciador menos invasivo, interpreta los resultados aprobados y fallidos antes de cambiar otra variable, y detente cuando el almacenamiento se vuelva inestable o cuando la única copia recuperable pudiera quedar expuesta. El flujo de trabajo siguiente solo termina después de que la carga de trabajo original funcione correctamente o de que la evidencia alcance un límite de escalamiento.
Estabiliza el sistema de archivos antes de intentar repararlo
Detén los contenedores, las descargas, las instantáneas y los trabajos que generen muchos registros y escriban en el sistema de archivos afectado. Guarda los errores del kernel y la salida de btrfs device stats en otra ubicación. Si el sistema de archivos se volvió a montar como de solo lectura o informa errores de suma de comprobación, de transacción principal o de E/S, mantenlo como de solo lectura hasta disponer de una copia recuperable.
No empieces con btrfs check --repair, un balance completo, la desfragmentación ni el borrado masivo. La pregunta inmediata es si el estado válido del sistema de archivos carece de espacio de trabajo para asignaciones o si los errores de almacenamiento están dañando los metadatos; actuar primero con una reparación puede dificultar esa distinción y consumir el espacio restante.
El control de seguridad se supera cuando los servicios con muchas escrituras están detenidos, los datos importantes tienen otra copia y sabes qué dispositivo de bloques y punto de montaje estás examinando. Escala a la creación de una imagen de recuperación si el dispositivo se reinicia, desaparece o acumula errores de lectura.
Lee la asignación en lugar de basarte en la cifra general de espacio libre
Ejecuta btrfs filesystem usage -T /mount, btrfs filesystem df /mount y btrfs device usage /mount, e inspecciona los mensajes recientes del kernel. Compara los metadatos asignados con los utilizados y el espacio sin asignar disponible en cada dispositivo; el comando df normal por sí solo no puede mostrar si Btrfs puede asignar otro bloque de metadatos.
Un balance específico necesita espacio de trabajo completamente libre. Una guía detallada para realizar un balance específico de Btrfs explica que un balance sin filtros reescribe todos los grupos de bloques aptos y que el objetivo es mantener espacio sin asignar a nivel de dispositivo, no simplemente eliminar un archivo grande y suponer que los metadatos pueden crecer.
Si el uso de metadatos es alto pero queda espacio sin asignar, un balance filtrado pequeño puede recuperar bloques vacíos o poco utilizados. Si ningún dispositivo tiene espacio de trabajo, primero elimina de forma segura datos prescindibles o instantáneas en lotes pequeños, o añade un dispositivo temporal adecuado al perfil del sistema de archivos; no inicies una reubicación que no pueda finalizar.
Recupera espacio de trabajo con la acción menos invasiva
Empieza eliminando archivos desechables que no estén retenidos por instantáneas y, después, elimina únicamente las instantáneas que hayas confirmado que no necesitas. Sincroniza y vuelve a comprobar el uso después de cada cambio pequeño. Si un balance está justificado, empieza con btrfs balance start -dusage=0 -musage=0 /mount u otro filtro limitado elegido a partir de la asignación observada, no con un balance completo.
La descripción del manual de Linux sobre el comportamiento del balance filtrado señala que los filtros limitan la reubicación y que puede producirse ENOSPC cuando el propio balance carece de espacio de trabajo. Supervisa btrfs balance status y los registros del kernel. Si la reubicación aumenta los errores, se detiene con fallos del dispositivo o consume el último margen de seguridad, cancélala y vuelve a la recuperación en modo de solo lectura.
No combines filtros y eliminaciones sin medir entre cada paso. La rama de recuperación tiene éxito cuando los metadatos disponen de margen, existe espacio sin asignar en los dispositivos necesarios y una escritura pequeña se completa sin un nuevo ENOSPC ni un cambio forzado a solo lectura.
Verifica los datos y evita una recaída inmediata
Reinicia un solo servicio de bajo riesgo y reproduce la carga de trabajo que originalmente llenó los metadatos, como la creación de instantáneas o muchos cambios en archivos pequeños. Vuelve a comprobar el uso y los registros del kernel después de la carga de trabajo y de un reinicio. Un montaje que funciona una vez pero vuelve a ser de solo lectura con la actividad normal no está recuperado.
Usa el método de ZimaSpace para distinguir si el espacio de la NAS lo ocupan instantáneas o archivos activos antes de cambiar la retención. Los bloques retenidos por instantáneas pueden hacer que la eliminación parezca ineficaz, mientras que la actividad continua con muchos archivos pequeños puede mantener alta la presión sobre los metadatos; la política correcta depende del estado que demuestren las mediciones.
Reanuda el servicio normal solo después de que el sistema de archivos permanezca escribible, las estadísticas del dispositivo dejen de aumentar, un archivo representativo se restaure o genere sumas de comprobación correctas y la supervisión emita alertas antes de que desaparezca el mismo margen. Escala los errores estructurales persistentes a un especialista en recuperación de Btrfs y trabaja desde un clon en lugar de repetir comandos de reparación sobre la única copia.
Soporte y Consejos
Más para leer

Lista de verificación de migración de NFS para conjuntos de datos renombrados y controladores de archivo estables
Supón que los identificadores de archivo pueden cambiar cuando cambia la identidad del almacenamiento. Pon en pausa a los clientes, realiza deliberadamente la conmutación...

Guía de solución de problemas del cliente SMB para Windows, macOS y Linux
Usa el mismo servidor, cuenta, recurso compartido y operación de archivos en cada cliente para que los problemas de descubrimiento, credenciales, políticas y almacenamiento...

Lista de verificación para rotar secretos del servidor doméstico en aplicaciones, bases de datos y copias de seguridad
Trata la rotación como una migración de dependencias: identifica cada consumidor, mantén las credenciales superpuestas cuando sea posible, verifica el nuevo valor y, después,...

