Waarom vult het genereren van miniaturen de appopslag van een mediaserver?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Het genereren van miniaturen vult de appopslag, omdat de server veel afgeleide afbeeldingen aanmaakt en opslaat in een beschrijfbaar metadatapad of cachepad.

Een mediabibliotheek kan video's van meerdere terabytes op een HDD-pool bewaren, terwijl de container de configuratie, metadata en cache koppelt aan een veel kleinere SSD of opstartschijf. Hoofdstukafbeeldingen, Trickplay-previews, posters, achtergronden en tijdelijke extractiebestanden groeien dan mee met de speelduur in de bibliotheek en de generatie-instellingen, en niet alleen met de grootte van de bronbestanden. De veilige oplossing begint met het vaststellen van het exacte afgeleide bestandstype en pad voordat je iets verwijdert wat de database nog verwacht.

Zoek de map die daadwerkelijk groeit

Meet de configuratie-, cache-, metadata-, transcodeer- en tijdelijke mappen van de media-app afzonderlijk. Sorteer submappen op toegewezen grootte en recente wijzigingstijd terwijl een miniaturentaak actief is.

De interfaceberichten van Jellyfin beschrijven het extraheren van hoofdstukafbeeldingen uitdrukkelijk als langzaam, belastend voor systeembronnen en mogelijk als iets waarvoor meerdere gigabytes aan ruimte nodig zijn.

Controleer of de groei plaatsvindt in de bind mount van de host, een benoemd volume of de schrijfbare containerlaag. Als de containerlaag groeit, zorg dan eerst voor correcte persistentie voordat je opruimt; anders kan de ruimte uit de appweergave verdwijnen terwijl die nog steeds de systeemopslag van Docker in beslag neemt.

Achterhalen welke afbeeldingsfunctie de bestanden heeft aangemaakt

Houd gewone posters en achtergronden gescheiden van hoofdstukafbeeldingen, Trickplay-previews, videovoorbeeldminiaturen, intromarkeringen en door plug-ins gegenereerde illustraties. Elke functie heeft een andere trigger en bewaartermijn.

Trickplay maakt herhaaldelijk visuele momentopnamen van een videotijdlijn, zodat clients tijdens het zoeken previews kunnen tonen. De resulterende afbeeldingsrasters zijn vooral afhankelijk van de totale speelduur, het bemonsteringsinterval, de resolutie, de kwaliteit en de tegelindeling, en niet zozeer van de vraag of de bron 1080p of 4K is.

Voer één geplande taak handmatig uit terwijl je de doelmap in de gaten houdt. Koppel nieuwe bestandsnamen en databasevermeldingen aan de functie die ze heeft aangemaakt. Schakel niet alle metadataproviders uit als slechts één previewtaak verantwoordelijk is.

Interval voor controles, resolutie, kwaliteit en bibliotheekomvang

Noteer de miniatuurbreedte, bemonsteringsinterval, JPEG- of WebP-kwaliteit, tegelafmetingen, het aantal threads en de bibliotheken die bij het genereren zijn inbegrepen. Kortere intervallen en grotere afbeeldingen zorgen voor meer opgeslagen pixels per uur video.

Na een instellingswijziging of upgrade kan het genereren ook opnieuw starten. Een Jellyfin-probleem beschrijft gebruikers die niet konden voorkomen dat eerder gegenereerde trickplay-gegevens terugkeerden, omdat het uitschakelen van de functie de bestaande uitvoer niet opruimde.

Wijzig één instelling in een kleine testbibliotheek en vergelijk het aantal gegenereerde bytes per uur media. Gebruik die gemeten verhouding om de volledige bibliotheek te schatten voordat je een nieuwe volledige extractietaak start.

Instellingswijziging Verwacht effect op opslagruimte Afweging
Langere bemonsteringsinterval Minder afbeeldingen Minder nauwkeurige zoekpreviews
Lagere miniatuurbreedte Kleinere bestanden Vagere tv-previewafbeeldingen
Lagere beeldkwaliteit Kleinere bestanden Meer compressieartefacten
Beperk de bibliotheekscope Minder totale opslagruimte Geen previews voor uitgesloten bibliotheken

Kies instellingen die passen bij de werkelijke clientschermen en het zoekgedrag, in plaats van voor elke titel afgeleiden van de hoogste kwaliteit te genereren.

Zoek naar verouderde of verweesde miniatuursets

Vergelijk actieve media-items met gegenereerde directories nadat bestanden zijn vervangen, hernoemd, verplaatst of verwijderd. Oude previews kunnen achterblijven wanneer het nieuwe bestand een andere item-ID of uitvoernaam krijgt.

Een Jellyfin-melding laat zien dat verouderde trickplay-afbeeldingen naast media niet werden verwijderd toen vervangende previews werden gegenereerd, waardoor verouderde trickplay-gegevens naast de huidige set achterbleven.

Gebruik eerst de ondersteunde opschoontaak van de applicatie en controleer of er een back-up van de metadatadatabase is. Als handmatige verwijdering nodig is, test dan één verweesd item en vernieuw het voordat je grote directorystructuren verwijdert waarvan de verwijzingen onbekend zijn.

Controleer of afbeeldingen in de app-opslag of naast de media thuishoren

Sommige mediaservers kunnen illustraties of trickplay-gegevens naast de bibliotheek opslaan, terwijl andere databasegekoppelde afgeleiden in de metadata van de app bewaren. Een wijziging van de locatie heeft gevolgen voor back-ups, machtigingen, migratie en het gedrag van alleen-lezen media.

Previews naast mediabestanden opslaan kan migratie vergemakkelijken, maar kan ook het aantal kleine bestanden op een grote HDD-share vermenigvuldigen en schrijftoegang tot de bibliotheek vereisen. In een Jellyfin-migratie-issue blijkt dat lokaal opgeslagen trickplay-bestanden mogelijk niet probleemloos worden overgezet tussen instanties.

Houd databasegebonden en vaak gewijzigde afgeleide bestanden op een appvolume met voldoende ruimte, tenzij de applicatie draagbare lokale afbeeldingen volledig ondersteunt. Houd de mediashare alleen-lezen als schrijftoegang voor de gekozen inrichting niet nodig is.

Verplaats het appvolume zonder de databasegegevens op te splitsen

Als de instellingen redelijk zijn maar het appvolume te klein is, stop dan de mediaserver en verplaats de volledige configuratie, metadata en cache volgens de persistente mountstructuur van de container. Behoud de eigendom, ACL's, databasebestanden en symbolische koppelingen.

Het artikel van ZimaSpace over SSD-appvolumes voor metadata en miniaturen legt uit waarom deze werklasten met kleine bestanden baat hebben bij snelle opslag, terwijl grote bronmediabestanden op HDD's kunnen blijven staan.

Verplaats niet alleen de grootste afbeeldingsmap terwijl de databasepaden achterblijven, tenzij de applicatie die opsplitsing ondersteunt. Start de gemigreerde instantie geïsoleerd op en controleer of oude miniaturen worden gevonden voordat je nieuwe genereert.

Ruim veilig op en stel een basislijn voor groei vast

Pauzeer de taken voor miniaturen, maak een back-up van de applicatiedatabase en noteer het huidige aantal bestanden en het aantal bytes per afgeleid bestandstype. Verwijder alleen bevestigde verouderde uitvoer of gebruik de ondersteunde verwijderings- en regeneratiefuncties van de applicatie.

Een volle SSD kan meer dan alleen miniaturen beïnvloeden. In een Jellyfin-issue wordt een uitgeputte SSD in verband gebracht met vermoedelijke databaseschade en een onvolledig bibliotheekoverzicht. Dit laat zien waarom een gebrek aan vrije ruimte de appstatus in gevaar kan brengen.

Voer na het opruimen de generatie uit voor één bibliotheek, meet de dagelijkse groei en stel waarschuwingen in voordat het appvolume de reservedrempel bereikt. De reparatie is voltooid wanneer de verwachte previews werken, verouderde gegevens niet meer terugkomen en de opslaggroei overeenkomt met het gekozen interval, de resolutie, de kwaliteit en de bibliotheekomvang.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.