Kann Immich zuverlässig mit seinen Daten auf einer Netzwerkfreigabe betrieben werden?

Eva Wong

IceWhale author

Eva Wong ist die Technische Redakteurin und und leidenschaftliche Tüftlerin bei ZimaSpace. Eine lebenslange Geek mit einer Leidenschaft für Homelabs und Open-Source-Software, sie spezialisiert sich darauf, komplexe technische Konzepte in zugängliche, praktische Anleitungenzu übersetzen. Eva ist der Meinung, dass Self-Hosting Spaß machen und nicht einschüchternd sein sollte. Durch ihre Tutorials befähigt sie die Community, Hardware-Setups zu entmystifizieren, vom Bau ihres ersten NAS bis hin zur Beherrschung von Docker-Containern.

Can Immich Run Reliably With Its Data on a Network Share? - Zima Store Online

Immich kann eine Netzwerkfreigabe zuverlässig für Medien oder eine externe Bibliothek verwenden, wenn Einbindung, Berechtigungen, Latenz und Verhalten bei Ausfällen sorgfältig eingerichtet und getestet wurden. Das PostgreSQL-Datenverzeichnis sollte jedoch auf unterstütztem Speicher mit niedriger Latenz verbleiben und nicht auf einer allgemeinen SMB- oder NFS-Freigabe liegen.

Das Wort „Daten“ umfasst unterschiedliche Workloads: Originale sind große, langlebige Dateien, Vorschaubilder erzeugen viele kleinere Vorgänge, externe Bibliotheken können schreibgeschützt sein, und PostgreSQL benötigt bestimmte Dateisystemsemantiken. Entscheiden Sie für jeden Pfad einzeln, binden Sie die Freigabe ein, bevor die Container starten, verhindern Sie, dass ein leeres lokales Verzeichnis das NAS vortäuscht, und überprüfen Sie das Verhalten sowohl durch einen Neustart des Hosts als auch durch eine kontrollierte Unterbrechung der Freigabe.

Jeden Immich-Pfad vor dem Verschieben klassifizieren

Listen Sie die Upload-Bibliothek, Vorschaubilder oder kodierte Medien, externe Bibliotheken, das Datenbankverzeichnis, den Modell-Cache und Backups getrennt auf. Kennzeichnen Sie, wer in jeden Pfad schreibt und welche Auswirkungen sein Verlust hätte. Eine Medienfreigabe kann geeignet sein; alle Volumes als austauschbar zu behandeln, scheitert an der Designprüfung.

Eine praktische NFS-Anleitung zeigt, wie eine externe Immich-Bibliothek aus gemeinsam genutztem Speicher eingebunden wird. Das Einbindungsmuster für externe Bibliotheken ist für die Planung von Pfaden und Berechtigungen nützlich, belegt aber nicht, dass die Datenbank NFS verwenden sollte.

Lassen Sie PostgreSQL auf für Datenbanken empfohlenem Speicher und schützen Sie es mit nativen Dumps und Backups. Wenn der lokale aktive Speicher begrenzt ist, verschieben Sie nur den gemessenen, kapazitätsintensiven Medienpfad und dokumentieren Sie die Grenze, anstatt den gesamten Anwendungsstatus zu verlagern.

Die Reihenfolge für Remote-Einbindungen deterministisch gestalten

Binden Sie die Freigabe auf dem Host mit expliziten Anmeldedaten oder Exportregeln, einer stabilen Adresse und dem vorgesehenen Lese-/Schreibmodus ein. Überprüfen Sie die erwartete Dateisystemidentität und eine bekannte Markierungsdatei, bevor Sie Immich starten. Binden Sie den bereits eingehängten Host-Pfad in die Container ein.

Konfigurieren Sie den Dienstmanager so, dass Immich auf die Remote-Einbindung wartet und nicht mit einem leeren Fallback-Verzeichnis startet. Ein Systemstart ist nur dann erfolgreich, wenn die Markierung im Container sichtbar ist und eine Testdatei den erwarteten Besitzer erhält. Ein leeres Verzeichnis oder eine Datei im Besitz von root ist ein sofortiger Abbruchgrund.

Starten Sie den Host einmal neu, während die Freigabe verfügbar ist, und ein weiteres Mal, während sie in einem geplanten Wartungsfenster absichtlich nicht verfügbar ist. Der erste Test ist nur erfolgreich, wenn die Markierung vor dem Start von Immich erscheint. Der zweite ist nur erfolgreich, wenn Immich sichtbar stoppt oder fehlschlägt, statt in den leeren lokalen Einhängepunkt zu schreiben.

Containeridentität und Freigabeberechtigungen nachweisen

Gleichen Sie die numerischen Benutzer- und Gruppenidentitäten auf Server, Client und im Container ab. Testen Sie anschließend das Erstellen, Umbenennen, Lesen und Löschen in einem eigens dafür vorgesehenen, kurzlebigen Ordner. Lösen Sie eine Abweichung nicht durch globale Schreibberechtigungen, die die Familienbibliothek offenlegen.

Wiederholen Sie den Test mit der kurzlebigen Datei innerhalb des Immich-Server-Containers und nicht nur auf dem Host. Bestätigen Sie, dass das NAS den vorgesehenen numerischen Besitzer erkennt und Immich die Datei nach einer Neuerstellung des Containers erneut öffnen kann. Ein erfolgreicher Test auf dem Host belegt den Container-Pfad nicht.

Wenn sich Identität oder Verhalten beim Erstellen und Umbenennen unterscheiden, halten Sie an und korrigieren Sie Export, Einbindung oder Container-Zuordnung gezielt. Testen Sie erneut, bevor Sie eine echte Bibliothek scannen. Umfassende Berechtigungsänderungen können die Abweichung verbergen und gleichzeitig jedes Familienfoto für fremde Dienste zugänglich machen.

-15% OFF

ZimaBoard 2 – Mini-Heimserver für Ihre große Idee

Single board computer zimaboard2

Latenz messen und eine Unterbrechung der Freigabe testen

Führen Sie einen repräsentativen Upload, die Erstellung von Vorschaubildern, das Durchsuchen der Zeitleiste, den Download eines Originals und einen Scan der externen Bibliothek durch, während Sie Serverlatenz und Auftragsfortschritt messen. Für den Test erforderlich sind eine akzeptable Bedienung und kein dauerhaftes Anwachsen der Warteschlange. Die reine Verbindungsgeschwindigkeit belegt die Metadatenleistung nicht.

Ein Immich-Issue berichtet aus einer Bereitstellung mit instabilem NFS über Inkonsistenzen zwischen Datenbank und Dateien. Der begrenzte NFS-Fehlerfall spricht dafür, Unterbrechungen während Schreibvorgängen als Wiederherstellungsrisiko zu behandeln, statt davon auszugehen, dass NFS Immich immer beschädigt.

Unterbrechen Sie in einem Wartungsfenster mit abgeschlossenen Backups die Medienfreigabe, während ein unkritischer Test läuft. Immich sollte sichtbar fehlschlagen, statt in den leeren Einhängepunkt zu schreiben. Stellen Sie die Freigabe wieder her und bestätigen Sie, dass sich das Testobjekt und der Datenbankeintrag ohne Neustartschleife abgleichen.

Die Go- oder No-Go-Entscheidung nach den Neustarttests treffen

Starten Sie die Container und den Host getrennt neu. Bestätigen Sie, dass die richtige Freigabe zuerst eingebunden wird, alte und neue Originale geöffnet werden können, Scans externer Bibliotheken keine Duplikate erzeugen und ein neuer Upload einen weiteren Neustart übersteht. Der DAS-NAS-Vergleich von ZimaSpace stellt den Zielkonflikt zwischen Latenz und Fehlerdomäne dar.

Verwenden Sie die Freigabe, wenn diese Tests erfolgreich sind und die Überwachung auf Nichtverfügbarkeit, Latenz, Speicherplatz und Inode-Auslastung hinweisen kann. Entscheiden Sie sich für lokalen oder direkt angeschlossenen Speicher, wenn Netzwerk oder NAS die erforderliche Verfügbarkeit nicht erreichen oder ein Fail-open-Verhalten bei der Einbindung nicht verhindert werden kann.

Wechseln Sie zum vorherigen lokalen Pfad zurück, wenn Immich leer startet, Dateien im Besitz von root erstellt oder nach einer Unterbrechung Fehler wegen fehlender Dateien meldet. Eskalieren Sie mit Angaben zu Protokoll, Einbindungsoptionen, Identitäten, Pfadzuordnungen, Latenz und Startreihenfolge. Führen Sie niemals einen destruktiven erneuten Scan durch, bevor die maßgeblichen Originale und der Datenbankstatus bekannt sind.