Die Thumbnail-Generierung füllt den App-Speicher, weil der Server zahlreiche abgeleitete Bilder erstellt und in einem beschreibbaren Metadaten- oder Cache-Pfad speichert.
Eine Medienbibliothek kann Videos mit mehreren Terabyte auf einem HDD-Pool speichern, während der Container Konfiguration, Metadaten und Cache auf eine deutlich kleinere SSD oder ein Boot-Laufwerk abbildet. Kapitelbilder, Trickplay-Vorschauen, Poster, Hintergrundbilder und temporäre Extraktionsdateien wachsen dann mit der Laufzeit der Bibliothek und den Generierungseinstellungen – und nicht allein mit der Größe der Quelldateien. Die sichere Lösung beginnt damit, den genauen Typ und Pfad der abgeleiteten Dateien zu ermitteln, bevor Daten gelöscht werden, die die Datenbank noch erwartet.
Das tatsächlich wachsende Verzeichnis finden
Erfassen Sie die Konfigurations-, Cache-, Metadaten-, Transkodierungs- und temporären Verzeichnisse der Medienanwendung getrennt. Sortieren Sie Unterverzeichnisse während eines laufenden Thumbnail-Auftrags nach belegter Größe und dem Zeitpunkt der letzten Änderung.
Die Extraktion von Kapitelbildern wird in den Benutzeroberflächentexten von Jellyfin ausdrücklich als langsam und ressourcenintensiv beschrieben und kann mehrere Gigabyte Speicherplatz erfordern.
Prüfen Sie, ob das Wachstum im Host-Bind-Mount, in einem benannten Volume oder in der beschreibbaren Containerebene stattfindet. Wächst die Containerebene, korrigieren Sie zuerst die Persistenz und führen Sie erst danach eine Bereinigung durch. Andernfalls kann der Speicherplatz zwar aus der App-Ansicht verschwinden, weiterhin aber Docker-Speicher belegen.
Ermitteln, welche Bildfunktion die Dateien erstellt hat
Trennen Sie gewöhnliche Poster und Hintergrundbilder von Kapitelbildern, Trickplay-Vorschauen, Video-Preview-Thumbnails, Intro-Markierungen und von Plugins erzeugten Grafiken. Jede Funktion hat einen eigenen Auslöser und eigene Aufbewahrungsregeln.
Trickplay erstellt wiederholte Bildproben entlang der Videowiedergabe, damit Clients beim Spulen Vorschauen anzeigen können. Die resultierenden Bildraster skalieren hauptsächlich mit der Gesamtlaufzeit, dem Abtastintervall, der Auflösung, der Qualität und dem Kachel-Layout – und nicht primär damit, ob die Quelle in 1080p oder 4K vorliegt.
Starten Sie eine geplante Aufgabe manuell und beobachten Sie dabei das Zielverzeichnis. Ordnen Sie neue Dateinamen und Datenbankeinträge der Funktion zu, die sie erzeugt hat. Deaktivieren Sie nicht sämtliche Metadatenanbieter, wenn nur eine einzige Vorschauaufgabe dafür verantwortlich ist.
Intervall, Auflösung, Qualität und Bibliotheksumfang prüfen
Notieren Sie Thumbnail-Breite, Abtastintervall, JPEG- oder WebP-Qualität, Kachelgröße, Thread-Anzahl und die in die Generierung einbezogenen Bibliotheken. Kürzere Intervalle und größere Bilder erzeugen mehr gespeicherte Pixel pro Videostunde.
Die Generierung kann nach einer Einstellungsänderung oder einem Upgrade auch erneut beginnen. Ein Jellyfin-Issue beschreibt Nutzer, die zuvor erzeugte Trickplay-Daten nicht daran hindern konnten, zurückzukehren, weil die Deaktivierung der Funktion die vorhandenen Ausgaben nicht bereinigte.
Ändern Sie eine Einstellung in einer kleinen Testbibliothek und vergleichen Sie die erzeugte Byte-Menge pro Medien-Stunde. Verwenden Sie dieses gemessene Verhältnis, um die vollständige Bibliothek zu schätzen, bevor Sie einen weiteren vollständigen Extraktionsauftrag starten.
| Einstellungsänderung | Wahrscheinliche Speicherwirkung | Kompromiss |
|---|---|---|
| Längeres Abtastintervall | Weniger Bilder | Weniger präzise Vorschauen beim Spulen |
| Geringere Thumbnail-Breite | Kleinere Dateien | Weichere Vorschauen auf dem Fernseher |
| Geringere Bildqualität | Kleinere Dateien | Mehr Kompressionsartefakte |
| Begrenzterer Bibliotheksumfang | Weniger Gesamtspeicher | Keine Vorschauen für ausgeschlossene Bibliotheken |
Wählen Sie Einstellungen, die zu den tatsächlich verwendeten Client-Bildschirmen und zum gewünschten Spulverhalten passen, statt für jeden Titel abgeleitete Dateien in höchster Qualität zu erzeugen.
Nach veralteten oder verwaisten Thumbnail-Sätzen suchen
Vergleichen Sie aktive Medienelemente nach dem Ersetzen, Umbenennen, Verschieben oder Entfernen von Dateien mit den erzeugten Verzeichnissen. Alte Vorschau-Sätze können zurückbleiben, wenn die neue Datei eine andere Element-ID oder einen anderen Ausgabenamen erhält.
Ein Jellyfin-Bericht zeigt, dass veraltete, neben den Medien gespeicherte Trickplay-Bilder beim Erzeugen neuer Vorschauen nicht gelöscht wurden. Dadurch blieben veraltete Trickplay-Daten neben dem aktuellen Satz bestehen.
Verwenden Sie zunächst die von der Anwendung unterstützte Bereinigungsaufgabe und prüfen Sie, ob eine Sicherungskopie der Metadaten-Datenbank vorhanden ist. Falls eine manuelle Entfernung erforderlich ist, testen Sie dies an einem verwaisten Element und aktualisieren Sie es, bevor Sie große Verzeichnisbäume löschen, deren Referenzen unbekannt sind.
Prüfen, ob die Bilder im App-Speicher oder neben den Medien liegen sollen
Einige Medienserver können Grafiken oder Trickplay-Daten neben der Bibliothek speichern, während andere datenbankgebundene abgeleitete Dateien innerhalb der App-Metadaten ablegen. Eine Änderung des Speicherorts wirkt sich auf Backups, Berechtigungen, Migrationen und das Verhalten schreibgeschützter Medien aus.
Das Speichern von Vorschauen neben den Medien kann die Portabilität bei Migrationen verbessern, aber auch viele kleine Dateien auf einer großen HDD-Freigabe erzeugen und Schreibzugriff auf die Bibliothek erfordern. Ein Jellyfin-Migrations-Issue zeigt, dass lokal gespeicherte Trickplay-Dateien möglicherweise nicht problemlos übertragen werden zwischen Instanzen.
Bewahren Sie datenbankgebundene und häufig veränderte abgeleitete Dateien auf einem bewusst dimensionierten App-Volume auf, sofern die Anwendung lokale Bilder nicht vollständig portabel unterstützt. Belassen Sie die Medienfreigabe im Nur-Lese-Modus, wenn für das gewählte Layout kein Schreibzugriff erforderlich ist.
Das App-Volume verschieben, ohne den Datenbankstatus aufzuteilen
Wenn die Einstellungen angemessen sind, das App-Volume aber zu klein dimensioniert ist, stoppen Sie den Medienserver und verschieben Sie die vollständigen Einheiten für Konfiguration, Metadaten und Cache entsprechend dem persistenten Mount-Design des Containers. Bewahren Sie Eigentümer, ACLs, Datenbankdateien und symbolische Links.
Der ZimaSpace-Artikel zu SSD-App-Volumes für Metadaten und Thumbnails erklärt, warum diese Workloads mit vielen kleinen Dateien von schnellem Speicher profitieren, während große Quelldateien auf HDDs verbleiben können.
Verschieben Sie nicht nur den größten Bilderordner und lassen Sie die Datenbankpfade zurück, sofern die Anwendung diese Aufteilung nicht unterstützt. Starten Sie die migrierte Instanz isoliert und prüfen Sie, ob alte Thumbnails aufgelöst werden, bevor Sie neue erzeugen.
Sicher bereinigen und eine Wachstumsbasis schaffen
Pausieren Sie Thumbnail-Aufgaben, sichern Sie die Anwendungsdatenbank und erfassen Sie die aktuelle Dateianzahl sowie die Byte-Menge nach Typ der abgeleiteten Dateien. Entfernen Sie nur nachweislich veraltete Ausgaben oder verwenden Sie die unterstützten Lösch- und Regenerierungsfunktionen der Anwendung.
Eine volle SSD kann mehr als nur Thumbnails beeinträchtigen. Ein Jellyfin-Issue bringt eine erschöpfte SSD mit vermuteten Datenbankschäden und einer unvollständigen Bibliotheksansicht in Verbindung und zeigt damit, warum erschöpfter freier Speicher den App-Status gefährden kann.
Führen Sie nach der Bereinigung die Generierung für eine Bibliothek aus, messen Sie das tägliche Wachstum und richten Sie Warnmeldungen ein, bevor das App-Volume seinen Reservegrenzwert erreicht. Die Reparatur ist abgeschlossen, wenn die erwarteten Vorschauen funktionieren, veraltete Daten nicht zurückkehren und das Speicherwachstum dem gewählten Intervall, der Auflösung, der Qualität und dem Bibliotheksumfang entspricht.
Support & Tipps
Mehr zum Lesen

Kann Plex eine GPU mit einem anderen Docker-Container gemeinsam nutzen?
Plex und ein weiterer Container können häufig auf dieselbe GPU zugreifen, aber du musst die Treiberunterstützung, die Gerätezuordnung, die Auslastung der Video-Engine, den Speicher...

So erkennst du, ob ein Plex-Fehler vom Client oder vom Server verursacht wird
Reproduziere dasselbe Element auf einem anderen Client, vergleiche den Sitzungspfad und sammle Serverbelege erst, nachdem der Geltungsbereich dir gezeigt hat, wo der Fehler tatsächlich...

So konfigurierst du den Plex-Cache und den temporären Transcodierungs-Speicher
Schütze den persistenten Plex-Zustand, indem du temporäre Transcodierungsdateien auf geeignetem lokalem Speicher ablegst, und überprüfe anschließend die Bereinigung, den freien Speicherplatz und das Verhalten...

