Varför förlorar Plex åtkomsten till beständiga data när stacken återskapas?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Behandla en ny Plex-instans efter att stacken har återskapats som ett monterings- eller behörighetsfel tills du har bekräftat att de gamla beständiga datafilerna verkligen är borta.

Om du återskapar en Docker- eller Compose-stack ersätts containrarna, och det kan även ändra vilken sökväg på värden, namngiven volym, användaridentitet eller lagringspool som ligger bakom `/config`. Plex öppnar då en tom eller oläsbar katalog och verkar nyinstallerat, trots att den ursprungliga databasen kanske fortfarande finns kvar. Stoppa den nya instansen, leta upp de gamla appdatafilerna och jämför de faktiska monteringspunkterna och det numeriska ägarskapet. Återställ bara från säkerhetskopia om dessa data verkligen saknas.

Stoppa när Plex ser ut som en ny server

En ny konfigurationsguide efter att stacken har återskapats är en varning om att data kanske inte sparas, inte en uppmaning att bygga om biblioteket. Stoppa containern och kontrollera datamappningen innan Plex skriver mer data. Det vanligaste felet är att den nya containern läser en tom sökväg på värden i stället för den tidigare programdatakatalogen.

En återskapad container kan visa en ny konfiguration om den förväntade beständiga konfigurationsmappningen inte längre pekar på de ursprungliga appdatafilerna. Det första du behöver ta reda på är om det gamla tillståndet fortfarande finns på värden.

Leta upp den tidigare Plex-datakatalogen och kontrollera ändringstiderna, databasfilerna och metadatakatalogerna. Om de finns ska du inte ta bort dem eller initiera en ny server. Det du behöver återställa är monteringssökvägen och behörigheterna, inte mediebiblioteket.

Jämför den gamla och den nya /config-mappningen exakt

När en stack återskapas kan en relativ bind-montering, namngiven volym, miljövariabelsubstitution, lagringspool eller arbetskatalog för Compose ändras utan att den synliga containersökvägen ändras. Plex kanske fortfarande ser `/config`, men den sökvägen kan nu peka på en annan plats på värden.

Det är säkrast att konfigurera en Plex-container så att konfigurationen lagras utanför containern. Jämför de faktiska monteringspunkterna från den gamla driftsättningen eller säkerhetskopian med den återskapade stacken i stället för att lita på en compose-fil som bara ser likadan ut.

Montera de kända gamla appdatafilerna skrivskyddat i en tillfällig diagnostikcontainer eller granska dem direkt på värden. Om den förväntade databasen och inställningarna finns där korrigerar du mappningen i produktionsmiljön och startar om Plex en gång. Om katalogen faktiskt saknas går du i stället vidare till återställning från säkerhetskopia.

Kontrollera ägarskapet innan du skyller på databasen

En korrekt sökväg på värden kan ändå vara oanvändbar om den återskapade containern körs med ett annat UID, GID, användarnamnutrymme eller säkerhetskontext. Då verkar Plex inte kunna spara inställningar, öppna databasfiler eller skapa kataloger, trots att data är monterade på rätt plats.

När Plex inte kan skapa eller uppdatera appdata ska behörigheterna för konfigurationskatalogen kontrolleras numeriskt i stället för att ”åtgärdas” med en ogenomtänkt rekursiv `777`.

Kontrollera identiteten inifrån containern och jämför den med den numeriska ägaren och rättigheterna på värden. Gör den minsta korrigeringen av ägarskap eller ACL som ger det avsedda tjänstekontot åtkomst. Starta sedan Plex och bekräfta att den öppnar den befintliga servern i stället för att visa en ny konfiguration.

Om det numeriska ägarskapet stämmer men åtkomsten ändå misslyckas, granskar du ACL:er, containerns säkerhetsetiketter och användarnamnområdets beteende innan du ändrar databasen. Korrekt UID/GID åsidosätter inte ett separat åtkomstkontrollager.

Single board computer zimaboard2

Kontrollera mediamonteringar först när applikationstillståndet har återställts

När den gamla serveridentiteten och biblioteken visas igen kan vissa bibliotek fortfarande verka otillgängliga eftersom mediamonteringarna ändrades separat från `/config`. Det är en separat beständighetsroll. Åtgärda mediesökvägen utan att återskapa biblioteket eller kopiera media till applikationsdatakatalogen.

Håll applikationstillstånd och mediamonteringar åtskilda som olika beständighetsroller. Då kan du först återställa Plex-identiteten och felsöka saknade mediesökvägar först när de ursprungliga biblioteken visas igen.

Öppna några kända mediesökvägar inifrån Plex-containern. Om den gamla databasen pekar på `/media/movies` men den återskapade stacken visar `/movies`, återställer du den förväntade interna sökvägen eller planerar en kontrollerad migrering av bibliotekssökvägen. Gör ingen ny genomsökning förrän monteringen är stabil.

Återställ från säkerhetskopia endast när det ursprungliga tillståndet verkligen är borta

Om den gamla värdkatalogen är tom, har raderats eller är för skadad för att kunna användas, återställer du den senaste verifierat fungerande säkerhetskopian av Plex appdata till en ren sökväg med korrekt mappning. Bevara det misslyckade tillståndet separat så att du fortfarande kan undersöka vad som hände, i stället för att skriva över de enda bevisen.

Ett tillförlitligt arbetsflöde för containeråterställning skyddar beständiga `/config`, byter endast ut det tillfälliga applikationslagret och verifierar monteringar innan Plex får skriva igen.

Efter återställningen bekräftar du serverns identitet, antalet bibliotek, visningsstatus, lokal uppspelning, en omkodning om sådan används och en omstart. Dokumentera sedan den aktiva stackkonfigurationen och säkerhetskopians plats. Incidenten är avslutad först när en ny återskapning pekar på samma beständiga data utan manuella gissningar.

Support och tips

Mer att läsa

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.