Warum erstellt Immich fehlende Dateien mit dem falschen Besitzer neu?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Immich sollte ein fehlendes Original nicht stillschweigend als allgemeine Wiederherstellungsfunktion neu erstellen. Wenn ein gelöschtes Objekt wieder auftaucht, ermittle zunächst, ob es sich um ein generiertes Vorschaubild, ein kodiertes Video, ein Profilartefakt, eine XMP-Sidecar-Datei oder eine andere beschreibbare Datei handelt. Solche Dateien können von unterschiedlichen Prozessen neu erstellt oder überschrieben werden und einen anderen Eigentümer erben.

Verwende ein einzelnes, entbehrliches neu erstelltes Objekt und sein übergeordnetes Verzeichnis. Vergleiche die numerische UID/GID und die ACLs auf dem Host mit dem effektiven Benutzer, der im Container schreibt, und ermittle dann, ob Immich, eine Sidecar-Schreibfunktion, ein NAS-Protokoll oder ein anderer Host-Prozess die Datei tatsächlich erstellt hat. Vermeide rekursives chown oder chmod 777, bis der schreibende Prozess bekannt ist.

Die neu erstellte Datei mit ihrem übergeordneten Ordner und einer bekannten, korrekt funktionierenden Nachbardatei vergleichen

Notiere Eigentümer, Gruppe, Modus, ACL, gegebenenfalls erweiterte Attribute und die numerische UID/GID der neu erstellten Datei, ihres übergeordneten Verzeichnisses und einer älteren, korrekt funktionierenden Datei. Namen können zwischen einem NAS und einem Container irreführend sein; anhand der numerischen IDs lässt sich erkennen, ob „immich“ auf einem System derselben Identität auf dem anderen entspricht.

Der ZimaSpace-Berechtigungsablauf für auf ein NAS verschobene Dateien ist direkt anwendbar: Neue Objekte unterliegen der ACL des Ziels, der Containeridentität, der Protokollzuordnung und den Erstellungsregeln. Eine Ersatzdatei kann daher lesbar sein und trotzdem einen Eigentümer erhalten, der den Arbeitsablauf eines anderen Tools beeinträchtigt. Wenn die neu erstellte Datei der Vererbung des übergeordneten Ordners entspricht und nur der angezeigte Name ungewohnt aussieht, ermittle die numerische ID, bevor du etwas änderst. Wenn sie sowohl vom übergeordneten Ordner als auch von bekannten, korrekt funktionierenden Dateien abweicht, prüfe als Nächstes die Identität des schreibenden Prozesses; das Problem liegt möglicherweise in der Containerkonfiguration und nicht in der Dateisystem-ACL.

Den Prozess und die effektive UID/GID ermitteln, der bzw. die die Ersatzdatei schreibt

Löse einmal sicher eine Neuerstellung aus und beobachte dabei die relevanten Protokolle und das Dateisystem. Prüfe den effektiven Benutzer und die Gruppen im Container, der den Schreibvorgang ausführt. Wenn stattdessen ein Sidecar, ein Metadaten-Tool, ein Sicherungsprozess oder ein Host-Skript die Datei erstellt, prüfe diesen Dienst, anstatt die Laufzeitidentität von Immich zu ändern.

Die Eigentümerschaft von Dateien im Container wird über numerische IDs statt über Namen bestimmt. Eine Erklärung zur Dateieigentümerschaft in Docker zeigt, warum dieselbe eingebundene Datei auf dem Host und im Container mit unterschiedlichen Benutzernamen angezeigt werden kann, wenn die UID-/GID-Zuordnungen nicht übereinstimmen. Verwende numerische IDs als gemeinsame Referenz.

In einer Diskussion über die Eigentümerschaft externer Bibliotheken in Immich wurde dokumentiert, dass in einer Bereitstellung XMP-Sidecar-Dateien als root geschrieben wurden. Dieser Fall belegt, dass die effektive schreibende Identität und die unterstützte Laufzeitidentität überprüft werden sollten. Er bedeutet nicht, dass jede aktuelle Immich-Installation jede neu erstellte Datei als root schreibt.

Wenn der Container absichtlich als Nicht-Root-Benutzer ausgeführt wird, prüfen Sie, ob die UID/GID tatsächlich auf dem Host oder NAS existiert und über die erforderlichen Zugriffsrechte auf den eingebundenen Pfad verfügt. Ein symbolischer Benutzername im Container entspricht nicht automatisch einem Hostkonto mit demselben Namen.

Reparieren Sie die Erstellungsregel, statt vorhandene Dateien immer wieder zu korrigieren

Beheben Sie das Problem an der kleinsten bestätigten Stelle: Stimmen Sie nach Möglichkeit die Dienst-UID/GID ab, korrigieren Sie die Gruppen- oder ACL-Vererbung des übergeordneten Verzeichnisses, legen Sie eine geeignete umask fest oder ändern Sie die NAS-Freigabezuordnung, die die falsche Identität liefert. Stellen Sie sicher, dass Immich und alle anderen berechtigten Leser auf Originale und generierte Dateien zugreifen können.

Verwenden Sie keine für alle Benutzer beschreibbaren Berechtigungen als Standardlösung. Damit wird die abweichende Identität verschleiert und der Schreibzugriff unnötig ausgeweitet. Ändern Sie ebenso wenig rekursiv die Eigentümerschaft von PostgreSQL, Modell-Cache, Uploads und externen Bibliotheken mit einem einzigen Befehl; für diese Pfade können absichtlich unterschiedliche Dienstidentitäten vorgesehen sein.

Wenn eine externe Bibliothek unveränderlich sein soll, sollten Sie die Einbindung schreibgeschützt einrichten und beschreibbare, der App gehörende Daten an anderer Stelle speichern. Tun Sie dies jedoch nur, wenn die von Ihnen verwendeten Funktionen keine Sidecar-Dateien dort schreiben müssen. Entscheidend sind die gewünschte Eigentümerschaft und das Schreibverhalten, nicht, jede Datei im Fotoarchiv demselben Konto zuzuweisen.

Eine Datei erneut erstellen und nach einem Neustart überprüfen

Entfernen Sie nur ein entbehrliches, generiertes Objekt oder eine Test-Sidecar-Datei, die sich gefahrlos neu erstellen lässt, und lösen Sie dann denselben Immich-Vorgang erneut aus. Überprüfen Sie den neuen Eigentümer, die Gruppe, die ACL und die Lesbarkeit sowohl in Immich als auch im anderen Programm, bei dem zuvor ein Fehler auftrat. Lassen Sie die Originalmedien während dieses Tests unangetastet.

Starten Sie den Container neu und anschließend den Host einmal, um sicherzustellen, dass die korrigierte Identität und die Einbindungen auch nach Neustarts erhalten bleiben. Bei einer erfolgreichen Reparatur wird die nächste Testdatei automatisch mit der erwarteten Eigentümerschaft erstellt; sie hängt nicht von einem chown-Skript nach dem Start ab, das mit Schreibvorgängen von Immich in Konflikt gerät.

Stoppen Sie und stellen Sie die gesicherte Konfiguration wieder her, wenn sich unerwartet Änderungen der Eigentümerschaft auf die Datenbank oder Originale ausweiten oder der Dienst nach einem Neustart den Lese-/Schreibzugriff verliert. Eskalieren Sie den Fall mit numerischen IDs, ACL-Ausgabe, Einhängeoptionen, effektivem Containerbenutzer, Compose-Ausschnitt und dem genauen Dateityp, den Immich neu erstellt hat.

Support und Tipps

Mehr zum Lesen

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.