So richten Sie lokale Metadatendateien ein, ohne unerwünschte Überschreibungen zuzulassen

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.

How to Set Up Local Metadata Files Without Allowing Unwanted Rewrites - Zima Store Online

Lokale NFO-Dateien und Grafiken machen eine Mediathek portabel, aber derselbe Server, der sie liest, kann möglicherweise auch Titel, Bilder oder Kennungen ersetzen. Ein schreibgeschützter Medien-Mount verhindert versehentliche Schreibvorgänge, verändert jedoch, wo der Server heruntergeladene Begleitdateien speichern kann.

Bestimmen Sie vor einer Änderung der Berechtigungen für jedes Metadatenfeld eine maßgebliche Quelle. Kuratierte Begleitdateien sollten versioniert oder gesichert werden, der Datenbankstatus des Servers sollte beschreibbar bleiben, und ein Aktualisierungstest sollte bestätigen, dass der Server die Quelldateien liest, ohne sie neu zu schreiben. Wiederholen Sie diesen Test nach Upgrades und jeder mediatheksweiten Metadatenaktualisierung.

Bestimmen Sie die maßgebliche Metadatenquelle

Listen Sie die Felder auf, die Sie lokal kuratieren: Titel, Sortiertitel, Ausgabe, Datum, Personen, Anbieter-IDs, Poster und Hintergrundgrafik. Wenn lokale Dateien maßgeblich sind, deaktivieren oder begrenzen Sie Anbieteraktualisierungen, die diese Felder während einer Aktualisierung überschreiben können.

Prüfen Sie vor der Einführung eines Schemas zur Dateibenennung das Verhalten von Jellyfin-NFO-Feldern für die installierte Serverfamilie. Die Unterstützung variiert je nach Bibliothekstyp, und eine offensichtlich wirkende Dateibenennung muss nicht der Datei entsprechen, die der Scanner liest.

Halten Sie ein kleines Beispielverzeichnis außerhalb der Produktionsmediathek bereit. Es sollte einen Film oder eine Episode, die zugehörige NFO-Datei und ausgewählte Grafiken enthalten, damit Scan- und Aktualisierungsverhalten getestet werden können, ohne Tausende kuratierter Dateien zu gefährden.

Schreibgeschützte Medien vom beschreibbaren Serverstatus trennen

Mounten Sie den Medienbaum innerhalb des Containers schreibgeschützt, während die Pfade für Konfiguration, Cache und Datenbank beschreibbar bleiben. Ein Container-Flag wie ein schreibgeschützter Bind-Mount ist zuverlässiger, als sich auf ein Kontrollkästchen der Anwendung zu verlassen, dessen Bedeutung sich zwischen Versionen ändern kann.

Wenn der Server neue Grafiken neben den Medien herunterladen muss, ist eine vollständig schreibgeschützte Mediathek mit diesem Arbeitsablauf nicht vereinbar. Speichern Sie heruntergeladene Metadaten stattdessen im Anwendungsstatus oder verwenden Sie einen kontrollierten Staging-Job, der Begleitdateien außerhalb des Serverprozesses schreibt.

Betrachten Sie die Mount-Zuordnung als Teil der Bereitstellungsdokumentation. Die Checkliste für das Upgrade eines Jellyfin-Containers hilft dabei, die Trennung zwischen Medien, Metadaten und Anwendungsstatus bei einer Neuerstellung beizubehalten.

Deaktivieren Sie Rückschreibpfade, die der Kuratierung widersprechen

Deaktivieren Sie Optionen, die Grafiken oder NFO-Metadaten in Medienordnern speichern, wenn diese Ordner extern kuratiert werden. Prüfen Sie außerdem die Einstellungen zum Speichern von Metadaten pro Bibliothek; eine globale Einstellung ist möglicherweise nicht die einzige Stelle, an der Schreibvorgänge aktiviert werden.

Machen Sie nicht das gesamte Container-Dateisystem schreibgeschützt, um korrekte Mounts zu ersetzen, es sei denn, jeder erforderliche beschreibbare Pfad wird ausdrücklich bereitgestellt. Datenbanken, Protokolle, Plugins und temporäre Dateien benötigen weiterhin kontrollierte beschreibbare Speicherorte.

Erfassen Sie Dateihashes oder Änderungszeiten für die Beispiel-NFO und die Bilder, führen Sie einen Bibliotheksscan durch, bearbeiten Sie einen Titel in der Benutzeroberfläche und starten Sie eine Metadatenaktualisierung. Die Dateien sollten unverändert bleiben, während die Anwendung den zulässigen lokalen Status in ihrer Datenbank speichert.

-15% OFF

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

Single board computer zimaboard2

Überprüfen Sie das Verhalten bei Wiederherstellung und Upgrades

Exportieren oder sichern Sie die kuratierten Begleitdateien unabhängig von der Datenbank des Medienservers. Die Begleitdateien stellen Präsentationsmetadaten wieder her; die Datenbank kann weiterhin Wiedergabestatus, Benutzer, Sammlungen und andere Informationen enthalten, die lokale Dateien nicht abdecken.

Erstellen Sie den Container in einem Testfenster neu und bestätigen Sie, dass das Flag für den schreibgeschützten Mount den Bereitstellungsprozess übersteht. Scannen Sie anschließend das Beispielverzeichnis und vergleichen Sie die Hashes erneut, da ein Upgrade einen neuen Metadatenspeicherer einführen oder einen Standardwert ändern kann.

Die abschließende Abbruchregel ist einfach: Wenn eine Aktualisierung Schreibzugriff erfordert, um das gewünschte Ergebnis zu erhalten, ist das Konzept der maßgeblichen Quelle noch nicht geklärt. Stellen Sie das Beispiel wieder her, lassen Sie die Produktionsmediathek schreibgeschützt und entscheiden Sie, ob der Server oder die externe Kuratierung für dieses Feld zuständig ist.