Come configurare i file di metadati locali senza consentire riscritture indesiderate

Eva Wong

IceWhale author

Eva Wong è la Technical Writer e smanettatrice residente di ZimaSpace. Una geek da sempre con una passione per homelab e software open-source, si specializza nel tradurre concetti tecnici complessi in guide accessibili e pratiche. Eva crede che l'auto-ospitare debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, dà potere alla comunità di demistificare le configurazioni hardware, dalla costruzione del loro primo NAS al dominio dei container Docker.

How to Set Up Local Metadata Files Without Allowing Unwanted Rewrites - Zima Store Online

I file NFO locali e le immagini rendono portabile una libreria multimediale, ma allo stesso server che li legge potrebbe essere consentito sostituire titoli, immagini o identificatori. Un mount dei media in sola lettura impedisce scritture accidentali, ma cambia il percorso in cui il server può archiviare i file sidecar scaricati.

Scegli un'unica fonte autorevole per ogni campo dei metadati prima di modificare i permessi. I sidecar curati dovrebbero essere sottoposti a controllo delle versioni o a backup, lo stato del database del server deve rimanere scrivibile e un test di aggiornamento dovrebbe dimostrare che il server legge senza riscrivere i file sorgente. Ripeti il test dopo gli aggiornamenti e dopo ogni aggiornamento dei metadati dell'intera libreria.

Decidi quale fonte di metadati è autorevole

Elenca i campi che curi localmente: titolo, titolo per l'ordinamento, edizione, data, persone, ID dei provider, locandina e immagine di sfondo. Se i file locali sono autorevoli, disabilita o limita gli aggiornamenti dei provider che possono sovrascrivere tali campi durante un aggiornamento.

Consulta il comportamento dei campi NFO di Jellyfin per la famiglia di server installata prima di adottare uno schema di denominazione dei file. Il supporto varia in base al tipo di libreria e un nome file apparentemente ovvio potrebbe non corrispondere al file letto dallo scanner.

Conserva una piccola directory di esempio fuori dalla libreria di produzione. Dovrebbe contenere un film o un episodio, il relativo NFO e alcune immagini selezionate, così da poter testare il comportamento di scansione e aggiornamento senza rischiare migliaia di file curati.

Separa i media in sola lettura dallo stato scrivibile del server

Monta l'albero dei media in sola lettura all'interno del container, lasciando invece scrivibili i percorsi di configurazione, cache e database. Un flag del container come un mount bind in sola lettura è più affidabile che fare affidamento su una casella dell'applicazione, il cui comportamento potrebbe cambiare tra una versione e l'altra.

Se il server deve scaricare nuove immagini accanto ai media, una libreria completamente in sola lettura è incompatibile con questo flusso di lavoro. Archivia invece i metadati scaricati nello stato dell'applicazione oppure usa un processo di staging controllato che scriva i sidecar al di fuori del processo del server.

Considera la mappa dei mount parte della documentazione del deployment. La checklist di aggiornamento del container Jellyfin aiuta a mantenere la distinzione tra media, metadati e stato dell'applicazione durante la ricreazione.

Disabilita i percorsi di riscrittura che confliggono con la curatela

Disattiva le opzioni che salvano immagini o metadati NFO nelle cartelle dei media quando queste sono curate esternamente. Controlla anche le impostazioni del salvataggio dei metadati per ogni libreria; l'impostazione globale potrebbe non essere l'unico punto che abilita le scritture.

Non rendere l'intero filesystem del container di sola lettura come sostituto di mount corretti, a meno che non vengano forniti esplicitamente tutti i percorsi scrivibili necessari. Database, log, plugin e file temporanei richiedono comunque percorsi scrivibili e controllati.

Acquisisci gli hash dei file o gli orari di modifica del file NFO e delle immagini di esempio, esegui una scansione della libreria, modifica un titolo nell'interfaccia e avvia un aggiornamento dei metadati. I file dovrebbero rimanere invariati mentre l'applicazione registra nel database lo stato locale consentito.

-15% OFF

ZimaBoard 2 - Mini server domestico per la tua grande idea

Single board computer zimaboard2

Verifica il comportamento durante il ripristino e l'aggiornamento

Esporta o esegui il backup dei sidecar curati separatamente dal database del server multimediale. I sidecar ripristinano i metadati di presentazione; il database potrebbe contenere anche lo stato di visione, gli utenti, le raccolte e altre informazioni che i file locali non includono.

Ricrea il container in una finestra di test e verifica che il flag di mount in sola lettura venga mantenuto dal processo di deployment. Quindi scansiona la directory di esempio e confronta nuovamente gli hash, perché un aggiornamento potrebbe introdurre un nuovo salvataggio dei metadati o modificare un'impostazione predefinita.

La regola di arresto finale è semplice: se un aggiornamento richiede l'accesso in scrittura per preservare il risultato desiderato, il modello della fonte autorevole non è ancora risolto. Ripristina l'esempio, mantieni la produzione in sola lettura e decidi se quel campo è di proprietà del server o del curatore esterno.