Cómo evitar que las copias de seguridad de Home Assistant capturen un estado incoherente de la base de datos

Evita copias de seguridad inconsistentes de Home Assistant dejando que la aplicación coordine el estado activo de la base de datos o deteniendo las escrituras antes de realizar una copia directa del sistema de archivos.

El caso de riesgo no es simplemente «hacer una copia de seguridad mientras Home Assistant está encendido», sino utilizar un método de copia que capture archivos relacionados de la base de datos y de la aplicación en momentos diferentes sin conocer su estado transaccional. Las copias de seguridad integradas pueden coordinar los componentes de Home Assistant, mientras que una herramienta genérica de rsync o de instantáneas quizá no pueda hacerlo. Define qué mecanismo garantiza la coherencia, evita que coincidan trabajos que hagan un uso intensivo de la base de datos, conserva la copia de seguridad anterior que sabes que funciona y demuestra cada política con una restauración aislada.

No trates una base de datos SQLite activa como un archivo estático ordinario

Recorder de Home Assistant puede estar escribiendo mientras un proceso de copia de seguridad genérico copia el directorio de configuración. Con SQLite, el estado confirmado puede abarcar la base de datos principal y los archivos de diario o WAL, por lo que capturar momentos descoordinados puede crear una copia incompleta o irrecuperable, aunque todos los nombres de archivo estén presentes en el archivo comprimido.

Una prueba de copia de seguridad de SQLite activa mostró que copiar únicamente el archivo principal de la base de datos podía omitir silenciosamente filas confirmadas que aún estaban presentes en el WAL, incluso cuando la base de datos copiada superaba una comprobación de integridad. Este fallo de copia respaldada por WAL es la razón por la que una copia directa de archivos debe utilizar una instantánea compatible con la base de datos o realizarse únicamente después de que la base de datos se haya detenido correctamente.

Esto no significa que Home Assistant deba apagarse siempre para hacer una copia de seguridad. Significa que el mecanismo de copia debe saber cómo crear un punto de recuperación coherente. Utiliza la copia de seguridad integrada de Home Assistant cuando la instalación esté en funcionamiento; reserva las copias del sistema de archivos con el servicio detenido para migraciones, archivado sin conexión o herramientas externas que no dispongan de integración con la aplicación.

Evita trabajos de copia de seguridad o mantenimiento que compitan durante la misma ventana

Incluso una copia de seguridad compatible con la aplicación puede no preparar su base de datos si otro proceso mantiene bloqueos o si la ruta de almacenamiento está sometida a una presión de mantenimiento inusual. No programes que una segunda copia de seguridad de un complemento, el mantenimiento de la base de datos, una instantánea del NAS y la copia de seguridad de Home Assistant comiencen en el mismo minuto simplemente porque la casa está tranquila.

Los fallos reales de copia de seguridad de Home Assistant informan de errores al preparar el bloqueo de la base de datos, y un usuario atribuyó un conflicto a otro complemento de copia de seguridad. Es una señal preventiva: las herramientas que se solapen deben separarse y el registro de la aplicación debe confirmar que la fase previa a la copia de seguridad se completa.

Escalona las ventanas de mantenimiento y registra la duración prevista. Si una copia de seguridad espera habitualmente a Recorder, identifica primero quién mantiene el bloqueo o cuál es el problema de estado de la base de datos. No aumentes los tiempos de espera a ciegas ni ejecutes más copias en paralelo; más trabajos de copia pueden aumentar precisamente la contención que intentas evitar.

Para las copias directas del sistema de archivos, detén Home Assistant y conserva todo el conjunto de estados

Si tu política exige copiar directamente el directorio de configuración, detén Home Assistant correctamente antes de copiarlo, verifica que el proceso ya no esté escribiendo y copia todo el estado necesario en lugar de seleccionar únicamente el archivo principal de la base de datos. Conserva las copias de seguridad de bases de datos externas mediante su propio método de coherencia.

La comparación de ZimaSpace sobre la copia de seguridad de Home Assistant en funcionamiento frente a detenido establece el mismo límite: la copia de seguridad activa compatible con la aplicación y la copia directa del sistema de archivos son procedimientos distintos y no deben mezclarse en una sola regla.

Después de la copia, reinicia el servicio y verifica que Recorder funcione con normalidad. Si el destino de la copia está en un almacenamiento de red, verifica también que el conjunto de archivos se haya completado antes de desmontar el recurso de red. Una copia con el servicio detenido que se interrumpe a mitad es coherente solo en el sentido limitado de que su origen estaba inactivo; aun así, no constituye un punto de recuperación completo.

-15% OFF

ZimaBoard 2 - Mini servidor doméstico para tu gran idea

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Confía en la copia de seguridad solo después de superar una restauración aislada

Crea una instancia temporal de Home Assistant o un destino de recuperación y restaura la copia candidata sin tomar archivos mutables de producción. Verifica los usuarios existentes, los datos históricos, los paneles, las integraciones, las definiciones de automatización y al menos un reinicio. Registra el tiempo de restauración y cualquier corrección manual necesaria para que la instancia sea utilizable.

Una regresión de Home Assistant Core limitada a la versión 2026.7.2 registró que Recorder no pudo completar su punto de control WAL durante la fase previa a la copia de seguridad, tras lo cual el gestor de copias agotó el tiempo de espera al esperar el bloqueo de la base de datos. Esta señal de fallo previa a la copia de seguridad debe tratarse únicamente como evidencia de esa ruta afectada y como un punto de recuperación fallido, no como una prueba de que todos los tiempos de espera por bloqueo tengan la misma causa.

La política se cumple cuando solo un mecanismo de copia de seguridad garantiza la coherencia en cada momento, la fase de preparación de la base de datos se completa, se conserva la copia anterior que se sabe que funciona y una restauración reproduce los usuarios, el historial, la configuración y el comportamiento normal tras reiniciar. Si la prueba de restauración falla, conserva las evidencias y crea una nueva copia compatible o una copia controlada con el servicio detenido antes de eliminar los puntos de recuperación antiguos.