Als Plex start maar achtergrondwerkers offline blijven, controleer dan workerfouten, schrijfrechten voor app-gegevens, beschikbare opslagruimte en afhankelijkheidspaden voordat je iets opnieuw installeert.
De webinterface bewijst alleen dat de hoofdservice bereikbaar is. Scan-, metadata-, transcodeer- of onderhoudstaken kunnen afzonderlijk mislukken omdat een hulpproces niet kan schrijven, een tijdelijk pad vol is of een gekoppelde afhankelijkheid is gewijzigd. Begin met de kleinste mislukte taak en traceer het exacte proces en pad, in plaats van de hele host steeds opnieuw te starten.
Identificeer welke worker of taak daadwerkelijk mislukt
Achtergrondtaken vormen geen enkel subsysteem, dus “workers offline” vereist een concrete mislukte actie. Een scanfout, fout in een transcodeerhulp en fout bij databaseonderhoud wijzen op verschillende resources.
expliciete Docker-volumekoppelingen maken het mogelijk om padzichtbaarheid en schrijfeigenaarschap tussen services afzonderlijk te controleren.
Start één bekende mislukte bewerking en leg de Plex-logregels en activiteit van childprocessen voor dat tijdvenster vast. Als de hoofdservice gezond is maar één hulpproces afsluit, beperk dan de volgende test tot die helper en diens afhankelijkheden.
Controleer of app-gegevens- en tijdelijke paden schrijfbaar zijn
Workers moeten vaak database-, metadata-, cache- of tijdelijke bestanden aanmaken, zelfs wanneer het webproces bestaande gegevens kan lezen. Een alleen-lezenkoppeling of een koppeling met onjuiste rechten kan achtergrondtaken daarom laten mislukken zonder het hoofdproces te stoppen.
UID- en GID-koppeling van containers koppelt de service-identiteit aan numeriek eigenaarschap van het hostbestandssysteem bij bind mounts.
Voer als de Plex-service-identiteit een tijdelijke schrijftest uit op de app-gegevens- en transcodeerpaden die door de mislukte taak worden gebruikt. Als de schrijftest mislukt, herstel dan eerst de koppelmodus of het eigenaarschap voordat je de Plex-configuratie wijzigt. Achtergrondwerkers zijn eenvoudiger te herstellen wanneer hun vereiste paden gebruikmaken van gedocumenteerde permanente containeropslag in plaats van willekeurige bind mounts.
Controleer vrije ruimte en I/O-fouten
Een bijna vol bestandssysteem of een defect opslagpad kan ervoor zorgen dat bestaande pagina’s laden terwijl nieuwe uitvoer van workers mislukt. Dit is vooral relevant voor transcodeer-, voorbeeld- en metadatataken die tijdelijke of groeiende bestanden aanmaken.
controles op resourceverzadiging houden de diagnose gericht op daadwerkelijke beperkingen in plaats van op één benuttingspercentage.
Controleer de vrije ruimte op het bestandssysteem, de beschikbaarheid van inodes, I/O-fouten in de kernel en de apparaatlatentie terwijl je de workerfout reproduceert. Als er fouten of uitgeputte ruimte optreden, los dan eerst het opslagprobleem op voordat je de taak opnieuw probeert.
Maak de worker pas opnieuw aan nadat de afhankelijkheden zijn geslaagd
Plex opnieuw installeren kan de oorspronkelijke oorzaak verhullen terwijl koppelingen of machtigingen ongewijzigd blijven. Een schone herstart is alleen nuttig nadat is vastgesteld dat het bestandssysteem en de afhankelijkheden goed functioneren.
planning van containerupdates moet permanente gegevens beschermen, terugdraaien mogelijk maken en het resultaat valideren.
Start de container opnieuw of probeer de taak opnieuw met dezelfde image nadat je de bewezen afhankelijkheid hebt hersteld en voer vervolgens één rooktest uit. Als de helper nog steeds faalt met correcte paden en zonder resourcefout, verzamel dan het exacte log en vergelijk dit met een bekende goede versie voordat je het probleem escaleert.
Ondersteuning & Tips
Meer om te lezen

Opslaghandleiding voor live-tv-opnamen voor capaciteit, bewaartermijn en opruimen
Meet echte opnamen, houd hoofdruimte vrij, combineer limieten voor leeftijd en capaciteit en toon aan dat het oudste in aanmerking komende programma wordt verwijderd...

Workflow voor herstel van metadata van thuismedia na het terugzetten van een database
Bescherm de herstelde status, controleer de identiteit en paden van de media en herstel vervolgens ontbrekende artwork of overeenkomsten in een proeff bibliotheek voordat...

Compatibiliteitschecklist voor Jellyfin-clients voor audio, video en ondertiteling
Test representatieve bestanden één variabele tegelijk en noteer voor elke client Direct Play, remux, audioconversie, videotranscodering of fout.

