Jellyfin uruchamia się, ale jego procesy działające w tle pozostają nieaktywne

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Jellyfin nie udostępnia jednej uniwersalnej usługi procesów roboczych, która musiałaby działać niezależnie od serwera WWW. Jeśli interfejs się wczytuje, ale „procesy robocze” wydają się wyłączone, ustal, która konkretna operacja w tle utknęła: skanowanie biblioteki, odświeżanie metadanych, tworzenie miniatur rozdziałów, zadanie wtyczki lub inne zaplanowane zadanie.

To rozróżnienie ma znaczenie, ponieważ działający punkt końcowy HTTP potwierdza jedynie uruchomienie głównego procesu serwera. Następnie ustal, które zadanie powinno zostać wykonane, sprawdź wynik jego ostatniego uruchomienia i odpowiadające mu wpisy w logach, a potem prześledź pierwszą niedziałającą zależność — bazę danych, zapisywalne dane aplikacji, pamięć masową na pliki multimedialne, wtyczkę lub zasób wymagany przez dane zadanie — zamiast przebudowywać serwer, który już wyświetla interfejs.

Ustal, które dokładnie zadanie w tle nie postępuje

Otwórz pulpit nawigacyjny i wybierz jedno zaplanowane zadanie, którego działanie możesz zaobserwować. Zapisz czas ostatniego i następnego uruchomienia, bieżący stan oraz to, czy ręczne uruchomienie cokolwiek zmienia. Nie sprowadzaj wszystkich bezczynnych zaplanowanych zadań do jednego objawu „proces roboczy jest wyłączony”.

Drzewo kodu źródłowego Jellyfin zawiera osobną implementację ScheduledTasks po stronie serwera, co potwierdza, że konserwacja w tle jest obsługiwana przez osobne zaplanowane operacje, a nie przez drugi, ogólny demon. Implementacja ScheduledTasks w Jellyfin

Jeśli jedno zadanie kończy się niepowodzeniem, a pozostałe są wykonywane, skoncentruj się na tym konkretnym zadaniu. Jeśli żadne zadanie nie chce się uruchomić, poszukaj wspólnej zależności, takiej jak stan bazy danych, uprawnienia do katalogu danych lub migracja przy uruchamianiu, zanim zmienisz ustawienia poszczególnych bibliotek.

Odczytaj pierwszy istotny błąd, a nie ostatni z serii

Sprawdź logi Jellyfin z czasu uruchomienia zadania. Wyszukaj nazwę zadania, a następnie cofnij się do pierwszego ostrzeżenia lub błędu wyjaśniającego, dlaczego nie udało się uzyskać blokady bazy danych, otworzyć ścieżki, zapisać danych aplikacji, uruchomić FFmpeg lub załadować zależności wtyczki.

Poradnik rozwiązywania problemów z Jellyfin zaleca rozpoczęcie diagnozowania problemów z serwerem i odtwarzaniem od sprawdzenia logów oraz zwraca uwagę, że rejestrowanie debugowania może generować bardzo duże ilości danych. Wskazówki Jellyfin dotyczące logów

Włącz rejestrowanie debugowania tylko wtedy, gdy zwykłe logi nie ujawniają przyczyny. Odtwórz problem przy jednej próbie wykonania zadania, a następnie przywróć normalny poziom rejestrowania. Kontrolowane odtworzenie problemu jest bardziej przydatne niż pozostawienie włączonych logów debugowania, gdy kilka niezwiązanych zaplanowanych zadań generuje szum.

Sprawdź, czy można zapisywać w katalogu danych i czy baza danych może kontynuować działanie

Interfejs WWW może być widoczny, nawet jeśli późniejsza operacja w tle nie może zapisywać w przeniesionej lub ponownie mapowanej ścieżce danych. Przed naprawianiem ustawień zadań sprawdź identyfikator UID/GID procesu, właściciela katalogu danych, ilość wolnego miejsca oraz to, czy punkt montowania kontenera umożliwia zapis.

Dokumentacja rozwiązywania problemów z Jellyfin zawiera wskazówki dotyczące blokad bazy danych przy nieudanych skanowaniach, a dokumentacja kontenerów pokazuje, że trwałość konfiguracji i pamięci podręcznej zależy od zamontowanych ścieżek. Trwałe ścieżki kontenera Jellyfin

Jeśli dzienniki wskazują błędy blokady bazy danych, ogranicz konkretne równoległe operacje lub skorzystaj z udokumentowanej procedury rozwiązywania problemów z blokadą bazy danych, zamiast ją usuwać. Jeśli dzienniki wskazują na błędy uprawnień lub trybu tylko do odczytu, napraw tę konkretną ścieżkę danych i ponów to samo zadanie.

Przed rozpoczęciem pracy z biblioteką upewnij się, że pamięć masowa z multimediami jest dostępna

Skanowanie ani zadanie konserwacyjne nie będą działać prawidłowo, jeśli jedna ze ścieżek do multimediów jest niedostępna, niezamontowana lub okresowo działa wolno. Zarówno na hoście, jak i w środowisku uruchomieniowym Jellyfin sprawdź, czy ta sama ścieżka do biblioteki istnieje i jest dostępna do odczytu, zanim ręcznie ponowisz zadanie.

Jellyfin ostrzega, że zaplanowana konserwacja może usunąć elementy, gdy pamięć masowa z multimediami jest niedostępna. Ostrzeżenie o pamięci masowej podczas zaplanowanej konserwacji Dlatego „po prostu ponów skanowanie” nie jest dobrym pierwszym krokiem, jeśli NAS lub dysk zewnętrzny nie został prawidłowo podłączony.

Jeśli po przywróceniu montowania zadanie zostanie wykonane, oznacza to, że przyczyną nie był proces roboczy. Napraw kolejność montowania lub niezawodność pamięci masowej, a następnie ponownie przeprowadź weryfikację po ponownym uruchomieniu hosta, aby ścieżka była dostępna przed standardowym oknem konserwacyjnym Jellyfin.

Izolowanie zależności związanych z wtyczką i konkretnym zadaniem

Jeśli zawodzi tylko jedno zadanie obsługiwane przez wtyczkę lub dotyczące konkretnej funkcji, sprawdź ten komponent zamiast zmieniać globalne ustawienia Jellyfin. Ustal, czy awaria zaczęła się po aktualizacji wtyczki, serwera, zmianie ścieżki lub zależności.

Pozostaw główny serwer, bazę danych i niezwiązane z problemem zadania bez zmian, wyłączając lub przywracając poprzednią wersję wyłącznie podejrzanego, opcjonalnego komponentu. Podejście ZimaSpace do odzyskiwania pojedynczej usługi opiera się na tej samej zasadzie: zachowaniu sprawnych zależności i odizolowaniu jednej niesprawnej usługi.

Jeśli zadanie jest częścią podstawowej funkcjonalności Jellyfin, a dzienniki wskazują na regresję zależną od wersji, zachowaj dzienniki i dokładny numer wersji serwera przed zgłoszeniem problemu. Nie traktuj awarii wtyczki jako powodu do odtwarzania wszystkich danych trwałych.

Ponowne uruchomienie wyłącznie jako etap weryfikacji

Po naprawieniu jednej potwierdzonej zależności uruchom ręcznie zadanie, które zakończyło się niepowodzeniem, i upewnij się, że osiągnie oczekiwany stan końcowy. Następnie raz uruchom ponownie Jellyfin i ponów zadanie albo poczekaj na jego kolejny zaplanowany termin, aby potwierdzić, że naprawa działa również po normalnym uruchomieniu usługi.

Ponowne uruchomienie, które tymczasowo usuwa objawy, ale nie wyjaśnia, która zależność zawiodła, nie jest trwałą naprawą. Jeśli problem powróci, porównaj nowy pierwszy błąd z pierwotnym, zamiast jednocześnie wprowadzać kolejne zmiany w uprawnieniach, bazie danych i wtyczkach.

Zatrzymaj się, gdy zadanie docelowe po ponownym uruchomieniu zakończy się, pojawi się oczekiwany wynik, a pozostałe zaplanowane zadania będą działać prawidłowo. Jeśli to samo główne zadanie nadal kończy się niepowodzeniem mimo potwierdzenia prawidłowego działania pamięci masowej i uprawnień, zgłoś nazwę zadania, wersję, pierwszy błąd, stan ścieżki danych i kroki pozwalające odtworzyć problem.

Wsparcie i porady

Więcej do przeczytania

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.