Kan Immich köras tillförlitligt med sina data på en nätverksresurs?

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.

Immich kan tillförlitligt använda en nätverksresurs för media eller ett externt bibliotek när montering, behörigheter, fördröjning och beteende vid avbrott är korrekt utformade och testade, men PostgreSQL:s datakatalog bör ligga på kompatibel lagring med låg fördröjning i stället för en generell SMB- eller NFS-resurs.

Ordet data döljer olika arbetsbelastningar: original är stora, beständiga filer, miniatyrbilder skapar många mindre operationer, externa bibliotek kan vara skrivskyddade och PostgreSQL kräver filsystemsemantik för databaser. Bestäm sökväg för sökväg, montera resursen innan containrarna startar, förhindra att en tom lokal katalog utger sig för att vara NAS-enheten och bevisa funktionen genom både en omstart av värddatorn och ett kontrollerat avbrott i resursen.

Klassificera varje Immich-sökväg innan du flyttar den

Lista uppladdningsbiblioteket, miniatyrbilder eller kodad media, externa bibliotek, databaskatalogen, modellcachen och säkerhetskopior separat. Markera vem som skriver till varje sökväg och vilken konsekvens en förlust får. En mediaresurs kan vara lämplig; att behandla alla volymer som utbytbara klarar inte designgranskningen.

En praktisk NFS-genomgång visar hur ett externt Immich-bibliotek mappas från delad lagring. Dess monteringsmönster för externa bibliotek är användbart för planering av sökvägar och behörigheter, men är inget bevis på att databasen bör använda NFS.

Behåll PostgreSQL på lagring som rekommenderas för databaser och skydda den med inbyggda dumpningar samt säkerhetskopior. Om den lokala aktiva lagringen är begränsad, flytta endast den uppmätta, kapacitetskrävande mediesökvägen och dokumentera gränsen i stället för att flytta hela applikationstillståndet.

Gör ordningen för fjärrmontering deterministisk

Montera resursen på värddatorn med uttryckliga autentiseringsuppgifter eller exportregler, en stabil adress och avsedd läs- och skrivbehörighet. Kontrollera den förväntade filsystemidentiteten och en känd markörfil innan Immich startas. Bind den redan monterade värdsökvägen till containrarna.

Konfigurera tjänstehanteraren så att Immich väntar på fjärrmonteringen och inte startar mot en tom reservkatalog. En uppstart godkänns endast när markören syns inuti containern och en testfil får den förväntade ägaren; en tom katalog eller en rotägd fil är ett definitivt stopp.

Starta om en gång med resursen tillgänglig och en gång med den avsiktligt otillgänglig under ett planerat underhållsfönster. Det första testet godkänns endast när markören visas innan Immich startar; det andra endast när Immich stoppas eller misslyckas tydligt i stället för att skriva till den nakna lokala monteringspunkten.

Bevisa containeridentitet och resursbehörigheter

Matcha numeriska användar- och gruppidentiteter på server, klient och container och testa sedan att skapa, byta namn på, läsa och radera filer i en särskild temporär mapp. Lös inte en avvikelse med globala skrivbehörigheter som exponerar familjebiblioteket.

Upprepa testet med den temporära filen inifrån Immich-servercontainern, inte bara från värddatorn. Bekräfta att NAS-enheten ser den avsedda numeriska ägaren och att Immich kan öppna filen igen efter att en container återskapats. Ett godkänt test på värddatorn bevisar inte containersökvägen.

Om identitet eller beteendet vid skapande och namnbyte skiljer sig åt ska du stoppa och korrigera den specifika exporten, monteringen eller containermappningen. Testa igen innan du skannar ett verkligt bibliotek; breda behörighetsändringar kan dölja avvikelsen samtidigt som de exponerar alla familjefoton för orelaterade tjänster.

-15% OFF
Single board computer zimaboard2

Mät fördröjningen och testa ett avbrott i resursen

Genomför en representativ uppladdning, generering av miniatyrbilder, visning av tidslinjen, nedladdning av original och skanning av ett externt bibliotek medan du mäter serverns fördröjning och jobbens framsteg. Godkänt resultat kräver acceptabel interaktion och ingen varaktig köökning; enbart rå länkhastighet kan inte bevisa metadatahanteringen.

Ett Immich-ärende rapporterar inkonsekvens mellan databas och filer i en installation med instabil NFS. Det avgränsade NFS-fallet talar för att betrakta frånkopplingar under skrivningar som en återställningsrisk, inte för att anta att NFS alltid skadar Immich.

Under ett underhållsfönster med slutförda säkerhetskopior avbryter du mediaresursen medan ett icke-kritiskt test pågår. Immich bör misslyckas tydligt i stället för att skriva till den nakna monteringspunkten. Återställ resursen och bekräfta att testtillgången samt databasposten synkroniseras utan en omstartsloop.

Fatta beslutet om att fortsätta eller avstå efter omstartstesterna

Starta om containrarna och värddatorn separat. Bekräfta att rätt resurs monteras först, att gamla och nya original öppnas, att externa skanningar inte duplicerar tillgångar och att en ny uppladdning överlever ytterligare en omstart. ZimaSpace:s jämförelse mellan DAS och NAS belyser avvägningen mellan fördröjning och feldomän.

Använd resursen när dessa tester godkänns och övervakningen kan varna vid frånvaro, hög fördröjning, låg ledig kapacitet och inode-belastning. Välj lokal eller direktansluten lagring när nätverket eller NAS-enheten inte kan uppfylla den nödvändiga tillgängligheten eller när beteende som öppnar monteringen utan kontroll inte kan förhindras.

Återgå till den tidigare lokala sökvägen om Immich startar tomt, skapar rotägda filer eller genererar fel om saknade filer efter ett avbrott. Eskalera med protokoll, monteringsalternativ, identiteter, sökvägsmappningar, fördröjning och uppstartsordning; skanna aldrig om destruktivt innan de auktoritativa originalen och databastillståndet är kända.

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.