Een mediaserver niet opnieuw een ongewijzigde bibliotheek laten scannen na het opnieuw koppelen van een netwerkshare

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

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

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.