Gdy Jellyfin działa przed ponownym uruchomieniem, ale odtwarzanie przestaje działać po nim, przed zmianą biblioteki sprawdź zależności, które musiały zostać przywrócone podczas rozruchu.
Ponowne uruchomienie może zmienić moment montowania, mapowania urządzeń kontenera, uprawnienia, DNS lub kolejność, w jakiej usługi stają się dostępne. Sprawny proces Jellyfin nie oznacza, że jego ścieżka multimediów ani GPU są użyteczne. Porównaj środowisko po rozruchu z działającą konfiguracją bazową i napraw pierwszą brakującą zależność.
Sprawdź, czy zasób multimediów jest rzeczywiście zamontowany
Katalog może istnieć nawet wtedy, gdy NAS lub dysk, który zwykle go zajmuje, nie został zamontowany. Jellyfin może wtedy zobaczyć pustą lokalną ścieżkę i zgłosić brak multimediów zamiast oczywistego błędu montowania.
Weryfikacja montowania przed uruchomieniem usług zapobiega zapisywaniu danych przez aplikacje w pustym punkcie montowania lub skanowaniu go.
Potwierdź tożsamość systemu plików za pomocą `findmnt` lub odpowiednika dostępnego na danej platformie, a następnie odczytaj znany plik multimedialny jako użytkownik usługi Jellyfin. Nie uruchamiaj ponownego skanowania, dopóki właściwy zasób nie będzie dostępny.
Zweryfikuj właściciela danych aplikacji po ponownym uruchomieniu środowiska wykonawczego
Odtworzenie kontenera lub zmiany na hoście mogą zmienić numeryczny identyfikator użytkownika uzyskującego dostęp do trwałej konfiguracji. Sam dostęp do odczytu nie wystarczy, ponieważ Jellyfin musi również aktualizować stan bazy danych i konfiguracji.
Usługi działające w kontenerach pozostają przewidywalne, gdy mapowanie UID i GID odpowiada właścicielowi systemu plików w zamontowanych katalogach.
Wykonaj test jednorazowego utworzenia i usunięcia pliku w nadrzędnym katalogu danych aplikacji, używając tożsamości usługi. Trwała ścieżka danych aplikacji powinna przetrwać wymianę środowiska wykonawczego bez konieczności rekurencyjnej naprawy właściciela.
Potwierdź ponowne pojawienie się urządzeń sprzętowych
Transkodowanie, które przed ponownym uruchomieniem korzystało ze zintegrowanego GPU, może przełączyć się na procesor lub zakończyć się niepowodzeniem, jeśli brakuje mapowania `/dev/dri` albo innego akceleratora. Odtwarzanie bezpośrednie może nadal działać, przez co awaria wygląda na problem dotyczący wyłącznie multimediów.
Nieudane mapowanie urządzenia może przenieść to samo odtwarzanie ze sprzętu do oprogramowania; test wydajności transkodowania Jellyfin pokazuje, jak znacznie zmienia się obciążenie procesora i GPU między ścieżkami z akceleracją sprzętową a filtrowanymi.
Odtwórz jeden znany test transkodowania sprzętowego i sprawdź aktywny proces oraz mapowanie urządzeń. Napraw dostęp środowiska wykonawczego do urządzenia, zanim obniżysz jakość lub zmienisz kodeki.
Ponownie przetestuj ścieżkę sieciową dopiero po uruchomieniu lokalnego odtwarzania
Zdalny DNS, VPN lub usługi proxy mogą uruchomić się później niż Jellyfin i spowodować awarię występującą wyłącznie zdalnie. Traktuj lokalne multimedia i zdalną dostępność jako osobne testy akceptacyjne.
Przepustowość sieci należy sprawdzać na rzeczywistej krawędzi dostarczania; model przepustowości strumieniowania rozdziela ograniczenia sieci LAN, Wi-Fi, NAS i zdalnego wysyłania, zamiast traktować każdą awarię odtwarzania jako problem z mocą obliczeniową serwera.
Najpierw sprawdź lokalnego klienta przewodowego, a następnie jednego klienta zdalnego. Jeśli lokalne odtwarzanie działa poprawnie, dalszej naprawy szukaj w konfiguracji routingu, DNS, proxy lub tunelu, zamiast odbudowywać stan serwera.
Wsparcie i wskazówki
Więcej do przeczytania

Czy podczas tworzenia kopii zapasowej Jellyfin należy zatrzymać usługę?
Dla uproszczenia preferuj kopie zapasowe usług zatrzymanych; migawek na żywo używaj tylko wtedy, gdy stan aplikacji jest przechwytywany w spójny sposób, a przywracanie zostało...

Dlaczego Jellyfin działa głośno lub powoduje przegrzewanie, gdy nikt nie ogląda strumieniowo?
Podwyższona temperatura w stanie bezczynności zwykle oznacza działanie procesów w tle lub obciążenie współdzielonego hosta, dlatego przed zmianą chłodzenia albo sprzętu zidentyfikuj aktywny proces...

Kiedy odbudować Jellyfin zamiast go naprawiać?
Wybierz odtworzenie zamiast naprawy, gdy problemem jest rozbieżność środowiska uruchomieniowego, a trwały stan został zarchiwizowany; nie „odtwarzaj” przez usunięcie jedynej sprawnej bazy danych.

