Waarom maakt Immich ontbrekende bestanden opnieuw aan met de verkeerde eigenaar?

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 hoort een ontbrekend origineel niet stilzwijgend opnieuw aan te maken als algemene herstelfunctie. Als een verwijderd object terugkeert, stel dan eerst vast of het een gegenereerde miniatuur, gecodeerde video, profielbestand, XMP-sidecar of een ander schrijfbaar bestand is; verschillende processen kunnen die opnieuw aanmaken of herschrijven, waarna ze een andere eigenaar krijgen.

Gebruik één wegwerpbaar opnieuw gegenereerd object en de bovenliggende map ervan. Vergelijk de numerieke UID/GID en ACL's op de host met de effectieve schrijver binnen de container en stel vervolgens vast of Immich, een functie die een sidecar-bestand schrijft, een NAS-protocol of een ander hostproces het bestand daadwerkelijk heeft aangemaakt. Voer geen recursieve chown of chmod 777 uit voordat je weet welk proces het bestand schrijft.

Vergelijk het opnieuw aangemaakte bestand met de bovenliggende map en een bekend goed werkend bestand in de buurt

Noteer de eigenaar, groep, modus, ACL, eventuele relevante uitgebreide kenmerken en numerieke UID/GID van het opnieuw aangemaakte bestand, de bovenliggende map en een ouder bestand dat goed werkt. Namen kunnen misleidend zijn op een NAS en in een container; numerieke ID's laten zien of 'immich' op het ene systeem overeenkomt met dezelfde identiteit op het andere.

De ZimaSpace-machtigingsworkflow voor bestanden die naar een NAS zijn verplaatst is hier direct van toepassing: nieuwe objecten vallen onder de ACL van de bestemming, de containeridentiteit, de protocoltoewijzing en de aanmaakregels. Een vervangend bestand kan dus leesbaar zijn en toch een eigenaar krijgen die de workflow van een ander programma verstoort. Als het opnieuw aangemaakte bestand overeenkomt met de overerving van de bovenliggende map en alleen de weergegeven naam onbekend lijkt, controleer dan de numerieke ID voordat je iets wijzigt. Als het afwijkt van zowel de bovenliggende map als bestanden die goed werken, onderzoek dan de identiteit van het proces dat het bestand schrijft; het probleem kan in de containerconfiguratie zitten en niet in de bestandssysteem-ACL.

Bepaal welk proces schrijft en wat de effectieve UID/GID is

Start één veilige regeneratie terwijl je de relevante logs en het bestandssysteem in de gaten houdt. Controleer de effectieve gebruiker en groepen binnen de container die het bestand schrijft. Als een sidecar, metadataprogramma, back-upproces of hostscripts het bestand in plaats daarvan aanmaakt, controleer dan die service in plaats van de runtime-identiteit van Immich te wijzigen.

Eigendom van bestanden in containers is numeriek en niet gebaseerd op namen. In een uitleg over Docker-bestandseigendom lees je waarom hetzelfde gekoppelde bestand op de host en in de container een andere gebruikersnaam kan tonen wanneer de UID/GID-toewijzingen niet overeenkomen. Gebruik numerieke ID's als gemeenschappelijke referentie.

In een discussie over het eigenaarschap van externe bibliotheken in Immich werd beschreven dat XMP-sidecars in één implementatie als root werden weggeschreven. Dit is een aanwijzing om de effectieve schrijver en de ondersteunde runtime-identiteit te controleren, niet een bewering dat elke huidige Immich-installatie elk opnieuw gegenereerd bestand als root wegschrijft.

Als de container bewust als een niet-rootgebruiker draait, controleer dan of de UID/GID daadwerkelijk bestaat op de host of NAS en de vereiste toegang heeft tot het gekoppelde pad. Een symbolische gebruikersnaam in een container komt niet automatisch overeen met een hostaccount met dezelfde naam.

Herstel de aanmaakregel in plaats van bestaande bestanden steeds opnieuw te repareren

Herstel de kleinst mogelijke bevestigde oorzaak: stem de service-UID/GID op elkaar af waar dat wordt ondersteund, herstel de groepsrechten of ACL-overerving van de bovenliggende map, stel een passende umask in of wijzig de NAS-sharetoewijzing die de verkeerde identiteit levert. Zorg ervoor dat Immich en andere bevoegde lezers toegang houden tot originelen en gegenereerde bestanden.

Gebruik geen schrijfrechten voor iedereen als standaardreparatie. Daarmee verdoezel je de afwijkende identiteit en breid je de schrijftoegang onnodig uit. Wijzig evenmin recursief het eigenaarschap van PostgreSQL, de modelcache, uploads en externe bibliotheken met één opdracht; voor die paden kunnen bewust verschillende service-identiteiten worden gebruikt.

Als een externe bibliotheek onveranderlijk moet zijn, overweeg dan de mount alleen-lezen te maken en schrijfbare statusgegevens die eigendom zijn van de app ergens anders op te slaan, maar alleen als de functies die je gebruikt daar geen sidecars hoeven te schrijven. Het gaat om het gewenste eigenaarschap en schrijfgedrag, niet om elk bestand in het fotoarchief aan hetzelfde account toe te wijzen.

Maak één bestand opnieuw aan en controleer het na een herstart

Verwijder alleen een wegwerpbaar gegenereerd object of test-sidecar die veilig opnieuw kan worden aangemaakt en voer daarna exact dezelfde Immich-bewerking opnieuw uit. Controleer de nieuwe eigenaar, groep, ACL en leesbaarheid vanuit zowel Immich als het andere programma dat eerder problemen had. Laat de originele media tijdens deze test ongemoeid.

Herstart de container en start daarna de host één keer opnieuw op om te controleren of de gecorrigeerde identiteit en mounts ook na wijzigingen in de levenscyclus behouden blijven. Een geslaagde reparatie maakt automatisch het volgende testbestand met het verwachte eigenaarschap aan; deze is niet afhankelijk van een chown-script na het opstarten dat schrijfbewerkingen van Immich doorkruist.

Stop en herstel vanuit de bewaarde configuratie als wijzigingen in eigenaarschap zich onverwacht uitbreiden naar de database of originelen, of als de service na een herstart geen lees- en schrijftoegang meer heeft. Escaleer met numerieke ID's, ACL-uitvoer, mountopties, de effectieve containergebruiker, het Compose-fragment en het exacte bestandstype dat Immich opnieuw heeft aangemaakt.

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.