Immich kan een netwerkshare betrouwbaar gebruiken voor media of een externe bibliotheek wanneer de koppeling, rechten, latentie en het gedrag bij uitval zorgvuldig zijn ontworpen en getest, maar de PostgreSQL-datamap moet op ondersteunde opslag met lage latentie blijven staan in plaats van op een algemene SMB- of NFS-share.
Het woord data omvat verschillende workloads: originelen zijn grote, duurzame bestanden, miniaturen zorgen voor veel kleinere bewerkingen, externe bibliotheken kunnen alleen-lezen zijn en PostgreSQL vereist bestandssysteemsemantiek voor databases. Bepaal het pad per onderdeel, koppel de share voordat de containers starten, voorkom dat een lege lokale map zich voordoet als de NAS en bewijs het gedrag via zowel een herstart van de host als een gecontroleerde onderbreking van de share.
Maak afzonderlijke lijsten voor de uploadbibliotheek, miniaturen of gecodeerde media, externe bibliotheken, de databasemap, de modelcache en back-ups. Noteer wie elk pad beschrijft en wat de gevolgen van verlies zijn. Een mediashare kan geschikt zijn; ervan uitgaan dat elk volume uitwisselbaar is, doorstaat de ontwerptoets niet.
Een praktische NFS-handleiding laat zien hoe je een externe Immich-bibliotheek vanaf gedeelde opslag koppelt. Het koppelingspatroon voor een externe bibliotheek is nuttig voor het plannen van paden en rechten, maar vormt geen bewijs dat de database NFS moet gebruiken.
Houd PostgreSQL op opslag die voor databases wordt aanbevolen en bescherm het met native dumps plus back-ups. Als de actieve lokale opslag beperkt is, verplaats dan alleen het gemeten mediapad dat veel capaciteit gebruikt en documenteer de grens in plaats van de volledige applicatiestatus te verplaatsen.
maak de volgorde van externe koppelingen voorspelbaar
Koppel de share op de host met expliciete aanmeldgegevens of exportregels, een stabiel adres en de bedoelde lees-schrijfmodus. Controleer de verwachte identiteit van het bestandssysteem en een bekend markeringsbestand voordat je Immich start. Koppel het al gemounte hostpad aan de containers.
Configureer de servicemanager zo dat Immich wacht op de externe koppeling en niet start tegen een lege terugvalmap. Een opstartprocedure slaagt alleen wanneer de marker in de container zichtbaar is en een testbestand de verwachte eigenaar krijgt; een lege map of een bestand waarvan root eigenaar is, is een harde stop.
Herstart één keer terwijl de share beschikbaar is en één keer terwijl deze tijdens een gepland onderhoudsvenster opzettelijk niet beschikbaar is. De eerste test slaagt alleen wanneer de marker verschijnt voordat Immich start; de tweede alleen wanneer Immich zichtbaar stopt of faalt in plaats van naar het kale lokale koppelpunt te schrijven.
bewijs de containeridentiteit en de rechten op de share
Stem numerieke gebruikers- en groepsidentiteiten af tussen server, client en container en test daarna maken, hernoemen, lezen en verwijderen in een speciale tijdelijke map. Los een afwijking niet op met algemene schrijfrechten die de familiebibliotheek blootleggen.
Herhaal de test met het tijdelijke bestand vanuit de Immich-servercontainer, niet alleen vanaf de host. Controleer of de NAS de bedoelde numerieke eigenaar ziet en of Immich het bestand na het opnieuw maken van een container kan openen. Een geslaagde test op de host bewijst het containerpad niet.
Als de identiteit of het gedrag bij maken en hernoemen verschilt, stop dan en corrigeer de beperkte export, koppeling of containertoewijzing. Test opnieuw voordat je een echte bibliotheek scant; brede wijzigingen in rechten kunnen de afwijking verbergen en tegelijk elke familiefoto blootstellen aan niet-gerelateerde services.
meet de latentie en test een onderbreking van de share
Voer een representatieve upload, het genereren van miniaturen, het bladeren door de tijdlijn, het downloaden van een origineel en het scannen van een externe bibliotheek uit terwijl je de serverlatentie en de voortgang van taken meet. De test slaagt alleen bij een aanvaardbare interactie en zonder blijvende groei van de wachtrij; alleen de ruwe linksnelheid bewijst niets over de prestaties van metagegevens.
Een Immich-issue meldt inconsistentie tussen database en bestanden in een implementatie met instabiele NFS. Het afgebakende NFS-uitvalsscenario ondersteunt de aanpak waarbij onderbrekingen tijdens schrijfbewerkingen als herstelrisico worden behandeld, zonder ervan uit te gaan dat NFS Immich altijd beschadigt.
Onderbreek tijdens een gepland onderhoudsvenster, nadat de back-ups zijn voltooid, de mediashare terwijl een niet-kritieke test actief is. Immich moet zichtbaar falen in plaats van naar het kale koppelpunt te schrijven. Herstel de share en controleer of het testbestand en het bijbehorende databaserecord zonder een herstartlus weer met elkaar overeenkomen.
neem de go- of no-go-beslissing na de herstarttests
Herstart de containers en de host afzonderlijk. Controleer of de juiste share eerst wordt gekoppeld, of oude en nieuwe originelen openen, of externe scans geen dubbele assets maken en of één nieuwe upload een volgende herstart overleeft. De vergelijking tussen DAS en NAS van ZimaSpace schetst de afweging tussen latentie en storingsdomein.
Gebruik de share wanneer deze tests slagen en monitoring waarschuwingen kan geven bij afwezigheid, latentie, ruimtegebrek en inode-druk. Kies lokale of rechtstreeks aangesloten opslag wanneer het netwerk of de NAS niet aan de vereiste beschikbaarheid kan voldoen, of wanneer gedrag waarbij de koppeling bij een fout toch doorgaat niet kan worden voorkomen.
Rol terug naar het vorige lokale pad als Immich leeg start, bestanden maakt waarvan root eigenaar is of na een onderbreking fouten over ontbrekende bestanden produceert. Escaleer met protocol, koppelopties, identiteiten, padtoewijzingen, latentie en opstartvolgorde; scan nooit destructief opnieuw voordat de oorspronkelijke bestanden en de databasestatus als gezaghebbend zijn vastgesteld.
Ondersteuning & Tips
Meer om te lezen

Hoe optimaliseer je Immich-databaseverbindingen voor gelijktijdige containers?
Verhoog max_connections niet als eerste. Meet de Immich-sessies, tel de vraag van elke container bij elkaar op, behoud ruimte voor beheerders en stem alleen...

Dubbele taken of imports in Immich voorkomen
Scheid herhaalde taken van dubbele assets. Gebruik één canoniek ingestiepad, beheer retries en padwijzigingen en test vervolgens opnieuw invoeren op een kleine groep.

Immich herstellen nadat het databasevolume vol raakt
Verwijder nooit PostgreSQL-WAL om ruimte vrij te maken. Stop schrijfbewerkingen van Immich, behoud de databasestatus, voeg veilig extra opslagcapaciteit toe, herstel PostgreSQL en voorkom...

