Perché Plex perde l’accesso ai dati persistenti dopo la ricreazione dello stack?
Considera una nuova istanza di Plex dopo la ricreazione dello stack come un problema di montaggio o di autorizzazioni finché non dimostri che i vecchi dati persistenti sono davvero scomparsi.
La ricreazione di uno stack Docker o Compose sostituisce i container e può anche modificare il percorso host, il volume denominato, l’identità dell’utente o il pool di archiviazione associato a `/config`. Plex si avvia quindi su una directory vuota o non leggibile e appare come appena installato, anche se il database originale potrebbe essere ancora presente. Arresta la nuova istanza, trova i vecchi dati dell’applicazione, confronta i montaggi effettivi e la proprietà numerica, e ripristina da un backup solo se quello stato è davvero mancante.
Arresta Plex quando appare come un server nuovo
La procedura guidata di configurazione iniziale dopo la ricreazione dello stack è un avviso di persistenza, non un invito a ricostruire la libreria. Arresta il container e controlla la mappatura dei dati prima che Plex scriva altri dati di stato. Il problema più comune è che il nuovo container stia leggendo un percorso host vuoto invece della precedente directory dei dati dell’applicazione.
Un container ricreato può mostrare una configurazione iniziale quando la mappatura della configurazione persistente prevista non punta più ai dati dell’applicazione originali. Il primo elemento da verificare è se il vecchio stato esiste ancora sull’host.
Individua la precedente directory dei dati di Plex e verifica le date di modifica, i file del database e le cartelle dei metadati. Se sono presenti, non eliminarli e non inizializzare un nuovo server. L’obiettivo del ripristino è il percorso di montaggio e le autorizzazioni, non la libreria multimediale.
Confronta esattamente la mappatura precedente e quella nuova di /config
La ricreazione dello stack può modificare un montaggio bind relativo, un volume denominato, una sostituzione tramite variabile d’ambiente, un pool di archiviazione o la directory di lavoro di Compose senza cambiare il percorso visibile all’interno del container. Plex può continuare a vedere `/config`, ma ora quel percorso potrebbe puntare a una posizione host diversa.
Una configurazione del container Plex è più sicura quando la configurazione risiede al di fuori del container. Confronta i montaggi effettivi del vecchio deployment o del backup con quelli del nuovo stack, invece di affidarti a un file Compose solo apparentemente simile.
Monta i vecchi dati dell’applicazione, già noti, in sola lettura all’interno di un container temporaneo per la diagnostica oppure esaminali direttamente sull’host. Se il database e le preferenze previsti sono presenti, correggi la mappatura di produzione e riavvia Plex una sola volta. Se invece la directory è realmente mancante, passa al ripristino da backup.
Verifica la proprietà prima di accusare il database
Un percorso host corretto può comunque essere inutilizzabile se il container ricreato viene eseguito con un UID, un GID, uno spazio dei nomi utente o un contesto di sicurezza diverso. Plex potrebbe quindi non riuscire a salvare le preferenze, ad aprire i file del database o a creare directory, anche se i dati sono montati nella posizione corretta.
Quando Plex non riesce a creare o aggiornare i dati dell’applicazione, è necessario controllare numericamente le autorizzazioni della directory di configurazione, invece di “risolvere” il problema con un `777` ricorsivo applicato alla cieca.
Esegui un controllo dell’identità all’interno del container e confrontalo con il proprietario numerico e la modalità della directory sull’host. Applica la correzione minima di proprietà o ACL necessaria per concedere l’accesso all’account di servizio previsto. Avvia quindi Plex e verifica che apra il server esistente invece di una nuova configurazione.
Se la proprietà numerica corrisponde ma l’accesso continua a non funzionare, controlla le ACL, le etichette di sicurezza del container e il comportamento dello spazio dei nomi utente prima di modificare il database. Un UID/GID corretto non annulla un ulteriore livello di controllo degli accessi.
Controlla i montaggi multimediali solo dopo il ripristino dello stato dell’applicazione
Quando l’identità del vecchio server e le librerie ricompaiono, alcune librerie potrebbero risultare ancora non disponibili perché i montaggi multimediali sono cambiati indipendentemente da `/config`. Si tratta di un ruolo di persistenza distinto. Correggi il percorso dei contenuti senza ricreare la libreria o copiare i file multimediali nella directory dei dati dell’applicazione.
Mantieni separati lo stato dell’applicazione e i montaggi multimediali, come ruoli di persistenza distinti. Questa separazione consente di ripristinare prima l’identità di Plex e di risolvere i problemi dei percorsi multimediali mancanti solo dopo la ricomparsa delle librerie originali.
Apri diversi percorsi multimediali noti dall’interno del container Plex. Se il vecchio database punta a `/media/movies`, ma lo stack ricreato espone `/movies`, ripristina il percorso interno previsto oppure pianifica una migrazione controllata del percorso della libreria. Non avviare una nuova scansione finché il montaggio non è stabile.
Ripristina da un backup solo quando lo stato originale è davvero scomparso
Se la vecchia directory host è vuota, è stata eliminata o è danneggiata oltre ogni possibilità di utilizzo, ripristina il backup più recente dei dati dell’applicazione Plex sicuramente funzionante in un percorso pulito e mappato correttamente. Conserva separatamente lo stato danneggiato, così potrai ancora esaminare l’accaduto invece di sovrascrivere l’unica traccia disponibile.
Un flusso di lavoro affidabile per il ripristino del container protegge `/config` persistente, sostituisce solo il livello applicativo ricreabile e verifica i montaggi prima di consentire nuovamente a Plex di scrivere.
Dopo il ripristino, verifica l’identità del server, il numero di elementi nelle librerie, lo stato di visione, una riproduzione locale, una transcodifica se utilizzata e un riavvio. Acquisisci quindi la configurazione effettiva dello stack e la posizione del backup. L’incidente è risolto solo quando un’ulteriore ricreazione punta agli stessi dati persistenti senza supposizioni o interventi manuali.
Prodotti consigliati
Supporto e consigli
Altro da leggere
Plex può condividere una GPU con un altro container Docker?
Plex e un altro container possono spesso accedere alla stessa GPU, ma è necessario testare il supporto dei driver, la mappatura dei dispositivi, il...
Come capire se un errore di Plex proviene dal client o dal server
Riproduci lo stesso elemento su un altro client, confronta il percorso della sessione, quindi raccogli le prove dal server solo dopo che l’ambito ti...
Come configurare la cache di Plex e l’archiviazione temporanea per la transcodifica
Proteggi lo stato persistente di Plex collocando i file temporanei di transcodifica su un’unità locale adatta, quindi verifica la pulizia, lo spazio libero e...
