Immich-externe bibliotheken configureren als alleen-lezen bronnen

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Een externe bibliotheek van Immich indexeert foto's die al buiten de beheerde uploadmap staan. Door die bron alleen-lezen te koppelen, bescherm je originelen tegen fouten van de applicatie of beheerder, maar Immich heeft nog steeds schrijfbare opslag nodig voor miniaturen, gecodeerde video, profielgegevens en de databasestatus.

De installatie gebruikt daarom twee vertrouwenszones: onveranderlijke bronmappen en schrijfbare gegenereerde gegevens. Een kleine pilotbibliotheek moet tests voor detectie, metadata, miniaturen, opnieuw scannen en verwijderen doorstaan voordat een groot archief wordt toegevoegd. Met dezelfde pilot controleer je ook of het containerpad, eigenaarschap en herstelplan op elkaar aansluiten.

Bron en beheerde opslag afzonderlijk toewijzen

Kies een hostpad voor het bestaande archief en een afzonderlijk containerpad, zoals /external/family-photos. Plaats het niet onder de Immich-uploadopslag, omdat externe en beheerde assets verschillende levenscyclusregels volgen.

De workflow voor externe bibliotheken van Immich vereist dat de server het pad ziet dat aan een gebruiker wordt toegewezen. Noteer beide kanten van de koppeling, zodat de beheerder geen host-only pad in de applicatie plakt.

Controleer of de schrijfbare locaties van Immich voor uploads, miniaturen, gecodeerde video en databasegegevens normaal worden geback-upt en op vrije ruimte worden gecontroleerd. Alleen-lezen originelen beschermen de gegenereerde status of de assetrecords die de bibliotheek bruikbaar maken niet.

Een alleen-lezen containermount toepassen

Voeg het archief als een bind mount met de alleen-lezenvlag toe in Compose of de containerbeheerder. Een gebruikelijk patroon koppelt /srv/photos/archive op de host aan /external/archive in de container met :ro.

Geef het containerproces doorloop- en leesrechten op elke bovenliggende map. Alleen-lezen betekent niet dat er geen rechten nodig zijn: ontbrekende uitvoerrechten op een map verhinderen detectie, zelfs als afzonderlijke bestanden leesbaar zijn.

Als de bron een netwerkshare is, zorg dan dat de hostmount stabiel is voordat de container start. De handleiding voor de betrouwbaarheid van Immich-netwerkshares behandelt het verschil tussen een beschikbaar pad en een betrouwbare afhankelijkheid voor de applicatie.

Een externe pilotbibliotheek toevoegen en scannen

Maak de Immich-gebruiker die eigenaar wordt aan of selecteer deze, voeg een externe bibliotheek toe en voer het in de container zichtbare importpad in. Begin met een map met kopieën of niet-kritieke originelen in plaats van meteen naar het volledige archief te verwijzen.

Voer een scan uit en controleer of de verwachte aantallen foto's en video's verschijnen. Open assets uit geneste mappen, controleer datums en locaties en bevestig dat miniaturen en gecodeerde voorbeelden naar beheerde opslag worden geschreven in plaats van naast de originelen.

Vergelijk op de host de wijzigingstijden of hashes van de pilotbron vóór en na de scan. Probeer ook vanuit de container een bestand in het gekoppelde pad te maken; die bewerking moet mislukken terwijl lezen wel lukt.

-15% OFF
Single board computer zimaboard2

Opnieuw scannen, ontbrekende bestanden en herstel testen

Voeg één bestand toe aan de hostbron, voer opnieuw een scan uit en controleer of het verschijnt. Verplaats vervolgens tijdelijk een pilotbestand uit de bron, scan opnieuw en observeer hoe de geïnstalleerde Immich-versie het assetrecord markeert of verwijdert voordat je dit met echte gegevens herhaalt.

Maak volgens je normale herstelplan een back-up van de database en schrijfbare Immich-gegevens. De externe originelen hebben hun eigen onafhankelijke back-up nodig, omdat een alleen-lezen applicatiemount niet beschermt tegen schijfstoringen, verwijdering aan de hostzijde of beschadiging.

De test is geslaagd als Immich het archief kan indexeren en weergeven, er niet naar kan schrijven en opnieuw kan worden opgebouwd zonder de externe bron als beheerde uploads te behandelen. Stop als gegenereerde bestanden naast originelen verschijnen of als een ontbrekende mount ten onrechte als een lege bibliotheek wordt gezien.

Veelgestelde vragen

Voorkomt een alleen-lezen mount dat Immich het origineel verwijdert? Deze voorkomt dat er via die containermount wordt geschreven. Hij beschermt niet tegen verwijdering aan de hostzijde, een andere schrijfbare share, een bestandssysteemfout of een beheerder die de mountmodus wijzigt.

Waar komen miniaturen voor een externe bibliotheek terecht? Ze blijven in de door Immich beheerde schrijfbare opslag. Houd die locatie gescheiden van de alleen-lezen originelen en neem haar samen met de database op in het herstelplan.

Kunnen meerdere gebruikers dezelfde externe map indexeren? Vermijd overlappend eigenaarschap totdat je het gedrag van de exacte release hebt getest. Dubbele indexering kan leiden tot verwarrende resultaten voor eigenaarschap en delen.

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