Dlaczego skanowanie biblioteki multimediów pomija filmy w zamontowanym udziale?
Skanowanie multimediów pomija filmy, gdy serwer nie może przejść przez zamontowaną ścieżkę, widzi inną ścieżkę albo odrzuca pliki podczas identyfikacji.
W przypadku domowego serwera NAS określenie „udział jest zamontowany” może oznaczać jedynie, że powłoka systemu hosta widzi katalog. Proces serwera multimediów może działać wewnątrz Dockera, korzystać z innej ścieżki bind mount, działać z innym identyfikatorem UID albo skanować pusty lokalny punkt montowania pozostały po odłączeniu zdalnego udziału. Zdiagnozuj jeden brakujący film — od pamięci masowej po aplikację — zamiast wielokrotnie uruchamiać pełne skanowanie, które nie naprawi problemu ze ścieżką, uprawnieniami, nazewnictwem ani analizatorem plików.
Udowodnij, że zamontowany udział zawiera teraz film
Sprawdź dokładną ścieżkę źródłową biblioteki z poziomu hosta i wyświetl jeden brakujący film z pełną nazwą pliku. Potwierdź typ systemu plików, źródło montowania, opcje montowania, wolne miejsce oraz liczbę znanych plików, zamiast ufać jedynie temu, że katalog punktu montowania istnieje.
Odłączony udział sieciowy może pozostawić zwykły pusty katalog w tym samym punkcie montowania, przez co skanowanie zakończy się bez znalezienia multimediów. W jednym ze zgłoszeń dotyczących Jellyfin opisano skanowanie, które wyglądało na pomyślne, mimo że ścieżka docelowa wskazywała zero elementów.
Odczytaj niewielki fragment brakującego pliku i wyświetl jego katalogi nadrzędne. Jeśli udział jest niedostępny, przywróć montowanie przed skanowaniem i skonfiguruj usługę multimediów tak, aby uruchamiała się dopiero po udostępnieniu zdalnego systemu plików. Nie dodawaj pustego lokalnego punktu montowania jako drugiej ścieżki biblioteki.
Sprawdź ścieżkę z poziomu kontenera serwera multimediów
Wejdź do uruchomionego kontenera i sprawdź dokładną ścieżkę skonfigurowaną w bibliotece. Host może korzystać ze ścieżki /mnt/media/movies, podczas gdy kontener widzi ją jako /media/movies; w aplikacji należy używać wyłącznie ścieżki widocznej w kontenerze.
Nowe multimedia mogą pozostać niewidoczne, nawet gdy starsze elementy nadal się odtwarzają, jeśli uruchomiony kontener nie widzi już bieżącej ścieżki hosta albo otrzymuje nieaktualną zawartość montowania. W jednym ze zgłoszeń dotyczących Jellyfin poinformowano, że nowe multimedia nie pojawiały się po wielokrotnym skanowaniu.
Porównaj definicję montowania kontenera z efektywnym montowaniem pokazanym przez środowisko uruchomieniowe. Upewnij się, że źródło bind mount wskazuje rzeczywiście zamontowany udział, a nie katalog nadrzędny lub nieaktualną ścieżkę. Odtwórz kontener dopiero po potwierdzeniu, że jego trwała konfiguracja i montowania bazy danych pozostały niezmienione.
Przetestuj przechodzenie przez katalogi jako rzeczywisty użytkownik usługi
Użyj identyfikatorów UID i GID serwera multimediów, aby wyświetlić każdy katalog od katalogu głównego biblioteki do pliku filmu. Sam odczyt pliku nie wystarczy — proces potrzebuje także uprawnienia wykonywania dla każdego katalogu nadrzędnego, aby móc przejść przez ścieżkę.
W zgłoszeniu dotyczącym widoczności biblioteki Jellyfin wskazano brak uprawnień do odczytu i wykonywania operacji na katalogach jako bezpośrednią przyczynę niepojawiania się elementów. Kluczowa jest uprawnienie do przechodzenia przez katalogi, a nie to, czy konto administratora może przeglądać udział.
Napraw możliwie najmniejszą regułę własności, grupy lub ACL, która zapewni usłudze dostęp do multimediów tylko do odczytu. Przewodnik ZimaSpace dotyczący uprawnień po przeniesieniu plików przedstawia powiązaną procedurę w sytuacji, gdy udział działa przez SMB, ale nie wewnątrz kontenera.
Porównaj jeden brakujący film z jednym wykrytym filmem
Wybierz dwa katalogi w ramach tego samego zamontowanego udziału: jeden film wykrywany przez bibliotekę i jeden pomijany. Porównaj nazwę pliku, rozszerzenie, głębokość katalogu, wielkość liter, znaki specjalne, rozmiar pliku, użycie dowiązań symbolicznych, uprawnienia, znaczniki czasu oraz kompletność pliku.
Niektóre problemy ze skanowaniem dotyczą konkretnych elementów, a nie całego udziału. W jednym ze zgłoszeń dotyczących Jellyfin stwierdzono, że filmy pojawiały się dopiero po przeniesieniu ich do innego katalogu, co pokazuje, dlaczego kontrolowane porównanie wykrytego i brakującego filmu jest bardziej użyteczne niż kolejne globalne skanowanie.
Zmień nazwę lub przenieś wyłącznie skopiowany element testowy do prostej struktury, takiej jak Movies/Movie Name (Year)/Movie Name (Year).mkv. Jeśli kopia się pojawi, sprawdź nazewnictwo, ukryte oznaczenia, uprawnienia lub działanie systemu plików w oryginalnym katalogu, zanim zmienisz całą bibliotekę.
Odczytaj dziennik skanera przy pierwszej brakującej ścieżce
Rozpocznij skanowanie ukierunkowane i śledź dziennik od chwili, gdy skaner wejdzie do problematycznego katalogu. Wyszukaj komunikaty o odmowie dostępu, nieznalezieniu katalogu, błędach wejścia/wyjścia, nieobsługiwanych plikach, błędach analizy, ograniczeniach bazy danych, błędach dostawcy metadanych oraz anulowaniu skanowania.
Pełne skanowanie może zatrzymać się lub pominąć część pracy po wyjątku dotyczącym ścieżki, podczas gdy interfejs użytkownika pokazuje jedynie niekompletną bibliotekę. W Jellyfin udokumentowano skanowania, na które wpływał wyjątek dotyczący brakującego katalogu, dlatego pierwszy błąd jest ważniejszy niż końcowy wskaźnik postępu.
Napraw najwcześniejszy powtarzalny błąd i uruchom ponownie możliwie najmniejsze skanowanie. Nie usuwaj bazy danych biblioteki, metadanych ani pamięci podręcznej, dopóki nie potwierdzisz widoczności ścieżki i uprawnień; destrukcyjne resetowanie może usunąć dowody diagnostyczne bez naprawienia zamontowanego udziału.
Zweryfikuj naprawę za pomocą kontrolowanego importu i ponownego uruchomienia
Dodaj jeden testowy film o prostej nazwie do tego samego udziału, przeskanuj problematyczną bibliotekę i potwierdź, że pojawia się raz, z prawidłową ścieżką i metadanymi. Następnie uruchom ponownie kontener i hosta.
Po ponownym uruchomieniu potwierdź, że zdalny udział jest montowany przed uruchomieniem usługi multimediów, kontener widzi wypełnioną ścieżkę, użytkownik usługi może przez nią przechodzić, a skaner wykrywa nowo dodany plik testowy bez ręcznych zmian uprawnień.
Naprawę można uznać za zakończoną dopiero wtedy, gdy rzeczywiście brakujące filmy pojawiają się z zamierzonej, zamontowanej lokalizacji, skanowanie nie obejmuje pustego katalogu zastępczego, a wynik utrzymuje się po ponownym montowaniu, odtworzeniu kontenera i ponownym uruchomieniu hosta. Usuń kopię testową po potwierdzeniu stabilności oryginalnej ścieżki biblioteki.
Polecane produkty
Wsparcie i wskazówki
Więcej do przeczytania
Czy Plex może współdzielić kartę graficzną z innym kontenerem Dockera?
Plex i inny kontener często mogą korzystać z tego samego układu GPU, ale należy przetestować obsługę sterowników, mapowanie urządzeń, obciążenie silnika wideo, pamięć oraz...
Jak ustalić, czy błąd Plex pochodzi od klienta, czy od serwera
Odtwórz ten sam przypadek na innym kliencie, porównaj ścieżkę sesji, a następnie zbierz dowody z serwera dopiero wtedy, gdy zakres analizy wskaże, gdzie faktycznie...
Jak skonfigurować pamięć podręczną Plex i tymczasową pamięć na transkodowane pliki
Chroń trwały stan Plex, umieszczając tymczasowe pliki transkodowania na odpowiedniej pamięci lokalnej, a następnie zweryfikuj czyszczenie, ilość wolnego miejsca i zachowanie podczas ponownego uruchamiania.
