Immich-externe bibliotheken configureren als alleen-lezenbronnen

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.

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

De configuratie gebruikt dus 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. Dezelfde pilot bewijst ook dat het containerpad, de eigendomsrechten en het herstelplan op elkaar zijn afgestemd.

Bron- en beheerde opslag afzonderlijk koppelen

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 andere levenscyclusregels volgen.

De workflow voor externe Immich-bibliotheken vereist dat de server het pad kan zien dat aan een gebruiker wordt toegewezen. Noteer beide zijden van de mount, zodat de beheerder niet per ongeluk een alleen op de host bestaand pad in de toepassing 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 gegevens of de assetgegevens die de bibliotheek bruikbaar maken niet.

Een alleen-lezen containermount toepassen

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

Geef het containerproces traverse- en leesrechten op elke bovenliggende map. Alleen-lezen betekent niet dat er geen rechten nodig zijn: zonder uitvoerrechten op een map kunnen bestanden niet worden gevonden, ook niet 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 betrouwbare netwerkshares in Immich behandelt het verschil tussen een beschikbaar pad en een betrouwbare afhankelijkheid van de toepassing.

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 importpad in zoals dat binnen de container zichtbaar is. Begin met een map met kopieën of niet-kritieke originelen, in plaats van 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 in beheerde opslag worden opgeslagen en niet naast de originelen.

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

Single board computer zimaboard2

Nieuwe scan, ontbrekende bestanden en herstel testen

Voeg een bestand toe aan de bron op de host, voer een nieuwe scan uit en controleer of het verschijnt. Verplaats vervolgens tijdelijk een testbestand uit de bron, scan opnieuw en kijk hoe de geïnstalleerde versie van Immich de asset markeert of verwijdert voordat je dit herhaalt met echte gegevens.

Maak volgens je gebruikelijke herstelplan een back-up van de database en de beschrijfbare Immich-gegevens. De externe originelen hebben een eigen, onafhankelijke back-up nodig, omdat een alleen-lezen mount voor de toepassing 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 een ontbrekende mount wordt aangezien voor een lege bibliotheek.

Veelgestelde vragen

Voorkomt een alleen-lezen koppeling dat Immich het origineel verwijdert? Dit voorkomt schrijven via die containermount. Het beschermt niet tegen verwijdering aan de hostzijde, een andere beschrijfbare share, bestandssysteemstoringen of een beheerder die de mountmodus wijzigt.

Waar worden miniaturen voor een externe bibliotheek opgeslagen? Ze blijven in de beschrijfbare opslag die door Immich wordt beheerd. Houd die locatie gescheiden van de alleen-lezen originelen en neem deze samen met de database op in het herstelplan.

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

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.