Waarom mist een mediascan films op een gekoppelde share?

Een mediascan mist films wanneer de server het gekoppelde pad niet kan doorlopen, een ander pad ziet of de bestanden tijdens de identificatie afwijst.

Op een thuis-NAS kan “de share is gekoppeld” alleen betekenen dat de shell van de host een map kan zien. Het mediaserverproces kan zich in Docker bevinden, een ander bindpad gebruiken, onder een andere UID draaien of een lege lokale koppellocatie scannen die is achtergebleven nadat de externe share de verbinding verloor. Stel de oorzaak van één ontbrekende film vast, van opslag tot applicatie, in plaats van herhaaldelijk volledige scans te starten die problemen met paden, rechten, naamgeving of parseren niet kunnen herstellen.

Bewijs dat de gekoppelde share de film nu bevat

Controleer vanaf de host het exacte bronpad van de bibliotheek en vermeld één ontbrekende film met de volledige bestandsnaam. Bevestig het bestandssysteemtype, de bron van de koppeling, de koppelopties, de vrije ruimte en een bekend aantal bestanden, in plaats van er alleen op te vertrouwen dat de map van het koppelpunt bestaat.

Een verbroken netwerkshare kan een gewone lege map op hetzelfde koppelpunt achterlaten, waardoor een scan wordt voltooid zonder media te vinden. Een Jellyfin-rapport beschrijft een scan die succesvol leek, hoewel het doel naar nul items verwees.

Lees een klein deel van het ontbrekende bestand en vermeld de bovenliggende mappen. Als de share ontbreekt, herstel de koppeling dan voordat je scant en configureer de mediaservice zo dat deze pas start wanneer het externe bestandssysteem beschikbaar is. Voeg het lege lokale koppelpunt niet toe als tweede bibliotheekpad.

Controleer het pad vanuit de mediaservercontainer

Ga naar de actieve container en controleer het exacte pad dat in de bibliotheek is geconfigureerd. De host kan /mnt/media/movies gebruiken, terwijl de container dit ziet als /media/movies; alleen het pad aan de containerzijde hoort in de applicatie te staan.

Nieuwe media kunnen onzichtbaar blijven, zelfs wanneer oudere items nog afspelen, als de actieve container het huidige hostpad niet meer ziet of verouderde koppelinhoud ontvangt. In een Jellyfin-geval werd gemeld dat nieuwe media niet verschenen na herhaalde scans.

Vergelijk de containerdefinitie met de effectieve koppeling die door de runtime wordt weergegeven. Controleer of de bindbron de daadwerkelijk gekoppelde share is, en niet een bovenliggende map of verouderd pad. Maak de container pas opnieuw aan nadat je hebt bevestigd dat de persistente configuratie en databasekoppelingen ongewijzigd zijn.

Test het doorlopen van mappen als de daadwerkelijke servicegebruiker

Gebruik de UID en GID van de mediaserver om elke map van de bibliotheekroot tot aan het filmbestand te vermelden. Het bestand kunnen lezen is niet voldoende; het proces heeft ook uitvoerrechten op elke bovenliggende map nodig om het pad te kunnen doorlopen.

Een probleem met de zichtbaarheid van een Jellyfin-bibliotheek noemt ontbrekende lees- en directory-uitvoerrechten als directe oorzaak van items die niet verschijnen. De belangrijke grens is toestemming om mappen te doorlopen, niet of een beheerdersaccount de share kan openen.

Herstel de meest beperkte eigendoms-, groeps- of ACL-regel die de service alleen-lezen toegang tot de media geeft. De ZimaSpace-gids over rechten na het verplaatsen van bestanden biedt de bijbehorende werkwijze wanneer de share via SMB werkt maar niet binnen de container.

Featured

ZimaCube 2 Persoonlijke Cloud Home NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

Vergelijk één ontbrekende film met één gedetecteerde film

Kies twee mappen onder dezelfde gekoppelde share: één film die de bibliotheek detecteert en één die wordt gemist. Vergelijk bestandsnaam, extensie, mapdiepte, hoofdlettergebruik, speciale tekens, bestandsgrootte, het gebruik van symbolische koppelingen, rechten, tijdstempels en of het bestand volledig is.

Sommige scanfouten zijn specifiek voor een item en niet voor de hele share. In een gemeld Jellyfin-geval verschenen films pas nadat ze naar een andere map waren verplaatst. Dit laat zien waarom een gecontroleerde vergelijking tussen een gedetecteerd en een ontbrekend item nuttiger is dan nog een algemene herscan.

Hernoem of verplaats slechts één gekopieerd testitem naar een eenvoudige structuur, zoals Movies/Movie Name (Year)/Movie Name (Year).mkv. Als de kopie verschijnt, controleer dan de naamgeving, verborgen markeringen, rechten of het gedrag van het bestandssysteem van de oorspronkelijke map voordat je de hele bibliotheek aanpast.

Lees het scanlogboek bij het eerste ontbrekende pad

Start een gerichte scan en volg het logboek vanaf het moment waarop de scanner de betreffende map binnengaat. Zoek naar toegang geweigerd, map niet gevonden, I/O-fouten, niet-ondersteunde bestanden, probe-fouten, databasebeperkingen, fouten bij metadataproviders en geannuleerde scans.

Een volledige scan kan stoppen of werk overslaan na een uitzondering op padniveau, terwijl de gebruikersinterface alleen een onvolledige bibliotheek toont. Jellyfin heeft scans gedocumenteerd die werden beïnvloed door een uitzondering door een ontbrekende map. Daardoor is de eerste fout belangrijker dan de uiteindelijke voortgangsindicator.

Herstel de vroegste reproduceerbare fout en voer de kleinst mogelijke scan opnieuw uit. Verwijder de bibliotheekdatabase, metadata of cache niet voordat de zichtbaarheid van het pad en de rechten zijn bewezen; destructieve resets kunnen diagnostisch bewijs verwijderen zonder de gekoppelde share te herstellen.

Controleer de oplossing met een gecontroleerde import en herstart

Voeg één testfilm met een duidelijke naam toe aan dezelfde share, scan de betreffende bibliotheek en controleer of de film één keer verschijnt met het juiste pad en de juiste metadata. Start daarna de container opnieuw op en herstart de host.

Controleer na het opnieuw opstarten of de externe share vóór de mediaservice wordt gekoppeld, de container het gevulde pad ziet, de servicegebruiker het pad kan doorlopen en de scanner een nieuw toegevoegd testbestand detecteert zonder handmatige wijzigingen aan de rechten.

De reparatie is pas voltooid wanneer de werkelijk ontbrekende films vanaf hun bedoelde gekoppelde locatie verschijnen, er geen lege fallbackmap wordt gescand en het resultaat behouden blijft na het opnieuw koppelen, het opnieuw aanmaken van de container en het herstarten van de host. Verwijder de testkopie nadat je hebt bevestigd dat het oorspronkelijke bibliotheekpad stabiel is.