Varför återskapar Immich saknade filer med fel ägare?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Immich bör inte i tysthet återskapa ett saknat original som en allmän återställningsfunktion. Om ett borttaget objekt dyker upp igen bör du först ta reda på om det är en genererad miniatyrbild, en omkodad video, en profilfil, en XMP-sidofil eller någon annan skrivbar fil. Sådana filer kan återskapas eller skrivas om av olika processer och få en annan ägare.

Använd ett objekt som återskapats på nytt och kan kastas bort, samt dess överordnade katalog. Jämför numeriskt UID/GID och ACL på värden med skrivarens effektiva identitet inuti containern. Ta sedan reda på om det faktiskt var Immich, en funktion som skriver via en sidotjänst, ett NAS-protokoll eller en annan värdprocess som skapade filen. Undvik rekursiva chown eller chmod 777 tills du har identifierat skrivaren.

Jämför den återskapade filen med dess överordnade katalog och en närliggande fil som fungerar

Anteckna ägare, grupp, läge, ACL, utökade attribut om relevanta och numeriskt UID/GID för den återskapade filen, dess överordnade katalog och en äldre fil som fungerar korrekt. Namn kan vara missvisande mellan en NAS och en container; numeriska ID:n visar om ”immich” på det ena systemet motsvarar samma identitet på det andra.

ZimaSpaces arbetsflöde för behörigheter för filer som flyttats till en NAS gäller direkt: nya objekt styrs av målplatsens ACL, containeridentiteten, protokollmappningen och reglerna för hur filer skapas. En ersättningsfil kan därför vara läsbar men ändå få en ägare som stör en annan verktygsprocess. Om den återskapade filen följer den överordnade katalogens arv och bara visningsnamnet ser obekant ut, kontrollera det numeriska ID:t innan du ändrar något. Om det skiljer sig både från den överordnade katalogen och från välfungerande filer, fortsätt med att undersöka skrivarens identitet; problemet kan finnas i containerkonfigurationen snarare än i filsystemets ACL.

Identifiera processen och det effektiva UID/GID som skriver den ersättande filen

Utlös en säker återskapning medan du övervakar relevanta loggar och filsystemet. Kontrollera den effektiva användaren och gruppen inuti containern som utför skrivningen. Om en sidotjänst, ett metadataverktyg, en säkerhetskopieringsprocess eller ett värdskript i stället skapar filen, undersök den tjänsten i stället för att ändra Immichs körningsidentitet.

Filägarskap i containrar anges numeriskt, inte med namn. En förklaring av filägarskap i Docker visar varför samma fil som monteras med bind mount kan visas med olika användarnamn på värden och i containern när UID/GID-mappningarna inte stämmer överens. Använd numeriska ID:n som gemensam referens.

En diskussion om ägarskap i Immichs externa bibliotek dokumenterade att XMP-sidofiler skrevs som root i en viss driftsättning. Det är belägg från ett enskilt fall för att kontrollera vilken användare som faktiskt skriver och vilken körningsidentitet som stöds, inte ett påstående om att alla aktuella Immich-installationer skriver varje återskapad fil som root.

Om containern avsiktligt körs som en icke-root-användare ska du kontrollera att UID/GID faktiskt finns på värden eller NAS:en och har nödvändig åtkomst till den monterade sökvägen. Ett symboliskt användarnamn i en container motsvarar inte automatiskt ett värdkonto med samma namn.

Åtgärda regeln för hur filer skapas i stället för att upprepade gånger rätta befintliga filer

Åtgärda den minsta bekräftade gränsen: anpassa tjänstens UID/GID där det stöds, korrigera den överordnade katalogens grupp eller ACL-arv, ange en lämplig umask eller ändra NAS-resursens mappning som tilldelar fel identitet. Bevara Immichs och andra behöriga läsares åtkomst till originalfiler och genererade filer.

Använd inte skrivbehörighet för alla som standardlösning. Det döljer identitetskonflikten och utökar skrivåtkomsten i onödan. Ändra inte heller ägarskapet rekursivt för PostgreSQL, modellcache, uppladdningar och externa bibliotek med ett enda kommando; dessa sökvägar kan avsiktligt använda olika tjänsteidentiteter.

Om ett externt bibliotek ska vara oföränderligt kan du överväga att montera det skrivskyddat och förvara skrivbar data som ägs av appen någon annanstans, men bara om de funktioner du använder inte kräver att sidofiler skrivs dit. Beslutet handlar om önskat ägarskap och skrivbeteende, inte om att tvinga alla filer i fotoarkivet att tillhöra samma konto.

Återskapa en fil igen och validera efter en omstart

Ta endast bort ett kasserbart genererat objekt eller en test-sidofil som säkert kan återskapas och utlös sedan exakt samma Immich-åtgärd igen. Kontrollera den nya ägaren, gruppen, ACL:n och läsbarheten från både Immich och det andra programmet som tidigare misslyckades. Låt originalmedierna vara orörda under testet.

Starta om containern och starta sedan om värden en gång för att säkerställa att den korrigerade identiteten och monteringen består efter livscykelförändringar. En lyckad reparation gör att nästa testfil automatiskt får förväntat ägarskap; den är inte beroende av ett chown-skript efter uppstart som kan hamna i konflikt med Immich-skrivningar.

Stoppa och återställ från den bevarade konfigurationen om ägarskapsändringen oväntat sprider sig till databasen eller originalfilerna, eller om tjänsten förlorar läs-/skrivåtkomst efter en omstart. Eskalera med numeriska ID:n, ACL-utdata, monteringsalternativ, den effektiva containeranvändaren, ett Compose-utdrag och den exakta filtyp som Immich återskapade.

Support och tips

Mer att läsa

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.