Wanneer Jellyfin vóór een herstart werkt maar het afspelen daarna niet meer, controleer dan eerst de afhankelijkheden die tijdens het opstarten opnieuw beschikbaar moesten komen voordat je de bibliotheek wijzigt.
De herstart kan de timing van mountpunten, apparaattoewijzingen van containers, machtigingen, DNS of de volgorde waarin services beschikbaar komen wijzigen. Een gezond Jellyfin-proces bewijst niet dat het mediapad of de GPU bruikbaar is. Vergelijk de omgeving na het opstarten met de werkende uitgangssituatie en herstel de eerste ontbrekende afhankelijkheid.
Controleer of het mediapad echt is aangekoppeld
Een map kan bestaan, ook wanneer de NAS of schijf die deze normaal gebruikt niet is aangekoppeld. Jellyfin kan dan een leeg lokaal pad zien en ontbrekende media melden in plaats van een duidelijke mountfout.
Controle van mountpunten voordat services starten voorkomt dat toepassingen naar een leeg mountpunt schrijven of dit scannen.
Bevestig de identiteit van het bestandssysteem met `findmnt` of het equivalent op jouw platform en lees vervolgens een bekend mediabestand als de Jellyfin-servicegebruiker. Start pas daarna opnieuw een scan.
Controleer het eigendom van app-gegevens nadat de runtime terug is
Het opnieuw aanmaken van containers of wijzigingen op de host kunnen de numerieke gebruiker wijzigen die toegang heeft tot de persistente configuratie. Alleen leestoegang is niet voldoende, omdat Jellyfin ook de database- en configuratiestatus moet kunnen bijwerken.
Services in containers blijven voorspelbaar wanneer de UID- en GID-toewijzing overeenkomt met het bestandseigendom op alle bind mounts.
Voer in de bovenliggende map van de app-gegevens een tijdelijke test uit waarbij je als de service-identiteit een bestand aanmaakt en verwijdert. Het persistente pad voor app-gegevens moet een vervanging van de runtime overleven zonder een reparatie van het eigendom in de hele mapstructuur.
Controleer of hardwareapparaten opnieuw beschikbaar zijn
Een transcodering die vóór de herstart de iGPU gebruikte, kan terugvallen op de CPU of mislukken wanneer `/dev/dri` of een andere toewijzing van een accelerator ontbreekt. Direct Play kan nog steeds werken, waardoor de storing mediaspecifiek lijkt.
Een mislukte apparaattoewijzing kan hetzelfde afspelen van hardwarematig naar softwarematig werk verplaatsen; een benchmark voor Jellyfin-transcodering laat zien hoe sterk de CPU- en GPU-belasting verandert tussen hardwareversnelde en gefilterde paden.
Speel één bekende hardwaretranscoderingstest af en controleer het actieve proces en de apparaattoewijzing. Herstel de toegang tot apparaten in de runtime voordat je de kwaliteit verlaagt of codecs wijzigt.
Test het netwerkpad pas opnieuw nadat lokaal afspelen werkt
Externe DNS-, VPN- of proxyservices kunnen later dan Jellyfin beschikbaar komen en een storing veroorzaken die alleen op afstand optreedt. Behandel lokale media en externe bereikbaarheid als afzonderlijke acceptatietests.
De netwerkcapaciteit moet aan de daadwerkelijke leveringsrand worden gecontroleerd; een bandbreedtemodel voor streaming maakt onderscheid tussen LAN-, wifi-, NAS- en externe uploadlimieten, in plaats van elke storing bij het afspelen als een probleem met de servercapaciteit te beschouwen.
Controleer eerst een lokale bekabelde client en daarna één externe client. Als lokaal afspelen goed werkt, beperk de resterende reparatie dan tot de configuratie van routing, DNS, proxy of tunnel, in plaats van de serverstatus opnieuw op te bouwen.
Ondersteuning & Tips
Meer om te lezen

Moet je een live back-up van Jellyfin maken of de service eerst stoppen?
Geef de voorkeur aan back-ups van gestopte services voor eenvoud; gebruik live snapshots alleen wanneer de applicatiestatus consistent wordt vastgelegd en herstelprocedures zijn getest.

Waarom draait Jellyfin zo warm of luidruchtig als niemand streamt?
Hittesterkte tijdens inactiviteit wijst meestal op achtergrondwerk of een belasting door gedeelde hosting. Identificeer daarom het actieve proces en de geplande taak voordat je...

Wanneer moet je Jellyfin opnieuw opbouwen in plaats van repareren?
Kies voor opnieuw opbouwen in plaats van repareren wanneer runtime-drift het probleem is en de persistente status is geback-upt; verwijder de enige goede database...

