Vad är Immichs tillstånd, och vilka delar måste bevaras?

Eva Wong

IceWhale author

Eva Wong är Teknisk skribent och den boende fixaren på ZimaSpace. En livslång nörd med en passion för hemma-labb och öppen källkod, hon specialiserar sig på att översätta komplexa tekniska koncept till tillgängliga, praktiska guider. Eva tror att självhosting ska vara roligt, inte skrämmande. Genom sina handledningar ger hon gemenskapen verktyg att avmystifiera hårdvaruinstallationer, från att bygga sin första NAS till att bemästra Docker-containrar.

What Is Immich State, and Which Parts Must Persist?

Immich-tillståndet är den kombinerade medie-, databas-, identitets-, konfigurations- och härledda data som krävs för att återskapa bibliotekets avsedda funktion.

Originalfilerna är nödvändiga, men de utgör inte hela applikationen. Album, användare, ägarskap, ansikten, sökrepresentationer, sökvägsmappningar och hemligheter avgör hur filerna visas och vem som kan använda dem; vissa är auktoritativa, medan andra kan återskapas till en kostnad.

Originalmedia och databasrelationer utgör kärnan

Originalfoton och originalvideor bevarar det oersättliga innehållet. Databasen bevarar hur Immich tolkar innehållet: användare, ägarskap, album, tillgångsidentifierare, metadata och bearbetningsrelationer. Ingen av sidorna är komplett på egen hand när målet är att återställa samma hushållstjänst, snarare än att bara återskapa lösa filer.

ZimaSpaces Immich-guide för säkerhetskopiering förklarar att ett heltäckande skydd omfattar uppladdade medier och databasen. Den skillnaden ger en användbar definition av tillståndet: medierna svarar på vilka byte som finns, medan databasposter svarar på hur applikationen kopplar samman, presenterar och styr dessa byte.

Mappa databasen och varje plats för originalmedia till beständiga sökvägar på värden eller lagringssystemet. Bekräfta att externa bibliotek skyddas av en egen policy. Dra inte slutsatser om beständighet utifrån ett internt sökvägsnamn i containern; inspektera den effektiva volymen eller bind mount som överlever att containern tas bort och återskapas.

Konfiguration och hemligheter återskapar tjänstens gränser

Compose-definitioner, miljöinställningar, lagringsmappningar, proxyregler och konfiguration av identitetsleverantörer avgör hur tjänster hittar data och varandra. Lösenord, signeringsmaterial och API-uppgifter måste också bevaras säkert. Att återskapa filer utan dessa inställningar kan göra databasen åtkomlig under fel identitet eller via fel sökvägar.

En analys av lagringsplanering för Immich skiljer placering av databas och miniatyrbilder från storskalig lagring av original. Lärdomen är arkitektonisk: en logisk tjänst kan sträcka sig över flera fysiska platser, så inventeringen av beständig lagring måste följa varje mount och beroende, inte bara en enda projektkatalog.

Lagra driftsättningsdefinitioner i versionshantering efter att hemligheter har tagits bort. Förvara hemligheter i en krypterad säkerhetskopia eller en secrets-hanterare med en dokumenterad återställningsväg. Dokumentera ägarskap och behörigheter för bind mounts. Under en övning ska du verifiera åtkomst från tjänsterna till databasen och läsning av medier innan du aktiverar fjärråtkomst eller börjar ta emot nya uppladdningar.

Härledd data kan återskapas men är driftsmässigt betydelsefull

Miniatyrbilder, kodade videor och vissa maskininlärningsresultat kan återskapas från auktoritativa indata, beroende på version och bevarade poster. Att utesluta dem kan minska säkerhetskopiornas storlek. Avvägningen är tid, beräkningskraft, värme och sämre respons medan en återställd server bygger om ett stort familjebibliotek.

En oberoende säkerhetskopieringsguide skiljer nödvändiga uppladdningar, biblioteks- och profildata från miniatyrbilder och kodad video som Immich kan återskapa. Det gör inte härledda data oviktiga; det ger administratörer möjlighet att välja mellan säkerhetskopians storlek och tiden som krävs för att återfå fullt förberedd bläddring och uppspelning.

Mät en representativ återuppbyggnadshastighet innan du utesluter härledd data. Multiplicera försiktigt utifrån den berörda tillgångsmixen och inkludera både lagringsskrivningar och konkurrens med förgrundsprocesser. Om den resulterande fördröjningen överskrider återställningsmålet bör du skydda utvalda sökvägar för härledd data eller hålla extra beräkningskapacitet tillgänglig under återuppbyggnaden.

-15% OFF

ZimaBoard 2 - Minihemmserver för din stora idé

Single board computer zimaboard2

Bevisa beständigheten med en övning där containrar förstörs

Använd en tillfällig klon av driftsättningen, aldrig produktionen. Registrera kontrollsummor för ett urval original, ett testalbum, två konton med olika åtkomstnivåer och en känd sökning. Ta endast bort de klonade containrarna medan deklarerad beständig lagring behålls, och återskapa sedan stacken från sparad konfiguration och sparade hemligheter.

En rapport om beständighet från communityn beskriver hur Immich återgick till introduktionsflödet efter omstarter eftersom den avsedda databaskatalogen på värden förblev tom. Det är ett varnande exempel på varför en konfigurerad sökväg inte bevisar att skrivningar faktiskt når den; det observerbara tillståndet måste överleva den faktiska livscykelåtgärd som påstås stödjas.

Godkänn övningen först när båda kontona har återställts, albumtillhörigheten stämmer, originalens kontrollsummor överensstämmer och den kända sökningen fungerar som förväntat eller går in i ett dokumenterat återuppbyggnadstillstånd. Varje oförklarad återställning identifierar bristande beständighet. Uppdatera tillståndskartan innan du förlitar dig på automatisering av säkerhetskopieringen som bygger på samma antaganden.