Så förhindrar du att Home Assistant-säkerhetskopior fångar ett inkonsekvent databastillstånd

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Förhindra inkonsekventa säkerhetskopior av Home Assistant genom att låta programmet samordna databasens tillstånd medan den är aktiv, eller genom att stoppa skrivningar innan du gör en rå kopia av filsystemet.

Det riskabla är inte att ”säkerhetskopiera medan Home Assistant är igång” i sig, utan att kopieringsmetoden fångar relaterade databas- och programfiler vid olika tidpunkter utan att känna till deras transaktionstillstånd. Inbyggda säkerhetskopior kan samordna Home Assistant-komponenter, men det kan ett generiskt rsync- eller snapshotverktyg sakna stöd för. Bestäm vilken metod som ansvarar för konsekvens, undvik överlappande jobb som belastar databasen, behåll den föregående fungerande säkerhetskopian och verifiera varje policy genom en isolerad återställning.

Behandla inte en aktiv SQLite-databas som en vanlig statisk fil

Home Assistant Recorder kan skriva data samtidigt som en generisk säkerhetskopieringsprocess kopierar konfigurationskatalogen. Med SQLite kan bekräftat tillstånd finnas i huvuddatabasen och journal- eller WAL-filerna, så kopior från olika tidpunkter kan skapa en ofullständig eller omöjlig att återställa kopia, trots att alla filnamn finns i arkivet.

Ett test av säkerhetskopiering av en aktiv SQLite-databas visade att en kopiering av enbart huvuddatabasfilen i tysthet kunde utelämna bekräftade rader som fortfarande fanns i WAL-filen, trots att den kopierade databasen klarade en integritetskontroll. Detta kopieringsfel med WAL är anledningen till att en rå filkopiering bör använda en databasmedveten snapshot eller göras först när databasen har stannat upp på ett kontrollerat sätt.

Det betyder inte att Home Assistant alltid måste stängas av inför säkerhetskopiering. Det betyder att metoden för säkerhetskopiering måste kunna skapa en konsekvent återställningspunkt. Använd den inbyggda säkerhetskopieringen i Home Assistant för en installation som körs; använd kopior av filsystemet när systemet är avstängt för migrering, offlinearkivering eller externa verktyg som saknar programintegration.

Undvik konkurrerande säkerhetskopierings- eller underhållsjobb under samma tidsfönster

Även en programspecifik säkerhetskopiering kan misslyckas med att förbereda databasen om en annan process håller lås eller om lagringsplatsen utsätts för ovanligt hög belastning på grund av underhåll. Schemalägg inte säkerhetskopiering med ett andra tillägg, databasunderhåll, en NAS-snapshot och säkerhetskopiering av Home Assistant till samma minut bara för att det är lugnt hemma.

Rapporter om verkliga misslyckanden med säkerhetskopiering av Home Assistant visar fel vid förberedelse av databaslås, och en användare spårade en konflikt till ett annat säkerhetskopieringstillägg. Det är en signal om att förebygga problem: separera överlappande verktyg och kontrollera i programloggen att steget före säkerhetskopieringen slutförs.

Sprid ut underhållsfönstren och anteckna den förväntade tidsåtgången. Om en säkerhetskopiering regelbundet väntar på Recorder ska du först ta reda på vem som äger låset eller om det finns ett problem med databasens hälsa. Öka inte timeouten på måfå och kör inte fler kopieringar parallellt; fler säkerhetskopieringsjobb kan öka just den konkurrens om resurser som du försöker komma undan.

För rå kopiering av filsystemet ska du stoppa Home Assistant och bevara hela tillståndsuppsättningen

Om din policy kräver en direkt kopia av konfigurationskatalogen ska du stoppa Home Assistant på ett kontrollerat sätt innan du kopierar den, kontrollera att processen inte längre skriver och kopiera allt nödvändigt tillstånd i stället för att välja ut enbart huvuddatabasfilen. Hantera externa databassäkerhetskopior med deras egen konsistensmetod.

Den befintliga ZimaSpace-jämförelsen av säkerhetskopiering av Home Assistant medan tjänsten körs jämfört med när den är stoppad drar samma gräns: programmedveten säkerhetskopiering medan tjänsten körs och rå kopiering av filsystemet är olika metoder och bör inte blandas ihop till en enda regel.

Starta om tjänsten efter kopieringen och verifiera att Recorder fungerar normalt. Om säkerhetskopieringsmålet är nätverkslagring ska du också kontrollera att filuppsättningen kopierades färdigt innan nätverksmonteringen togs bort. En kopia som avbryts halvvägs medan tjänsten är stoppad är konsekvent endast i den snäva bemärkelsen att källan var inaktiv; den är fortfarande inte en komplett återställningspunkt.

Single board computer zimaboard2

Lita på säkerhetskopian först när en isolerad återställning har godkänts

Skapa en tillfällig Home Assistant-instans eller ett återställningsmål och återställ den aktuella säkerhetskopian utan att låna ändringsbara filer från produktionsmiljön. Verifiera befintliga användare, historiska data, instrumentpaneler, integrationer, automationsdefinitioner och minst en omstart. Anteckna återställningstiden och eventuella manuella åtgärder som krävdes för att göra instansen användbar.

En regression i Home Assistant Core 2026.7.2 gjorde att Recorder misslyckades med sin WAL-kontrollpunkt under förberedelserna inför säkerhetskopieringen, varefter säkerhetskopieringshanteraren fick timeout medan den väntade på databaslåset. Den här felsignalen före säkerhetskopieringen bör endast betraktas som belägg för den berörda sökvägen och som en misslyckad återställningspunkt - inte som bevis för att alla låstimeouter har samma orsak.

Godkänn policyn endast när en enda säkerhetskopieringsmekanism ansvarar för konsistensen åt gången, databasens förberedelsefas slutförs, den senast kända fungerande kopian behålls och en återställning återskapar användare, historik, inställningar och normalt omstartsbeteende. Om återställningstestet misslyckas ska du bevara bevisen och skapa en ny säkerhetskopia med en metod som stöds eller en kontrollerad kopia när tjänsten är stoppad innan du tar bort äldre återställningspunkter.

Support och tips

Mer att läsa

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.