Warum werden beim Scannen einer Medienbibliothek Filme auf einer eingebundenen Freigabe nicht gefunden?

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.

Why Does a Media Library Scan Miss Movies on a Mounted Share?

Ein Medienscan überspringt Filme, wenn der Server den eingebundenen Pfad nicht durchlaufen kann, einen anderen Pfad sieht oder die Dateien bei der Identifizierung ablehnt.

Auf einem Heim-NAS kann „die Freigabe ist eingebunden“ lediglich bedeuten, dass die Host-Shell ein Verzeichnis sehen kann. Der Medienserver-Prozess befindet sich möglicherweise in Docker, verwendet einen anderen Bind-Pfad, läuft unter einer anderen UID oder scannt einen leeren lokalen Einhängepunkt, der nach der Trennung der Remote-Freigabe zurückgeblieben ist. Diagnostizieren Sie einen fehlenden Film vom Speicher bis zur Anwendung, statt wiederholt vollständige Scans zu starten, die weder einen Pfad-, Berechtigungs-, Benennungs- noch Parserfehler beheben können.

Nachweisen, dass die eingebundene Freigabe den Film jetzt enthält

Prüfen Sie den genauen Quellpfad der Bibliothek auf dem Host und listen Sie einen fehlenden Film mit vollständigem Dateinamen auf. Bestätigen Sie Dateisystemtyp, Einhängequelle, Einhängeoptionen, freien Speicherplatz und eine bekannte Dateianzahl, anstatt sich darauf zu verlassen, dass lediglich das Verzeichnis des Einhängepunkts existiert.

Eine getrennte Netzwerkfreigabe kann am selben Einhängepunkt ein gewöhnliches leeres Verzeichnis zurücklassen, sodass ein Scan abgeschlossen wird, ohne Medien zu finden. Ein Jellyfin-Bericht beschreibt einen Scan, der erfolgreich wirkte, obwohl das Ziel auf null Elemente verwies.

Lesen Sie einen kleinen Teil der fehlenden Datei und listen Sie ihre übergeordneten Verzeichnisse auf. Falls die Freigabe fehlt, stellen Sie die Einbindung vor dem Scan wieder her und konfigurieren Sie den Mediendienst so, dass er erst startet, wenn das entfernte Dateisystem verfügbar ist. Fügen Sie den leeren lokalen Einhängepunkt nicht als zweiten Bibliothekspfad hinzu.

Den Pfad aus dem Medienserver-Container prüfen

Öffnen Sie eine Shell im laufenden Container und prüfen Sie den genauen Pfad, der in der Bibliothek konfiguriert ist. Der Host verwendet möglicherweise /mnt/media/movies, während der Container ihn als /media/movies sieht; nur der containerinterne Pfad gehört in die Anwendung.

Neue Medien können unsichtbar bleiben, obwohl ältere Elemente weiterhin abgespielt werden, wenn der laufende Container den aktuellen Hostpfad nicht mehr sieht oder veraltete Einhängeinhalte erhält. In einem Jellyfin-Fall wurde berichtet, dass neue Medien nicht angezeigt wurden, obwohl wiederholt Scans durchgeführt worden waren.

Vergleichen Sie die Container-Einhängedefinition mit der vom Laufzeitsystem angezeigten effektiven Einbindung. Stellen Sie sicher, dass die Bind-Quelle die tatsächlich eingebundene Freigabe und nicht ein übergeordnetes Verzeichnis oder ein veralteter Pfad ist. Erstellen Sie den Container erst neu, nachdem Sie bestätigt haben, dass seine persistenten Konfigurations- und Datenbankeinbindungen unverändert sind.

Die Verzeichnisdurchquerung als tatsächlicher Dienstbenutzer testen

Verwenden Sie UID und GID des Medienservers, um jedes Verzeichnis vom Bibliotheksstamm bis zur Filmdatei aufzulisten. Das Lesen der Datei allein reicht nicht aus; der Prozess benötigt außerdem Ausführungsrechte für jedes übergeordnete Verzeichnis, um den Pfad zu durchlaufen.

Ein Jellyfin-Problem zur Bibliothekssichtbarkeit nennt fehlende Lese- und Verzeichnis-Ausführungsrechte als direkte Ursache dafür, dass Elemente nicht angezeigt werden. Entscheidend ist die Berechtigung zur Verzeichnisdurchquerung und nicht die Frage, ob ein Administratorkonto die Freigabe durchsuchen kann.

Beheben Sie die kleinstmögliche Regel für Eigentümer, Gruppe oder ACL, die dem Dienst schreibgeschützten Zugriff auf die Medien gewährt. Der ZimaSpace-Leitfaden zu Berechtigungen nach dem Verschieben von Dateien beschreibt den ergänzenden Ablauf, wenn die Freigabe über SMB funktioniert, aber innerhalb des Containers nicht.

Featured

ZimaCube 2 Persönliche Cloud Home NAS

ZimaCube2

Einen fehlenden Film mit einem erkannten Film vergleichen

Wählen Sie zwei Ordner unter derselben eingebundenen Freigabe: einen Film, den die Bibliothek erkennt, und einen, den sie überspringt. Vergleichen Sie Dateiname, Erweiterung, Ordnertiefe, Groß- und Kleinschreibung, Sonderzeichen, Dateigröße, Verwendung von Symlinks, Berechtigungen, Zeitstempel und den Dateivollständigkeitsstatus.

Einige Scannerfehler betreffen einzelne Elemente und nicht die gesamte Freigabe. In einem gemeldeten Jellyfin-Fall wurden Filme erst angezeigt, nachdem sie in einen anderen Ordner verschoben worden waren. Das zeigt, warum ein kontrollierter Vergleich zwischen erkanntem und fehlendem Film hilfreicher ist als ein weiterer globaler Scan.

Benennen Sie nur ein kopiertes Testelement um oder verschieben Sie es in eine einfache Struktur wie Movies/Movie Name (Year)/Movie Name (Year).mkv. Wenn die Kopie angezeigt wird, prüfen Sie die Benennung, versteckte Markierungen, Berechtigungen oder das Dateisystemverhalten des ursprünglichen Ordners, bevor Sie die gesamte Bibliothek ändern.

Das Scannerprotokoll beim ersten fehlenden Pfad lesen

Starten Sie einen gezielten Scan und verfolgen Sie das Protokoll ab dem Moment, in dem der Scanner das betroffene Verzeichnis betritt. Suchen Sie nach verweigertem Zugriff, nicht gefundenen Verzeichnissen, E/A-Fehlern, nicht unterstützten Dateien, Fehlern bei der Dateianalyse, Datenbankbeschränkungen, Fehlern von Metadatenanbietern und abgebrochenen Scans.

Ein vollständiger Scan kann nach einer Ausnahme auf Pfadebene die weitere Verarbeitung beenden oder überspringen, während die Benutzeroberfläche nur eine unvollständige Bibliothek anzeigt. Jellyfin hat Scans dokumentiert, die durch eine Ausnahme wegen eines fehlenden Verzeichnisses beeinträchtigt wurden. Dadurch ist der erste Fehler wichtiger als die abschließende Fortschrittsanzeige.

Beheben Sie den frühesten reproduzierbaren Fehler und führen Sie den kleinstmöglichen Scan erneut aus. Löschen Sie die Bibliotheksdatenbank, Metadaten oder den Cache erst, wenn die Pfadsichtbarkeit und Berechtigungen nachgewiesen sind; destruktive Zurücksetzungen können diagnostische Hinweise entfernen, ohne die eingebundene Freigabe zu reparieren.

Die Behebung mit einem kontrollierten Import und Neustart überprüfen

Fügen Sie derselben Freigabe einen Testfilm mit einem eindeutigen Namen hinzu, scannen Sie die betroffene Bibliothek und bestätigen Sie, dass er einmalig mit dem korrekten Pfad und den richtigen Metadaten angezeigt wird. Starten Sie anschließend den Container neu und führen Sie einen Neustart des Hosts durch.

Bestätigen Sie nach dem Neustart, dass die Remote-Freigabe vor dem Mediendienst eingebunden wird, der Container den befüllten Pfad sieht, der Dienstbenutzer ihn durchlaufen kann und der Scanner eine neu hinzugefügte Testdatei ohne manuelle Berechtigungsänderungen erkennt.

Die Reparatur ist erst abgeschlossen, wenn die tatsächlich fehlenden Filme von ihrem vorgesehenen eingebundenen Speicherort angezeigt werden, kein leeres Ausweichverzeichnis gescannt wird und das Ergebnis nach erneuter Einbindung, Neuerstellung des Containers und einem Hostneustart bestehen bleibt. Entfernen Sie die Testkopie, nachdem Sie bestätigt haben, dass der ursprüngliche Bibliothekspfad stabil ist.