Waarom verliest Plex de toegang tot permanente gegevens nadat de stack opnieuw is aangemaakt?

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.

Beschouw een nieuwe Plex-instantie na het opnieuw aanmaken van een stack als een probleem met de koppeling of machtigingen, totdat je hebt vastgesteld dat de oude permanente gegevens daadwerkelijk verdwenen zijn.

Een Docker- of Compose-stack opnieuw aanmaken vervangt containers en kan ook wijzigen welk hostpad, benoemd volume, gebruikersidentiteit of opslagpool achter `/config` zit. Plex opent dan een lege of onleesbare map en lijkt nieuw geïnstalleerd, ook al bestaat de oorspronkelijke database mogelijk nog. Stop de nieuwe instantie, zoek de oude appdata, vergelijk de effectieve koppelingen en de numerieke eigendomsgegevens, en herstel pas vanaf een back-up als die status echt ontbreekt.

Stop als Plex eruitziet als een nieuwe server

Een nieuwe configuratiewizard na het opnieuw aanmaken van een stack is een waarschuwing dat de gegevens niet blijvend zijn opgeslagen, geen uitnodiging om de bibliotheek opnieuw op te bouwen. Stop de container en controleer de gegevenskoppeling voordat Plex meer status opslaat. De meest voorkomende oorzaak is dat de nieuwe container een leeg hostpad leest in plaats van de vorige map met toepassingsgegevens.

Een opnieuw aangemaakte container kan een nieuwe configuratie tonen als de verwachte koppeling naar de permanente configuratie niet meer naar de oorspronkelijke appdata verwijst. De eerste stap is nagaan of de oude status nog op de host bestaat.

Zoek de vorige Plex-gegevensmap en controleer de wijzigingstijden, databasebestanden en metadatamappen. Als die aanwezig zijn, verwijder ze dan niet en initialiseer geen nieuwe server. Je moet het koppelpad en de machtigingen herstellen, niet de mediabibliotheek.

Vergelijk de oude en nieuwe /config-mapping exact

Het opnieuw aanmaken van een stack kan een relatieve bind mount, benoemd volume, omgevingsvariabele, opslagpool of werkmap van Compose wijzigen zonder dat het zichtbare containerpad verandert. Plex ziet mogelijk nog steeds `/config`, maar dat pad kan nu naar een andere locatie op de host verwijzen.

Een Plex-container stel je het veiligst in wanneer de configuratie buiten de container staat. Vergelijk de effectieve koppelingen met die uit het oude implementatierecord of de back-up, in plaats van te vertrouwen op een compose-bestand dat er visueel hetzelfde uitziet.

Koppel de bekende oude appdata alleen-lezen aan een tijdelijke diagnostische container of inspecteer deze rechtstreeks op de host. Als de verwachte database en voorkeuren aanwezig zijn, corrigeer dan de productiemapping en start Plex één keer opnieuw. Als de map echt ontbreekt, ga dan over op herstel vanaf een back-up.

Controleer het eigenaarschap voordat je de database de schuld geeft

Een correct hostpad kan alsnog onbruikbaar zijn als de opnieuw aangemaakte container met een andere UID, GID, gebruikersnaamruimte of beveiligingscontext wordt uitgevoerd. Plex lijkt dan geen voorkeuren te kunnen opslaan, databasebestanden te kunnen openen of mappen te kunnen aanmaken, ook al zijn de gegevens op de juiste plek gekoppeld.

Als Plex geen appdata kan maken of bijwerken, controleer dan de rechten van de configuratiemap aan de hand van numerieke waarden in plaats van ze blindelings recursief op `777` in te stellen.

Controleer de identiteit in de container en vergelijk die met de numerieke eigenaar en rechten op de host. Pas de eigenaar of ACL zo beperkt mogelijk aan, zodat het bedoelde serviceaccount toegang krijgt. Start Plex vervolgens en bevestig dat de bestaande server wordt geopend in plaats van een nieuwe installatie.

Als het numerieke eigenaarschap klopt maar toegang nog steeds mislukt, controleer dan ACL's, beveiligingslabels van de container en het gedrag van gebruikersnaamruimten voordat je de database wijzigt. Een juiste UID/GID heft een aparte toegangscontrolelaag niet op.

Single board computer zimaboard2

Controleer mediakoppelingen pas nadat de applicatiestatus is teruggezet

Zodra de oude serveridentiteit en bibliotheken weer verschijnen, zijn sommige bibliotheken mogelijk nog steeds niet beschikbaar doordat mediakoppelingen onafhankelijk van `/config` zijn gewijzigd. Dat is een aparte persistente functie. Herstel het mediapad zonder de bibliotheek opnieuw aan te maken of media naar de map met applicatiegegevens te kopiëren.

Houd de applicatiestatus en mediakoppelingen gescheiden als persistente onderdelen. Zo kun je eerst de Plex-identiteit herstellen en pas problemen met ontbrekende mediapaden oplossen nadat de oorspronkelijke bibliotheken weer verschijnen.

Open enkele bekende mediapaden vanuit de Plex-container. Als de oude database verwijst naar `/media/movies`, maar de opnieuw aangemaakte stack `/movies` beschikbaar stelt, herstel dan het verwachte interne pad of plan een gecontroleerde migratie van het bibliotheekpad. Voer geen nieuwe scan uit voordat de koppeling stabiel is.

Herstel pas vanaf een back-up als de oorspronkelijke toestand echt verloren is

Als de oude hostmap leeg, verwijderd of onherstelbaar beschadigd is, zet dan de meest recente goede back-up van Plex-appdata terug naar een schoon pad met de juiste koppeling. Bewaar de mislukte toestand apart, zodat je nog kunt onderzoeken wat er is gebeurd in plaats van het enige bewijsmateriaal te overschrijven.

Een betrouwbare containerherstelprocedure beschermt de persistente map `/config`, vervangt alleen de wegwerpbare applicatielaag en controleert de koppelingen voordat Plex weer mag schrijven.

Bevestig na herstel de serveridentiteit, het aantal items in de bibliotheek, de kijkstatus, één lokale weergave, een transcodering indien gebruikt en één herstart. Leg vervolgens de effectieve stackconfiguratie en de back-uplocatie vast. Het incident is pas opgelost als een volgende hercreatie naar dezelfde persistente gegevens verwijst, zonder dat je hoeft te gissen.

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.