Jellyfin zwykle wyświetla nieaktualne dane po przeniesieniu pamięci masowej, ponieważ usługa widzi starą ścieżkę, nie może odczytać nowego punktu montowania lub nie zakończyła prawidłowego skanowania nowej lokalizacji.
Czy pulpit nawigacyjny pokazuje stare elementy, brakujące elementy czy połączenie obu tych stanów? Najpierw nie usuwaj biblioteki ani nie opróżniaj jej kosza. Zapisz dokładne stare i nowe ścieżki, stan montowania, właściciela usługi oraz wynik skanowania, aby każdą gałąź można było przetestować bez niszczenia metadanych.
Sprawdź, jaką ścieżkę Jellyfin faktycznie widzi
Sprawdź ścieżkę z poziomu procesu lub kontenera Jellyfin, a nie tylko z powłoki hosta. Potwierdź, że punkt montowania istnieje po uruchomieniu systemu, konto usługi może wyświetlać zawartość i odczytać przykładowy plik, a mapowanie kontenera odpowiada ścieżce zapisanej w konfiguracji biblioteki.
Jeśli ścieżka jest pusta lub niedostępna, najpierw napraw punkt montowania, UID/GID albo wolumin kontenera. Punkt montowania pamięci masowej, który pojawia się dopiero po ręcznym zalogowaniu, może spowodować, że Jellyfin podczas uruchamiania zeskanuje pusty katalog.
Porównaj starą i nową ścieżkę w konfiguracji biblioteki oraz w jednym rekordzie bazy danych. Jeśli obie nadal istnieją, Jellyfin może prawidłowo wyświetlać jeden poprawny element i jedno nieaktualne odwołanie.
Odróżnij nieaktualne metadane od nieudanego skanowania
Po uzyskaniu dostępu do ścieżki uruchom kontrolowane skanowanie i obserwuj w dziennikach nazwę biblioteki, liczbę elementów, błędy uprawnień oraz pominięte pliki. Porównaj jeden znany stary element z jednym nowo dodanym plikiem. Jeśli skanowanie zakończy się pomyślnie, ale stare ścieżki nadal będą widoczne, baza danych wciąż zawiera poprzednią lokalizację lub nowa ścieżka została dodana bez usunięcia starego odwołania.
Nie uznawaj zapisanej w pamięci podręcznej okładki za dowód dostępności pliku multimedialnego. zasady dotyczące ścieżek pamięci masowej wskazują, że zamontowany system plików i ścieżka aplikacji wymagają osobnych kontroli.
Po poprawieniu mapowania wykonaj jedno kontrolowane skanowanie, a następnie porównaj liczbę elementów i jeden znany plik. Wielokrotne ponowne skanowanie przed naprawieniem ścieżki może powodować jeszcze większy chaos.
Naprawiaj dopiero po potwierdzeniu właściwej przyczyny
Napraw mapowanie ścieżki lub uprawnienia, uruchom usługę ponownie tylko raz i wykonaj skanowanie. Jeśli ścieżka w bazie danych jest nieprawidłowa, zmień lokalizację biblioteki w możliwie najmniejszym zakresie i przed usunięciem starych wpisów sprawdź oczekiwaną liczbę elementów. Przed każdą zbiorczą operacją na metadanych zachowaj dane aplikacji i kopię zapasową.
Odzyskanie poprawnego działania jest potwierdzone, gdy usługa nadal widzi nową ścieżkę po ponownym uruchomieniu, reprezentatywny klient odtwarza element, a drugie skanowanie nie przywraca nieaktualnego stanu. Eskaluj problem, gdy system plików zgłasza uszkodzenie, baza danych zawiera sprzeczne ścieżki lub problem powraca po prawidłowym zamontowaniu i ponownym uruchomieniu.
Po naprawie uruchom usługę ponownie, gdy punkt montowania jest dostępny podczas startu systemu, i powtórz skanowanie. Nieaktualne dane nie zostaną usunięte, dopóki ta sama ścieżka nie pozostanie widoczna po ponownym uruchomieniu.
Eskaluj problem, gdy ścieżka wciąż się pojawia
Utrzymaj naprawione mapowanie, jeśli po prawidłowym ponownym uruchomieniu, jednym skanowaniu i odtworzeniu elementu na reprezentatywnym kliencie wszystkie operacje korzystają z nowej ścieżki, a stary wpis nie zostaje odtworzony.
Przerwij czyszczenie, jeśli stara ścieżka powraca, baza danych zawiera sprzeczne tożsamości lub punkt montowania pamięci masowej zmienia się między skanowaniami. Najpierw zachowaj bazę danych i bieżącą mapę ścieżek.
Przejdź do odtwarzania kopii zapasowej lub naprawy właściwej dla bazy danych, jeśli system plików działa prawidłowo, ale nieaktualne odwołania przetrwają prawidłowe mapowanie i ponowne uruchomienie.
Wsparcie i wskazówki
Więcej do przeczytania

Jak zoptymalizować połączenia z bazą danych Jellyfin dla kontenerów działających równocześnie
Zacznij od jednego właściciela bazy danych i zmierz zachowanie blokad SQLite; dodaj inny backend dopiero wtedy, gdy współbieżność i odzyskiwanie danych uzasadnią tę złożoność.

Jak zapobiegać duplikowaniu zadań lub importów w Jellyfin
Duplikowanie pracy zwykle wynika z nakładających się harmonogramów lub więcej niż jednego procesu zapisującego; wyznacz jednego właściciela, jedną ścieżkę i jeden sposób sprawdzania ukończenia.

Jak naprawić Jellyfin po zapełnieniu woluminu bazy danych
Wstrzymaj zapisy, zachowaj bazę danych i pliki WAL, zwolnij miejsce bez bezmyślnego usuwania stanu, a następnie zweryfikuj integralność i pierwotne działanie.

