Een mediaserver kan een ongewijzigde bibliotheek opnieuw scannen nadat een netwerkshare opnieuw is aangekoppeld, wanneer de opslag kortstondig verdwijnt of terugkomt met een bestandssysteemweergave die de scanner als gewijzigd beschouwt.
Dit is specifieker dan een normale scan bij het opstarten. Laat het mediaserverproces indien veilig actief, koppel dezelfde SMB- of NFS-share bewust opnieuw aan en leg vast wat de server vóór, tijdens en na de overgang ziet. De belangrijke grens is of het bibliotheekpad leeg, ontoegankelijk of opnieuw aangekoppeld wordt, of een ander wijzigingssignaal genereert, terwijl de mediabestanden zelf ongewijzigd zijn.
Bewijs dat de nieuwe scan volgt op het opnieuw aankoppelen van de share
Schakel niet-gerelateerde geplande scans tijdelijk uit en leg het logboek van de bibliotheekscan vast terwijl je tijdens een onderhoudsvenster één testshare ontkoppelt en opnieuw aankoppelt. Vergelijk de scantrigger met een normale herstart van de server waarbij de share nooit verdwijnt.
Jellyfin waarschuwt dat niet-beschikbare opslag items kan verwijderen als gepland onderhoud wordt uitgevoerd terwijl externe media ontbreken.
Begint de nieuwe scan pas na de overgang van de share, beperk de diagnose dan tot de zichtbaarheid van de opslag en scannergebeurtenissen. Scant de server opnieuw zonder enige wijziging in de aankoppeling, kijk dan opnieuw naar geplande taken of een permanente databasestatus.
Houd het bibliotheekpad aanwezig tijdens het opnieuw aankoppelen
Controleer het aankoppelpunt op de host vóór, tijdens en nadat de externe share opnieuw verbinding maakt. Een lege gewone map op hetzelfde pad kan gevaarlijker zijn dan een expliciete fout bij het aankoppelen, omdat de mediaserver deze kan interpreteren als een geldige maar lege bibliotheek.
Een actuele probleemoplossingsgids voor Jellyfin laat zien hoe fouten bij het aankoppelen bibliotheken leeg kunnen maken en grote corrigerende scans kunnen activeren.
Gebruik bij voorkeur een aankoppelstrategie die duidelijk faalt in plaats van een lege terugvalmap beschikbaar te stellen. Controleer de weergave op de host voordat je de mediaservercontainer of -service opnieuw toegang tot het pad geeft.
Scheid netwerkbestandssystemen van lokale wijzigingsmeldingen
Controleer of de server gebruikmaakt van bestandssysteemwatchers, periodieke scans, callbacks van de applicatie of een externe mediamanager. Externe aankoppelingen leveren niet altijd dezelfde lokale wijzigingsmeldingen als rechtstreeks aangesloten bestandssystemen.
Plex documenteert dat netwerkshares geen wijzigingstriggers hebben en daarom periodieke of expliciete scans kunnen vereisen.
Schakel niet zowel frequente periodieke scans als brede externe vernieuwingshooks in als tijdelijke oplossing. Kies één betrouwbare meldingsstrategie, zodat het opnieuw aankoppelen niet leidt tot meerdere overlappende scans van de volledige bibliotheek.
Maak de opslag beschikbaar voordat containers opnieuw verbinding maken
Als de mediaserver in Docker draait, vergelijk dan het tijdstip waarop de externe aankoppeling gereed is met het start- of herstarttijdstip van de container. Een container kan het aankoppelpunt op de host koppelen terwijl dit nog een lege lokale map is, en later de NAS daaronder zien verschijnen.
Een Linux-gids voor homeservers laat zien dat de opslag vóór Docker moet worden aangekoppeld wanneer applicaties afhankelijk zijn van externe opslag.
Gebruik een begrensde afhankelijkheid voor de aankoppeling of een gereedheidscontrole in plaats van een lange vaste wachttijd. De mediaserver moet starten met de echte bibliotheek beschikbaar, of duidelijk genoeg falen om geen lege placeholder te kunnen indexeren.
Verwacht niet dat Inotify elke NAS-wijziging beschrijft
Op Linux is automatische mediadetectie vaak gebaseerd op lokale bestandssysteemgebeurtenissen. Controleer of het rechtstreeks toevoegen van een bestand op de NAS een watcher-gebeurtenis op de mediaserverhost genereert en of het opnieuw aankoppelen bredere signalen voor mapwijzigingen veroorzaakt.
Een gids voor het automatisch aankoppelen van een homeserver legt uit dat Inotify wijzigingen in netwerkbestandssystemen mist en waar nodig expliciete meldingen aan de applicatie aanbeveelt.
Als het gedrag van watchers onbetrouwbaar is, gebruik dan de mediamanager of server-API om een gerichte scan voor nieuw toegevoegde inhoud aan te vragen, in plaats van de server de volledige ongewijzigde bibliotheek opnieuw te laten ontdekken.
Controleer één gecontroleerde nieuwe aankoppeling zonder volledige scan
Na het corrigeren van de zichtbaarheid van de aankoppeling, de opstartvolgorde of de scantriggers, koppel je de share tweemaal opnieuw aan terwijl je de bibliotheekdatabase, het aantal items en het scanlogboek controleert. Voeg daarna één testbestand toe om te bevestigen dat legitiem nieuwe media nog steeds wordt gedetecteerd.
Een vergelijking voor home-media merkt op dat NAS-protocollen het gedrag van de aankoppeling veranderen, in plaats van dat de mediaserver het externe bestandssysteem rechtstreeks beheert.
De oplossing is voltooid wanneer de ongewijzigde bibliotheek een nieuwe aankoppeling overleeft zonder volledige scan en een nieuw bestand nog steeds verschijnt via de gekozen updatemethode. Het gerelateerde ZimaSpace-artikel over nieuwe Jellyfin-scans na herstart blijft de juiste route wanneer het symptoom alleen optreedt na een herstart van de host.
Ondersteuning & Tips
Meer om te lezen

Kan Plex een GPU delen met een andere Docker-container?
Plex en een andere container kunnen vaak dezelfde GPU gebruiken, maar je moet de driverondersteuning, apparaattoewijzing, belasting van de video-engine, het geheugengebruik en het...

Hoe je kunt bepalen of een Plex-fout door de client of de server wordt veroorzaakt
Reproduceer hetzelfde item op een andere client, vergelijk het sessiepad en verzamel pas serverbewijs nadat de scope heeft uitgewezen waar de fout daadwerkelijk zit.

Plex-cache en tijdelijke opslag voor transcodering configureren
Bescherm de permanente Plex-status door tijdelijke transcodebestanden op geschikte lokale opslag te plaatsen en controleer vervolgens het opruimen, de beschikbare ruimte en het gedrag...

