Jellyfin stellt keinen universellen Hintergrund-Worker-Dienst bereit, der unabhängig vom Webserver laufen muss. Wenn die Benutzeroberfläche geladen wird, aber „Worker“ offline zu sein scheinen, ordne dieses Symptom dem jeweiligen Hintergrundvorgang zu, der nicht weiterläuft: einem Bibliotheksscan, einer Metadatenaktualisierung, einer Aufgabe zur Erstellung von Kapitelbildern, einem Plugin-Auftrag oder einer anderen geplanten Aufgabe.
Diese Unterscheidung ist wichtig, denn ein funktionierender HTTP-Endpunkt belegt nur, dass der Hauptserverprozess gestartet wurde. Ermittle als Nächstes einen Auftrag, der ausgeführt werden sollte, prüfe sein letztes Ergebnis und die zugehörigen Protokollzeilen. Verfolge dann die erste fehlgeschlagene Abhängigkeit - Datenbank, beschreibbare Anwendungsdaten, Medienspeicher, Plugin oder aufgabenspezifische Ressource -, ohne einen Server neu aufzusetzen, der die Benutzeroberfläche bereits bereitstellt.
Ermittle die genaue Hintergrundaufgabe, die nicht fortschreitet
Öffne das Dashboard und wähle eine geplante Aufgabe aus, deren Verhalten du beobachten kannst. Notiere die letzte und nächste Ausführungszeit, den aktuellen Status und ob ein manueller Start etwas ändert. Fasse nicht alle untätigen geplanten Aufgaben unter dem Symptom „Worker offline“ zusammen.
Der Quellcode von Jellyfin enthält eine eigene ScheduledTasks-Implementierung im Server. Das bestätigt, dass Hintergrundwartungsarbeiten als einzelne geplante Vorgänge ausgeführt werden und nicht als allgemeiner zweiter Daemon. Jellyfin-Implementierung von ScheduledTasks
Wenn eine Aufgabe fehlschlägt, während andere abgeschlossen werden, konzentriere die Untersuchung auf diese Aufgabe. Wenn keine der Aufgaben startet, suche nach einer gemeinsamen Abhängigkeit wie dem Datenbankstatus, den Berechtigungen des Datenverzeichnisses oder einer Migration beim Start, bevor du die Einstellungen einzelner Bibliotheken änderst.
Lies den ersten relevanten Fehler, nicht die letzte Folgeerscheinung
Prüfe die Jellyfin-Protokolle rund um den Zeitpunkt, zu dem die Aufgabe ausgelöst wurde. Suche nach dem Aufgabennamen und gehe dann zu den ersten Warn- oder Fehlermeldungen zurück, die erklären, warum die Aufgabe keine Datenbanksperre erhalten, keinen Pfad öffnen, keine Anwendungsdaten schreiben, FFmpeg nicht starten oder eine Plugin-Abhängigkeit nicht laden konnte.
Der Fehlerbehebungsleitfaden von Jellyfin empfiehlt, bei Problemen mit dem Server und der Wiedergabe zuerst die Protokolle zu prüfen, und weist darauf hin, dass die Debug-Protokollierung sehr umfangreiche Ausgaben erzeugen kann. Hinweise zur Jellyfin-Protokollierung
Aktiviere die Debug-Protokollierung nur, wenn die normalen Protokolle den Ausführungspfad nicht erkennen lassen. Führe einen einzelnen Aufgabenversuch aus und stelle die Protokollierung anschließend wieder auf den Normalbetrieb zurück. Eine kontrollierte Reproduktion ist hilfreicher, als die Debug-Protokollierung aktiviert zu lassen, während mehrere nicht zusammenhängende geplante Aufträge unnötige Meldungen erzeugen.
Prüfe, ob in das Datenverzeichnis geschrieben werden kann und die Datenbank Fortschritte macht
Eine Weboberfläche kann angezeigt werden, obwohl ein späterer Hintergrundvorgang nicht in einen verschobenen oder neu zugeordneten Datenpfad schreiben kann. Prüfe die Laufzeit-UID/GID, die Berechtigungen des Datenverzeichnisses, den freien Speicherplatz und ob der Container-Mount beschreibbar ist, bevor du Aufgabeneinstellungen reparierst.
Die Jellyfin-Dokumentation zur Fehlerbehebung enthält Hinweise zu Datenbanksperren bei fehlgeschlagenen Scans. Die Container-Dokumentation zeigt, dass die dauerhafte Speicherung von Konfiguration und Cache von den eingebundenen Pfaden abhängt. Dauerhaft eingebundene Jellyfin-Containerpfade
Wenn die Protokolle Fehler wegen Datenbanksperren zeigen, reduziere die betreffende parallele Verarbeitung oder folge der dokumentierten Anleitung zur Fehlerbehebung bei Datenbanksperren, anstatt die Datenbank zu löschen. Wenn die Protokolle Berechtigungsfehler oder Schreibschutzfehler zeigen, behebe das Problem genau an diesem Datenpfad und führe denselben Auftrag erneut aus.
Vor der Bibliotheksverarbeitung prüfen, ob der Medienspeicher verfügbar ist
Ein Scan oder Wartungsauftrag kann nicht ordnungsgemäß ausgeführt werden, wenn einer der Medienpfade fehlt, nicht eingebunden oder zeitweise langsam ist. Prüfe auf dem Host und in der Jellyfin-Laufzeitumgebung, ob derselbe Bibliothekspfad vorhanden und lesbar ist, bevor du den Auftrag manuell erneut ausführst.
Jellyfin warnt, dass die geplante Wartung Elemente entfernen kann, wenn der Medienspeicher nicht verfügbar ist. Hinweis zum Medienspeicher bei geplanter Wartung Deshalb ist „einfach den Scan erneut ausführen“ kein guter erster Schritt, wenn ein NAS oder eine externe Festplatte nicht korrekt eingebunden wurde.
Wenn der Auftrag nach Wiederherstellung des Mounts abgeschlossen wird, war der Worker nicht die Ursache. Behebe die Reihenfolge der Mounts oder die Zuverlässigkeit des Speichers und prüfe das Ergebnis nach einem Neustart des Hosts erneut, damit der Pfad vor Jellyfins regulärem Wartungszeitfenster verfügbar ist.
Plugin- und aufgabenspezifische Abhängigkeiten isolieren
Wenn nur ein Plugin-eigener oder funktionsspezifischer Auftrag fehlschlägt, untersuche diese Komponente, statt globale Jellyfin-Einstellungen zu ändern. Prüfe, ob der Fehler nach einem Plugin-Update, einem Server-Upgrade, einer Pfadänderung oder einer Änderung von Abhängigkeiten aufgetreten ist.
Lass den Hauptserver, die Datenbank und nicht betroffene Aufgaben unverändert, während du nur die verdächtige optionale Komponente deaktivierst oder zurücksetzt. ZimaSpaces Ansatz zur Wiederherstellung einzelner Dienste folgt demselben Prinzip: Gesunde Abhängigkeiten bleiben erhalten, während ein einzelner ausgefallener Dienst isoliert wird.
Wenn der Auftrag zu Jellyfins Kernfunktionen gehört und die Protokolle auf eine versionsspezifische Regression hindeuten, sichere die Protokolle und die genaue Serverversion, bevor du das Problem eskalierst. Verallgemeinere einen Plugin-Fehler nicht zu einem Grund, sämtliche persistenten Daten neu anzulegen.
Neustart nur als Validierungsschritt
Nachdem du eine nachweislich fehlerhafte Abhängigkeit korrigiert hast, starte die fehlgeschlagene Aufgabe manuell und bestätige, dass sie den erwarteten Abschlussstatus erreicht. Starte Jellyfin dann einmal neu und wiederhole die Aufgabe oder warte auf die nächste geplante Ausführung, um sicherzustellen, dass die Reparatur auch nach dem normalen Dienststart Bestand hat.
Ein Neustart, der das Symptom vorübergehend beseitigt, ohne die ausgefallene Abhängigkeit zu erklären, ist keine dauerhafte Reparatur. Wenn das Problem wieder auftritt, vergleiche den ersten neuen Fehler mit dem ursprünglichen, anstatt gleichzeitig weitere Änderungen an Berechtigungen, Datenbank und Plugins vorzunehmen.
Halte an, sobald die Zielaufgabe nach dem Neustart abgeschlossen ist, die erwartete Ausgabe erscheint und die übrigen geplanten Aufgaben weiterhin ordnungsgemäß laufen. Eskaliere das Problem mit dem Aufgabennamen, der Version, dem ersten Fehler, dem Status des Datenpfads und den Reproduktionsschritten, falls dieselbe Kernaufgabe weiterhin fehlschlägt, obwohl Speicherzugriff und Berechtigungen bestätigt sind.
Support und Tipps
Mehr zum Lesen

So halten Sie Erwachsenenvideos auf Ihrem NAS vor Familienmitgliedern verborgen
Bewahre Videos für Erwachsene auf einem Familien-NAS privat auf. Prüfe Ordnerberechtigungen, den Bibliothekszugriff in Plex und Jellyfin, Vorschaubilder, den Wiedergabeverlauf, gemeinsam genutzte TV-Logins und...

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...



