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.
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

Så optimerar du Immich-databasanslutningar för samtidiga containrar
Höj inte max_connections först. Mät Immich-sessionerna, summera alla containers behov, behåll utrymme för administratörsåtkomst och justera bara den flaskhals som har bevisats.

Så förhindrar du duplicerade jobb eller importer i Immich
Separera upprepade jobb från duplicerade resurser. Använd en enda kanonisk inläsningsväg, kontrollera omförsök och sökvägsändringar och testa sedan återinmatning på en liten grupp.

Så reparerar du Immich när dess databasvolym blir full
Ta aldrig bort PostgreSQL-WAL för att frigöra utrymme. Stoppa skrivningar till Immich, bevara databastillståndet, lägg till säker lagringskapacitet, återställ PostgreSQL och förhindra sedan att...

