Lista de verificación para recuperar metadatos de Btrfs en un servidor doméstico casi lleno

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

El enfoque seguro consiste en tratar la estabilización de las escrituras, la recuperación de espacio de trabajo, la ejecución de un balanceo solo con filtros y la verificación de los datos antes de reanudar el servicio normal como una secuencia de etapas comprobables, no como un único comando.

En un sistema de archivos Btrfs casi lleno de un servidor doméstico, el riesgo práctico es que Btrfs informe de ENOSPC o pase a modo de solo lectura al agotarse el espacio para metadatos. Registra la identidad actual y el punto de recuperación, empieza por la comprobación menos invasiva, interpreta los resultados satisfactorios y fallidos antes de cambiar otra variable y detente si el almacenamiento se vuelve inestable o si se pone en riesgo la única copia recuperable. El flujo de trabajo que sigue solo termina cuando la carga de trabajo original funciona correctamente o las pruebas alcanzan un límite que exige escalar el caso.

Estabiliza el sistema de archivos antes de intentar repararlo

Detén los contenedores, las descargas, las instantáneas y las tareas con muchos registros que escriban en el sistema de archivos afectado. Guarda los errores del kernel y la salida de btrfs device stats en otro lugar. Si el sistema de archivos se volvió a montar en modo de solo lectura o informa de errores de suma de comprobación, de transid del padre o de E/S, mantenlo en modo de solo lectura hasta tener una copia recuperable.

No empieces con btrfs check --repair, un balanceo 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; intentar reparar primero puede dificultar distinguirlo y consumir el espacio restante.

La comprobación de seguridad se supera cuando los servicios que realizan muchas escrituras están detenidos, hay otra copia de los datos importantes y sabes qué dispositivo de bloques y punto de montaje estás examinando. Pasa a crear una imagen de recuperación si el dispositivo se reinicia, desaparece o acumula errores de lectura.

Interpreta la asignación, no solo la cifra principal de espacio libre

Ejecuta btrfs filesystem usage -T /mount, btrfs filesystem df /mount, btrfs device usage /mount e inspecciona los mensajes recientes del kernel. Compara los metadatos asignados con los usados y el espacio sin asignar disponible en cada dispositivo; el comando df normal no basta para saber si Btrfs puede asignar otro bloque de metadatos.

Un balanceo específico requiere espacio de trabajo completamente libre. Una guía detallada para el balanceo específico de Btrfs explica que un balanceo sin filtros reescribe todos los grupos de bloques aptos y que el objetivo es mantener espacio sin asignar a nivel de dispositivo, no limitarse a borrar un archivo grande y suponer que los metadatos pueden crecer.

Si el uso de metadatos es alto, pero queda espacio sin asignar, un balanceo filtrado pequeño puede recuperar bloques vacíos o poco utilizados. Si ningún dispositivo tiene espacio de trabajo, primero elimina datos o instantáneas prescindibles de forma segura, 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 completarse.

Recupera espacio de trabajo con la acción menos invasiva

Empieza por eliminar archivos prescindibles que no estén retenidos por instantáneas y, después, elimina solo las instantáneas que hayas confirmado que no hacen falta. Sincroniza y vuelve a comprobar el uso tras cada pequeño cambio. Si se justifica un balanceo, empieza con btrfs balance start -dusage=0 -musage=0 /mount o con otro filtro específico elegido según la asignación observada, no con un balanceo completo.

La descripción del manual de Linux sobre el comportamiento del balanceo filtrado señala que los filtros limitan la reubicación y que puede producirse un error ENOSPC cuando el propio balanceo no tiene espacio de trabajo. Vigila btrfs balance status y los registros del kernel. Si la reubicación aumenta los errores, se detiene por fallos del dispositivo o consume el último margen de seguridad, cancélala y vuelve a la recuperación en modo de solo lectura.

No encadenes filtros y eliminaciones sin medir entre cada paso. La recuperación tiene éxito cuando los metadatos tienen margen disponible, hay espacio sin asignar en los dispositivos necesarios y se completa una pequeña escritura sin un nuevo error ENOSPC ni un cambio forzado al modo de solo lectura.

Verifica los datos y evita una recaída inmediata

Reinicia solo un servicio de bajo riesgo y reproduce la carga de trabajo que llenó originalmente los metadatos, como la creación de instantáneas o los cambios en muchos archivos pequeños. Vuelve a comprobar el uso y los registros del kernel después de la carga de trabajo y tras reiniciar. Un montaje que funciona una vez, pero vuelve al modo de solo lectura con la actividad normal, no se ha recuperado.

Usa el método de ZimaSpace para determinar si el espacio del NAS lo ocupan las instantáneas o los archivos activos antes de cambiar la retención. Los bloques retenidos por las instantáneas pueden hacer que la eliminación parezca ineficaz, mientras que los cambios frecuentes en muchos archivos pequeños pueden mantener alta la presión sobre los metadatos; la política correcta depende de lo que demuestren las mediciones.

Reanuda el servicio normal solo cuando el sistema de archivos siga siendo escribible, las estadísticas del dispositivo dejen de aumentar, un archivo representativo se restaure o verifique correctamente mediante su hash y la supervisión genere una alerta antes de que desaparezca el mismo margen. Escala los errores estructurales persistentes a un especialista en recuperación de Btrfs y trabaja sobre un clon, en lugar de repetir comandos de reparación en la única copia.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.