Så förhindrar du att Immich-säkerhetskopior fångar ett inkonsekvent tillstå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 Immich-säkerhetskopior genom att behandla databasen och medierna som en enda återställningsenhet och styra ordningen för kopieringen och skrivaktiviteten medvetet.

En säkerhetskopia kan innehålla alla filer som den skulle kopiera och ändå återställas felaktigt om databasen hänvisar till objekt som inte kom med, eller om mediakopian är från en annan tidpunkt än katalogen. Definiera först konsekvensgränsen, välj en metod med tjänsten stoppad eller en samordnad metod medan den körs, och validera resultatet i en isolerad miljö.

Definiera återställningsenheten innan du schemalägger säkerhetskopieringen

Lista PostgreSQL-databasen, uppladdade medier, profildata, driftsättningskonfiguration, miljövärden, hemligheter och eventuella anpassade lagringssökvägar som behövs för att återskapa tjänsten. Markera genererade miniatyrbilder, kodade videor och modelfiler separat, beroende på om återställningspolicyn kräver att de säkerhetskopieras eller tillåter att de återskapas.

ZimaSpaces jämförelse av säkerhetskopiering av Immich medan tjänsten körs och när den är stoppad förklarar det grundläggande valet av konsekvensnivå. Den här förebyggande arbetsgången tar det ett steg längre: oavsett vilken metod du väljer måste den ge en dokumenterad tidpunkt som går att återställa utan att du behöver gissa vilken databas som hör ihop med vilken mediekopia.

Dokumentera återställningsordningen tillsammans med säkerhetskopieringens omfattning. Om planen säger ”återställ foton” men inte anger vilken databassäkerhetskopia, konfiguration, vilka autentiseringsuppgifter och lagringsmappningar som kopplar fotona till användare och album, är definitionen av säkerhetskopieringen ofullständig redan innan den första schemalagda körningen börjar.

Använd en avstängd kopiering när den enklaste avgränsningen är acceptabel

För ett mindre hushåll som klarar ett kort underhållsavbrott kan du pausa uppladdningar och stoppa de programtjänster som skriver till bibliotekets tillstånd. Säkerhetskopiera databasen och ta en kopia av medierna och konfigurationen. Starta sedan om tjänsterna först när ögonblicksbilden eller kopieringen har en tydlig tidsstämpel och ett bekräftat slutföranderesultat.

Att stoppa programmet gör inte automatiskt en olämplig metod korrekt. Kontrollera att databasen exporterades utan fel, att de avsedda mediesökvägarna kom med och att säkerhetskopieringen sparas på en plats som är fristående från de aktiva data som den ska kunna återställa. Anteckna start- och sluttider så att senare återställningar kan identifiera exakt vilken säkerhetskopiering det gäller.

Metoden fungerar när inga skrivningar från programmet sker under kopieringen och en teståterställning ger förväntade användare, antal objekt, album och ett urval av originalfiler. Om avbrottet regelbundet överskrider vad hushållet tolererar bör du gå över till en samordnad metod medan tjänsten körs, i stället för att låta uppladdningar återupptas mitt under en filkopiering utan att säga något.

För säkerhetskopiering medan tjänsten körs: fånga databasen och filerna i en fastställd ordning

När Immich måste förbli tillgängligt ska du skapa en konsekvent dump med databasens egna verktyg i stället för att kopiera den aktiva PostgreSQL-datakatalogen som vanliga filer. Ta sedan en kopia av eller ögonblicksbild av medieträdet i den dokumenterade ordningen, samtidigt som du håller reda på uppladdningar som görs under säkerhetskopieringen.

Den praktiska arbetsgången för säkerhetskopiering av Immich-databasen visar den databasmedvetna metoden. Kommandon och containernamn kan variera mellan olika driftsättningar, så den överförbara principen är att be PostgreSQL om en konsekvent säkerhetskopia i stället för att förlita sig på en live, rekursiv kopiering av databasfiler.

Föredra en ordningsföljd som inte kan leda till att den återställda databasen pekar på media som aldrig kom med i säkerhetskopian. Om filsystemskopian innehåller extra filer som databasen ännu inte känner till kan de stämmas av säkrare än databasposter vars hänvisade original saknas. Dokumentera alla uppladdningar som passerar gränsen.

Samordna filsystemets ögonblicksbilder med databaskrokar i stället för att förutsätta atomicitet

Filsystemets ögonblicksbilder är värdefulla eftersom de snabbt fångar en volym, men de gör inte två system som ändras oberoende av varandra transaktionellt konsekventa på egen hand. Om databasen och media finns på olika datamängder eller enheter ska du definiera krokar före och efter ögonblicksbilden och göra tidpunkterna synliga i säkerhetskopieringsloggen.

Ett exempel från 2026 som kombinerar säkerhetskopieringsprogramvara med Btrfs-krokar för ögonblicksbilder visar varför orkestrering av ögonblicksbilder kräver uttryckliga gränser för applikationen eller databasen. Använd idén för att samordna insamlingar; kopiera inte filsystemkommandona rakt av till en annan layout.

Om ögonblicksbildsverktyget inte kan samordna tidsgränsen mellan databasen och media, använd i stället en logisk databasdump plus en säkerhetskopia av media, i stället för att hävda att återställningen är atomisk. Komplexitet är motiverad endast om återställningstestet visar att den snabbare insamlingen ändå återställer ett sammanhängande applikationstillstånd.

Gör återställningstester till en del av säkerhetskopieringsschemat

Ett lyckat säkerhetskopieringsjobb visar bara att insamlingen slutfördes. Välj regelbundet en aktuell generation, återställ den under ett isolerat värdnamn, anslut den förväntade lagringen och verifiera användare, representativa original, album, behörigheter, sökbeteende och en ny databassäkerhetskopia från den återställda instansen.

PostgreSQL:s översikt över återställning, från planeringen av säkerhetskopiering och återställning, betonar validering av återställningen och återställningsmål snarare än att betrakta skapandet av en dump som slutmålet. Tillämpa samma noggrannhet på den kombinerade återställningsenheten för Immich.

Underkänn säkerhetskopieringspolicyn om databasen kan återställas men filer saknas, om media går att öppna utan användare eller relationer, eller om återställningen är beroende av en hemlighet som bara finns på den havererade värden. Åtgärda omfattning, ordningsföljd, lagringstid eller oberoende innan säkerhetskopieringsfrekvensen ökas; fler inkonsekventa kopior ger ingen tillförlitlig återställningspunkt.

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.