Kan Immich betrouwbaar draaien met de gegevens op een netwerkshare?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Immich kan betrouwbaar een netwerkshare gebruiken voor media of een externe bibliotheek als de aankoppeling, rechten, latentie en omgang met uitval goed zijn ingericht en getest. De databasemap van PostgreSQL moet echter op ondersteunde opslag met lage latentie blijven, niet op een algemene SMB- of NFS-share.

Het woord data verbergt verschillende workloads: originelen zijn grote, duurzame bestanden, miniaturen zorgen voor veel kleinere bewerkingen, externe bibliotheken kunnen alleen-lezen zijn en PostgreSQL vereist bestandssysteemsemantiek die geschikt is voor databases. Neem per pad een beslissing, koppel de share aan voordat de containers starten, voorkom dat een lege lokale map zich voordoet als de NAS en bewijs de werking met zowel een herstart van de host als een gecontroleerde onderbreking van de share.

Classificeer elk Immich-pad voordat je het verplaatst

Breng de uploadbibliotheek, miniaturen of gecodeerde media, externe bibliotheken, databasemap, modelcache en back-ups afzonderlijk in kaart. Noteer wie naar elk pad schrijft en wat de gevolgen zijn als het verloren gaat. Een mediashare kan geschikt zijn; ervan uitgaan dat alle volumes onderling uitwisselbaar zijn, voldoet niet aan de ontwerpcriteria.

Een praktische NFS-handleiding laat zien hoe je een externe Immich-bibliotheek vanaf gedeelde opslag aankoppelt. Het aankoppelpatroon voor externe bibliotheken is nuttig voor het plannen van paden en rechten, maar bewijst niet dat de database NFS moet gebruiken.

Bewaar PostgreSQL op opslag die geschikt is voor databases en bescherm het met native dumps en back-ups. Als de lokale actieve opslag beperkt is, verplaats dan alleen het gemeten, ruimte-intensieve mediapad en documenteer de afbakening, in plaats van de volledige applicatiestatus te verplaatsen.

Zorg voor een deterministische volgorde bij externe aankoppelingen

Koppel de share op de host aan met expliciete inloggegevens of exportregels, een stabiel adres en de beoogde lees- en schrijfrechten. Controleer de verwachte bestandssysteemidentiteit en een bekend markerbestand voordat je Immich start. Koppel het reeds aangekoppelde hostpad aan de containers.

Configureer de servicemanager zo dat Immich wacht op de externe aankoppeling en niet start met een lege terugvalmap. Een opstarttest slaagt alleen als de marker zichtbaar is in de container en een testbestand de verwachte eigenaar heeft; een lege map of bestand dat eigendom is van root betekent dat de test is mislukt.

Start één keer opnieuw op terwijl de share beschikbaar is en één keer tijdens een onderhoudsvenster waarin deze bewust niet beschikbaar is. De eerste test slaagt alleen als de marker verschijnt voordat Immich start; de tweede slaagt alleen als Immich stopt of zichtbaar een fout geeft, in plaats van naar het kale lokale aankoppelpunt te schrijven.

Containeridentiteit en sharerechten controleren

Stem de numerieke gebruikers- en groepsidentiteiten af tussen server, client en container en test vervolgens het aanmaken, hernoemen, lezen en verwijderen in een speciale map met wegwerpbestanden. Los een afwijking niet op met algemene schrijfrechten waardoor de familiebibliotheek wordt blootgesteld.

Herhaal de test met een wegwerpbestand vanuit de Immich-servercontainer zelf, niet alleen vanaf de host. Controleer of de NAS de bedoelde numerieke eigenaar ziet en of Immich het bestand na het opnieuw aanmaken van de container weer kan openen. Een geslaagde test vanaf alleen de host bewijst niet dat het containerpad werkt.

Als de identiteiten of het gedrag bij aanmaken en hernoemen afwijken, stop dan en corrigeer de betreffende export-, mount- of containertoewijzing. Test opnieuw voordat je een echte bibliotheek scant; brede wijzigingen in machtigingen kunnen de afwijking verbergen en tegelijk alle familiefoto's blootstellen aan niet-gerelateerde services.

Single board computer zimaboard2

Meet de latentie en test een onderbreking van de share

Voer een representatieve upload, miniatuurgeneratie, tijdlijnweergave, download van een origineel en scan van een externe bibliotheek uit terwijl je de serverlatentie en de voortgang van taken meet. De test slaagt als de interactie acceptabel is en de wachtrij niet voortdurend groeit; alleen de ruwe verbindingssnelheid bewijst niet dat de metadataprestaties voldoende zijn.

Een Immich-issue beschrijft inconsistentie tussen database en bestanden in een implementatie met instabiele NFS. Het afgebakende NFS-storingsscenario ondersteunt de opvatting dat verbroken verbindingen tijdens schrijfbewerkingen een herstelrisico vormen; ga er niet van uit dat NFS Immich altijd beschadigt.

Onderbreek tijdens een onderhoudsvenster, nadat er back-ups zijn gemaakt, de mediashare terwijl een niet-kritieke test actief is. Immich moet duidelijk falen in plaats van naar het lege koppelpunt te schrijven. Herstel de share en controleer of de testasset en de bijbehorende databaserecord weer overeenkomen zonder een herstartlus.

Neem na de herstarttests de beslissing: Go of No-Go

Herstart de containers en de host afzonderlijk. Controleer eerst of de juiste share is gekoppeld, of oude en nieuwe originele bestanden kunnen worden geopend, of externe scans geen dubbele assets opleveren en of een nieuwe upload na nog een herstart behouden blijft. De vergelijking tussen DAS en NAS van ZimaSpace schetst de afweging tussen latentie en storingsdomein.

Gebruik de share als deze tests slagen en monitoring waarschuwingen kan geven bij onbereikbaarheid, latentie, ruimtegebrek en inode-druk. Kies voor lokale of rechtstreeks aangesloten opslag wanneer het netwerk of de NAS niet aan de vereiste beschikbaarheid kan voldoen, of wanneer fail-open-mountgedrag niet kan worden voorkomen.

Ga terug naar het eerdere lokale pad als Immich leeg start, bestanden met root als eigenaar aanmaakt of fouten over ontbrekende bestanden geeft na een onderbreking. Escaleer met protocol, mountopties, identiteiten, padtoewijzingen, latentie en opstartvolgorde; voer nooit een destructieve herscan uit voordat de originele bestanden en de databasestatus zijn vastgesteld.

Ondersteuning en tips

Meer om te lezen

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.