Lokale metadatabestanden instellen zonder ongewenste herschrijvingen toe te staan

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Lokale NFO-bestanden en illustraties maken een mediabibliotheek draagbaar, maar dezelfde server die ze leest, kan ook titels, afbeeldingen of identificatiegegevens vervangen. Een alleen-lezen koppeling van de media voorkomt onbedoelde schrijfbewerkingen, maar verandert waar de server gedownloade sidecarbestanden kan opslaan.

Kies voor elk metadata­veld één gezaghebbende bron voordat je de machtigingen wijzigt. Maak back-ups of versiebeheer van de zorgvuldig samengestelde sidecarbestanden, houd de serverdatabasestatus schrijfbaar en voer een vernieuwingstest uit om te controleren of de server de bronbestanden leest zonder ze te herschrijven. Herhaal die test na upgrades en elke vernieuwing van metadata voor de hele bibliotheek.

Bepaal welke metadatabron leidend is

Noteer welke velden je lokaal beheert: titel, sorteertitel, editie, datum, personen, provider-ID's, poster en achtergrondafbeelding. Als lokale bestanden leidend zijn, schakel dan providerupdates uit of beperk ze, zodat die velden niet tijdens een vernieuwing worden overschreven.

Bekijk het gedrag van Jellyfin NFO-velden voor de geïnstalleerde serverfamilie voordat je een bestandsnaamgevingsschema kiest. De ondersteuning verschilt per bibliotheektype, en een bestandsnaam die voor de hand lijkt te liggen, is mogelijk niet het bestand dat de scanner leest.

Houd een kleine voorbeeldmap buiten de productiebibliotheek. Die moet één film of aflevering, het NFO-bestand en geselecteerd beeldmateriaal bevatten, zodat scan- en vernieuwingsgedrag kan worden getest zonder duizenden zorgvuldig samengestelde bestanden in gevaar te brengen.

Scheid alleen-lezen media van schrijfbare serverstatus

Koppel de mediaboomstructuur in de container alleen-lezen, terwijl de configuratie-, cache- en databasepaden schrijfbaar blijven. Een containeroptie zoals een alleen-lezen bindmount is robuuster dan vertrouwen op een selectievakje in de applicatie waarvan de werking per release kan veranderen.

Als de server nieuwe illustraties naast media moet downloaden, is een volledig alleen-lezen bibliotheek onverenigbaar met die werkwijze. Sla gedownloade metadata op in de applicatiestatus of gebruik een gecontroleerde stagingtaak die sidecarbestanden buiten het serverproces schrijft.

Beschouw de koppelingskaart als onderdeel van het implementatierecord. De checklist voor het upgraden van een Jellyfin-container helpt het onderscheid tussen media, metadata en toepassingsstatus te behouden wanneer de container opnieuw wordt aangemaakt.

Schakel terugschrijfpaden uit die conflicteren met beheer

Schakel opties uit die illustraties of NFO-metadata opslaan in mediamappen wanneer die mappen extern worden beheerd. Controleer ook de instellingen voor het opslaan van metadata per bibliotheek; een globale instelling is mogelijk niet de enige plek waar schrijven wordt ingeschakeld.

Maak niet het volledige bestandssysteem van de container alleen-lezen als vervanging voor correct ingestelde koppelingen, tenzij elk vereist schrijfbaar pad expliciet is opgegeven. Databases, logboeken, plug-ins en tijdelijke bestanden hebben nog steeds gecontroleerde schrijfbare locaties nodig.

Leg bestandshashes of wijzigingstijden vast voor het voorbeeld-NFO-bestand en de afbeeldingen, voer een bibliotheekscan uit, bewerk een titel in de gebruikersinterface en voer een metadatavernieuwing uit. De bestanden moeten ongewijzigd blijven terwijl de toepassing toegestane lokale status in de database opslaat.

Single board computer zimaboard2

Controleer het herstel- en upgradegedrag

Exporteer of maak afzonderlijk een back-up van de samengestelde sidecarbestanden, los van de database van de mediaserver. De sidecarbestanden herstellen de presentatiemetadata; de database kan nog steeds de kijkstatus, gebruikers, collecties en andere informatie bevatten die niet in lokale bestanden is opgenomen.

Maak de container opnieuw aan in een testvenster en controleer of de alleen-lezen-koppelingsvlag het implementatieproces overleeft. Scan daarna de voorbeeldmap en vergelijk de hashes opnieuw, omdat een upgrade een nieuwe metadatabewerker kan introduceren of een standaardinstelling kan wijzigen.

De uiteindelijke stopregel is eenvoudig: als voor een vernieuwing schrijftoegang nodig is om het beoogde resultaat te behouden, is het ontwerp van de bron van waarheid nog niet opgelost. Zet het voorbeeld terug, houd productie alleen-lezen en bepaal of de server of de externe curator eigenaar is van dat veld.

Ondersteuning en 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.