Community-Lösung

Jellyfin-Wiedergabefehler „Medien nicht unterstützt“ auf ZimaOS beheben

A ZimaOS Jellyfin case where a generic unsupported-media message was traced through logs to a Docker mount that exposed Music at /Media while the libraries expected /Media/Music, /Media/Movies, and /Media/TV Shows.

Ein ZimaOS-Benutzer sah bei Filmen und MP3-Dateien auf jedem getesteten Gerät die Jellyfin-Meldung „Die Wiedergabe ist fehlgeschlagen, da die Medien von diesem Client nicht unterstützt werden“. Da die Meldung auf eine Medienunterstützung hinwies, wurden zunächst Browser-Cache, Codecs, Transkodierung oder Berechtigungen als mögliche Ursachen vermutet.

Die Protokolle erzählten eine andere Geschichte. Jellyfin war korrekt gestartet, hatte FFmpeg gefunden, mehrere Audio- und Videodecoder bereitgestellt und korrekte Berechtigungen für die Grafikgeräte gemeldet. Beim Start der Wiedergabe protokollierte der Server wiederholt Datei konnte nicht gefunden werden. Das Community-Mitglied gelbuilding führte diese Meldung auf einen Docker-Volume-Pfad zurück, der nur das Music-Verzeichnis unter /Media einband, während die Jellyfin-Bibliotheken weiterhin Dateien unter /Media/Music, /Media/Movies und /Media/TV Shows erwarteten.

Der Wiedergabefehler, der bei jedem Client angezeigt wurde

MrPenguin berichtete, dass Jellyfin und die DNS-Konfiguration des Benutzers nach früheren Support-Sitzungen stabil geblieben waren. Außerdem war ein Backup erstellt worden. Der neue Fehler betraf Filme und Musik auf jedem Gerät, wodurch es nahelag, Cache, Codec-Unterstützung oder Dateiberechtigungen als mögliche Ursachen zu prüfen.

Mobiler Jellyfin-Webplayer mit dem Wiedergabefehler „Medien werden nicht unterstützt“
Der ursprüngliche Screenshot zeigt Jellyfins allgemeinen, clientseitigen Wiedergabefehler. Die Meldung verriet nicht, dass der serverseitige Dateipfad fehlte.

Wer Hardware-Limits von Fehlern bei Speicherpfaden trennen möchte, kann die Jellyfin-Hardwareanforderungen konsultieren. In diesem Fall stammten die entscheidenden Hinweise jedoch aus den Zeilen zur nicht gefundenen Datei und nicht aus der Client-Meldung.

Die Protokolle zeigten eine fehlende Datei, keinen nicht unterstützten Codec

Das Startprotokoll identifizierte Jellyfin 10.10.7 auf Ubuntu 24.04.3 LTS in einem x64-LinuxServer.io-Container. Außerdem wurden Jellyfin FFmpeg 7.1.2, zahlreiche verfügbare Decoder und Encoder sowie Schnittstellen zur Hardwarebeschleunigung wie CUDA, VA-API, QSV, DRM, OpenCL und Vulkan angezeigt.

Auch die Prüfungen des Grafikgeräts fielen positiv aus:

Die Berechtigungen für /dev/dri/renderD128 sind korrekt.
Die Berechtigungen für /dev/dri/card0 sind korrekt.

Die Wiedergabeanforderung lieferte anschließend die Zeile, die die Diagnose änderte:

Datei „/Media/Music/Beyonce/Unknown Album/Single Ladies ... .mp3“ konnte nicht gefunden werden.

Eine fehlende Folder.jpg Auch dieser Pfad war vorhanden. Das bedeutete, dass Jellyfins Datenbank weiterhin auf Bibliothekspfade verwies, die im aktuellen Container nicht vorhanden waren. Codec-Kompatibilität konnte nicht helfen, wenn der Server die Quelldatei überhaupt nicht öffnen konnte.

Der offizielle Jellyfin-Leitfaden zur Fehlerbehebung empfiehlt ebenfalls, die Diagnose der Wiedergabe mit den Server- und FFmpeg-Protokollen zu beginnen, statt sich ausschließlich auf die vom Client angezeigte Meldung zu verlassen.

Befehle zur Überprüfung der Containerpfade

Gelbuilding bat den Autor zu bestätigen, was der laufende Jellyfin-Container tatsächlich sehen konnte:

docker exec -it jellyfin ls -lah /Media
docker exec -it jellyfin ls -lah "/Media/Music"
docker exec -it jellyfin ls -lah "/Media/Music/Beyonce/Unknown Album" | head

Die Antwort bat außerdem um die aktiven Docker-Mounts:

docker inspect jellyfin --format '{{json .Mounts}}' | sed 's/},/},\n/g'

Diese Prüfungen beantworten zwei unterschiedliche Fragen. Die Befehle docker exec zeigen, ob die Pfade aus Sicht von Jellyfin vorhanden sind, während docker inspect anzeigt, welche Hostverzeichnisse in den Container eingebunden sind. Die offizielle Jellyfin-Containerdokumentation liefert den weiteren Kontext für dauerhafte Konfigurationen und Medien-Volume-Zuordnungen.

Das eigentliche Problem bei der Volume-Zuordnung

Die Inspektionsausgabe des Autors zeigte diese Medienzuordnung:

Host:      /media/2 TB Master Drive/Media/Music
Container: /Media

Diese Zuordnung platziert den Inhalt des Music Ordner direkt im Containerpfad /Media. Es erstellt kein /Media/Music innerhalb des Containers. Die Auflistung zeigte daher Künstlerordner direkt unter /Media.

Gleichzeitig versuchte Jellyfin, Pfade zu öffnen, die mit Folgendem begannen:

  • /Media/Music/...
  • /Media/Movies/...
  • /Media/TV Shows/...

Die Bibliotheksdatenbank und die aktive Container-Zuordnung beschrieben nicht mehr dieselbe Verzeichnisstruktur. Deshalb konnten Medienelemente in Jellyfin weiterhin sichtbar sein, während die Wiedergabe bei null Sekunden fehlschlug.

ZimaOS-Jellyfin-Einstellungen mit dem direkt Media zugeordneten Music-Hostordner
Die ZimaOS-App-Einstellungen zeigen, dass der Unterordner Music direkt dem Ordner Media zugeordnet ist. /Media, während Jellyfin separate Pfade für Music, Movies und TV Shows unterhalb dieses Containerverzeichnisses erwartete.

Die von der Community vorgeschlagene Zuordnungsänderung

Gelbuilding empfahl, den übergeordneten Ordner einzubinden Media Ordner statt nur den Music Unterordner:

Ändern von:
/media/2 TB Master Drive/Media/Music  →  /Media

Ändern zu:
/media/2 TB Master Drive/Media        →  /Media

Wenn der übergeordnete Ordner eingebunden ist, kann der Container Folgendes bereitstellen: /Media/Music, /Media/Moviesund /Media/TV Shows unter Verwendung der bereits in Jellyfin gespeicherten Pfade. Leerzeichen und Groß-/Kleinschreibung müssen exakt übereinstimmen; bereits ein fehlendes Leerzeichen in TV-Sendungen ändert den Pfad.

Nach dem Speichern der korrigierten Volume-Zuordnung wies die Antwort den Autor an, Jellyfin neu zu starten und Dashboard → Bibliotheken → Alle Bibliotheken scannen auszuführen. Der offizielle Jellyfin-Leitfaden zu Bibliotheken dokumentiert, wo Bibliotheken im Server-Dashboard verwaltet werden.

Vor Änderungen oder einer Neuerstellung der Anwendung sollte die vorhandene Konfigurationssicherung aufbewahrt werden. Der Shop-Artikel zum Sichern von Jellyfin vor Wartungsarbeiten erläutert, warum der Anwendungsstatus und die Medienbibliothek als getrennte Wiederherstellungsbereiche behandelt werden sollten.

Andere Protokollzeilen waren nicht die bestätigte Ursache der Wiedergabeprobleme

Das Protokoll enthielt außerdem eine verweigerte NextPVR-Verbindung zu localhost:8866 und eine statische WebRootPath-Warnung. Diese Einträge verdienen möglicherweise eine separate Untersuchung für Live-TV oder Webressourcen, aber die fehlgeschlagenen MP3-Anfragen endeten mit ausdrücklichen Fehlern, dass die Datei nicht gefunden wurde. Der Thread stellte keinen Zusammenhang zwischen dem NextPVR-Fehler und den fehlenden Musik- und Filmdateien her.

Ebenso war dies kein Beleg dafür, dass die Hardware-Transcodierung nicht funktionierte. Das Protokoll zeigte, dass FFmpeg und mehrere Codecs verfügbar waren. Für einen tatsächlichen Transcodierungsfall ist der Leitfaden zum hardwarebeschleunigten Streaming auf ZimaOS relevant, aber eine Änderung der Beschleunigungseinstellungen würde eine fehlerhafte Docker-Einbindung nicht beheben.

Was der Thread bestätigte – und was nicht

Die Protokollbelege und die Docker-Inspektion deuteten eindeutig auf eine Abweichung bei der Pfadzuordnung hin, und die letzte Antwort lieferte eine präzise korrigierte Zuordnung. Der Thread endete jedoch, bevor MrPenguin nach Anwendung der Änderung einen abschließenden Wiedergabetest veröffentlichte. Die Seite sollte die Korrektur der Zuordnung daher als evidenzbasierte Lösung der Community beschreiben, nicht als vom ursprünglichen Autor bestätigten Erfolg.

FAQ zur Jellyfin-Wiedergabe und zu Docker-Pfaden

Warum meldete Jellyfin, dass die Medien nicht unterstützt würden, obwohl die Datei fehlte?

Der Client zeigte einen allgemeinen Wiedergabefehler an. Das Serverprotokoll nannte die konkrete Ursache: Jellyfin konnte die Quelldatei unter dem in seiner Datenbank gespeicherten Bibliothekspfad nicht finden.

Würde eine Neuinstallation von FFmpeg oder eine Änderung der Codecs diesen Fall beheben?

Nein. Das Protokoll zeigte bereits Jellyfin FFmpeg sowie zahlreiche Decoder und Encoder. Ein Codec kann keine Quelldatei verarbeiten, die im Containerpfad fehlt.

Warum konnte Jellyfin Bibliothekselemente anzeigen, die nicht mehr wiedergegeben werden konnten?

Jellyfin kann gescannte Metadaten nach einer Änderung der Einbindung in seiner Datenbank behalten. Das Element bleibt sichtbar, aber die Wiedergabe schlägt fehl, wenn Jellyfin versucht, den alten Dateisystempfad zu öffnen.

Sollte der übergeordnete Media-Ordner eingebunden werden?

Für die in diesem Thread gezeigte Ordnerstruktur: ja. Durch die Zuordnung des übergeordneten Ordners auf dem Host Media Verzeichnis zum Containerpfad /Media behält die von den vorhandenen Bibliotheken erwarteten Unterverzeichnisse „Music“, „Movies“ und „TV Shows“ bei.

Bestätigte der ursprüngliche Autor, dass die Wiedergabe danach funktionierte?

Im sichtbaren Thread erscheint keine abschließende Bestätigung. Die letzte Antwort stellte die Abweichung fest und lieferte die korrigierte Zuordnung sowie die Schritte zum erneuten Scannen.