Ein Jellyfin-Fehler folgt in der Regel dem Client, wenn ein Gerät ausfällt, während ein Kontroll-Client funktioniert, und dem Server, wenn mehrere Clients beim selben Medienpfad ausfallen. Beginnen Sie mit einem lokalen Kontrolltest, bevor Sie Codecs oder Hardware ändern.
Halten Sie Server, Konto, Medien und Qualität unverändert, während Sie den betroffenen Client mit einem bekanntermaßen funktionierenden Client vergleichen. Vergleichen Sie anschließend die direkte lokale Wiedergabe mit der entfernten oder über einen Proxy geleiteten Verbindung. Das Ergebnis zeigt Ihnen, ob Sie die Client-Funktionen, die Jellyfin-Transkodierungseinstellungen oder das Netzwerk-Routing ändern sollten – und wann Sie aufhören sollten, weil die Belege uneindeutig sind.
Einen Kontroll-Client am selben Server verwenden
Ein Client meldet einen Wiedergabefehler. Beginnen Sie mit der am wenigsten invasiven Prüfung: Spielen Sie dasselbe Element mit demselben Konto und derselben Qualität auf einem Kontroll-Client ab. Kontrolltest am selben Server
Die entscheidende Beobachtung ist konkret: Die Kontrolle funktioniert, beide schlagen fehl oder die Kontrolle wählt einen anderen Wiedergabemodus. Notieren Sie das Ergebnis, bevor Sie eine weitere Variable ändern.
Interpretieren Sie den jeweiligen Zweig, anstatt zu raten. Wenn nur der betroffene Client ausfällt, spricht dies für den Client als Fehlergrenze. Wenn beide ausfallen, prüfen Sie Server oder Verbindungsweg. Wenn sich die Modi unterscheiden, vergleichen Sie zuerst Codec- und Untertitelpfad.
Wiedergabemodus und Serverprotokolle prüfen
Auch der Kontroll-Client fällt aus oder fordert denselben Serverpfad an. Beginnen Sie mit der am wenigsten invasiven Prüfung: Vergleichen Sie den Wiedergabemodus im Dashboard und die entsprechenden FFmpeg- oder Serverprotokolle der betroffenen und der Kontrollsitzungen.
Die entscheidende Beobachtung ist konkret: Direct Play schlägt bei beiden fehl, die Transkodierung wird bei beiden beendet oder nur ein Client transkodiert. Notieren Sie das Ergebnis, bevor Sie eine weitere Variable ändern. Belege aus dem FFmpeg-Protokoll
Interpretieren Sie den jeweiligen Zweig, anstatt zu raten. Wenn beide Sitzungen denselben Serverfehler aufweisen, spricht dies für den Server als Fehlergrenze. Wenn nur eine Sitzung transkodiert, kehren Sie zur Client-Fähigkeit zurück. Wenn die Protokolle unauffällig sind, prüfen Sie Verbindungsweg und Browserstatus.
Direkte lokale und entfernte Verbindungen vergleichen
Die Zuständigkeit von Client und Server ist nicht eindeutig geklärt. Beginnen Sie mit der am wenigsten invasiven Prüfung: Verwenden Sie denselben Client und dieselben Medien über die LAN-URL und anschließend über die entfernte oder über einen Proxy geleitete URL.
Die entscheidende Beobachtung ist konkret: Lokal funktioniert die Wiedergabe, entfernt schlägt sie fehl, beide schlagen fehl, entfernt funktioniert sie oder lokal schlägt sie fehl. Notieren Sie das Ergebnis, bevor Sie eine weitere Variable ändern. Lokaler und entfernter Verbindungsweg
Interpretieren Sie den jeweiligen Zweig, anstatt zu raten. Wenn nur die entfernte Verbindung ausfällt, beschränken Sie die Fehlersuche auf Proxy, DNS, Routing oder Bandbreite. Wenn beide ausfallen, überprüfen Sie erneut die Serverbelege. Wenn nur die lokale Verbindung ausfällt, prüfen Sie Bindings oder lokales DNS.
Ursprünglichen Auslöser erneut prüfen und bei der zuständigen Komponente aufhören
Die Zuständigkeit wird bedingt zugewiesen. Beginnen Sie mit der am wenigsten invasiven Prüfung: Wenden Sie eine gezielte Änderung an und wiederholen Sie anschließend die ursprüngliche Sitzung sowie eine Kontrollsitzung.
Die entscheidende Beobachtung ist konkret: Die ursprüngliche Wiedergabe funktioniert und die Kontrolle bleibt stabil, die ursprüngliche Wiedergabe schlägt weiterhin fehl oder beide Pfade ändern sich. Notieren Sie das Ergebnis, bevor Sie eine weitere Variable ändern.
Interpretieren Sie den jeweiligen Zweig, anstatt zu raten. Wenn die ursprüngliche Wiedergabe funktioniert und die Kontrolle stabil bleibt, hören Sie auf. Wenn sie weiterhin fehlschlägt, machen Sie die Änderung rückgängig und eskalieren Sie innerhalb der zugewiesenen Zuständigkeit. Wenn sich beide ändern, kehren Sie zur frühesten unkontrollierten Variable zurück.
Support & Tipps
Mehr zum Lesen

Kann Jellyfin sicher eine GPU oder einen Beschleuniger mit einem anderen Container teilen?
Die gemeinsame GPU-Nutzung ist an Bedingungen geknüpft: Überprüfen Sie die Gerätesichtbarkeit und die Treiberunterstützung, führen Sie anschließend beide Workloads aus und achten Sie auf...

So konfigurierst du den Cache und temporären Speicher von Jellyfin
Trenne dauerhaften Zustand, wiederaufbaubaren Cache und temporären Transkodierungsspeicher und überprüfe anschließend Kapazität und Berechtigungen mit einem echten Wiedergabetest.

So verhindern Sie, dass Jellyfin-Backups einen inkonsistenten Zustand erfassen
Eine vollständige Dateikopie ist nicht automatisch konsistent; frieren Sie Schreibvorgänge ein oder erstellen Sie atomar einen Snapshot, erfassen Sie alle Zustandspfade und weisen Sie...

