Stop de defecte Plex-container en de automatische updater voordat je nog een image ophaalt. Bewaar eerst de huidige logs en het daadwerkelijke pad naar de Plex-configuratie; herstel is veel veiliger als de defecte container zichzelf niet opnieuw kan vervangen of naar applicatiegegevens kan schrijven.
Op een NAS voor thuis kan een containerupdate op verschillende lagen mislukken: de nieuwe image start mogelijk niet, de opnieuw aangemaakte service kan een volume- of netwerkinstelling verliezen, of de nieuwe Plex-build kan bestaande applicatiegegevens anders openen. De belangrijke grens is de persistente Plex-configuratie, vooral de database en metadata onder `/config`. Deze werkwijze scheidt de image, containerdefinitie, mounts en database voordat er iets wordt gewijzigd. Vervolgens wordt alleen de kleinste defecte laag hersteld en worden de oorspronkelijke serveridentiteit, bibliotheek en weergave gecontroleerd. Als de logs wijzen op databasecorruptie of een onomkeerbare migratie, stop dan voordat je een oudere image op de enige kopie van die gegevens forceert.
Stop de updatelus en leg de defecte status vast
Schakel de automatische updater voor Plex uit en stop een snelle herstartlus. Laat andere gezonde services draaien, tenzij Plex een database deelt waarvoor een gecoördineerde stop nodig is. Het doel is de fout stil te zetten zodat je die kunt onderzoeken, niet de volledige appstack opnieuw te starten en zo de tijdlijn uit te wissen.
Noteer de exacte imagetag en image-ID van de defecte container, en indien beschikbaar ook de digest. Sla de effectieve mounts, omgevingsvariabelen, gepubliceerde poorten, netwerkmodus, netwerkaliassen, apparaatkoppelingen, toegevoegde groepen, herstartbeleid en gezondheidsstatus op. Een tag zoals `latest` is op zichzelf geen betrouwbare registratie voor terugdraaien, omdat die na verloop van tijd naar andere image-inhoud kan verwijzen.
Exporteer de recente logs voordat je opnieuw probeert te starten en noteer de eerste fatale melding, niet alleen de uiteindelijke exitcode. Een ontbrekend bestand, geweigerde toegang, databasefout, niet-ondersteunde instructie of adresconflict leidt tot een ander herstelpad. Noteer ook wanneer de update is uitgevoerd en of de container opnieuw is aangemaakt, want een pull alleen wijzigt een bestaande container niet, terwijl opnieuw aanmaken de effectieve definitie ervan kan veranderen.
Je kunt verdergaan zodra de fout reproduceerbaar is en je vier vragen kunt beantwoorden: welke image is gestart, welke persistente paden die gebruikte, welke runtime-instellingen die meekreeg en welke fout als eerste optrad. Als die feiten nog onbekend zijn, levert nog een pull of herstart alleen meer ruis op en wordt herstel er niet veiliger door.
Bescherm de Plex-configuratie voordat je de container opnieuw aanmaakt
Beschouw de container als vervangbaar en de Plex-configuratie als persistent. De essentiële statusgegevens staan doorgaans op het hostpad of in het benoemde volume dat aan `/config` is gekoppeld; mediabibliotheken horen op aparte mounts te staan. De service opnieuw aanmaken brengt alleen weinig risico met zich mee als deze opnieuw verbinding maakt met dezelfde persistente statusgegevens en niet met een lege map.
Inspecteer de mount vanaf de host en, als je platform dit ondersteunt, vanuit een tijdelijke alleen-lezencontext. Controleer of de verwachte database, voorkeuren, metadata, plug-ingegevens en logboeken aanwezig zijn. Noteer de bron van de mount, het bestandssysteem, het eigenaarschap, de machtigingen, de beschikbare ruimte en of de mount alleen-lezen is geworden. Een lege map op het verwachte pad is een reden om te stoppen, niet om Plex daar een nieuwe server te laten aanmaken.
Maak een back-up van het volledige beoogde configuratiepad voordat je een terugzetactie test en controleer of de back-up kan worden weergegeven of naar een geïsoleerde locatie kan worden teruggezet. Als het bestandssysteem snapshots ondersteunt, kan een snapshot het herstel versnellen. Vertrouw er echter niet als enige kopie op wanneer hetzelfde opslagapparaat mogelijk defect raakt. Bewaar zowel de mislukte status als de laatst bekende goede back-up totdat de server is gecontroleerd.
Verwijder geen voorkeurenbestanden, databasebestanden of metadata om de oudere image te laten starten. Als de configuratie niet consistent kan worden gelezen, het eigenaarschap onduidelijk is of een kopie niet kan worden geverifieerd, ga dan direct over op herstel van de opslag of database. De container opnieuw aanmaken kan een onbetrouwbare bron van statusgegevens niet herstellen.
Bepaal of de image, definitie, mount of database is mislukt
Vergelijk de vastgelegde container met de laatst werkende implementatie voordat je een oplossing kiest. Begin met de eerste fatale logregel en de effectieve definitie en bepaal vervolgens in welke van vier categorieën de fout valt: de nieuwe image kan niet worden uitgevoerd, de containerdefinitie is gewijzigd, een persistent pad is niet beschikbaar of Plex kan de bestaande toepassingsstatus niet gebruiken.
Een fout met de image of runtime verschijnt meestal voordat Plex `/config` kan openen: architectuurfouten, niet-ondersteunde CPU-instructies, ontbrekende runtimebibliotheken of een onmiddellijk beëindigd proces bij een ongewijzigde containerdefinitie. Een afspeelfout die specifiek was voor een bepaalde versie verdween nadat de server was teruggezet naar een eerdere Plex-image, waardoor terugzetten een nuttige test is als dezelfde definitie eerder werkte en er niets aan mounts of machtigingen is veranderd.
Na het opnieuw aanmaken treedt een fout op in de definitie of koppeling als Plex start zonder media, met een lege server, geweigerde bestandstoegang, zonder webendpoint of zonder toegang tot hardware. Vergelijk de opgeslagen en actieve volumebronnen, UID/GID, groepen, poorten, netwerkmodus, apparaten en omgeving. Corrigeer de eerste aantoonbare afwijking in plaats van alle velden tegelijk te wijzigen.
Berichten over databases en migraties vereisen een aparte aanpak. Als de nieuwe build een schemawijziging is gestart, kan een oudere image de resulterende status mogelijk niet lezen. Maak opnieuw een back-up van de huidige configuratie, bewaar de logs en forceer niet herhaaldelijk het opstarten met verschillende versies. Daarvoor is een compatibele image, een geverifieerde back-up van vóór de update of databasebewust herstel nodig.
| Waargenomen resultaat | Hoofdoorzaak | Eerste herstelactie |
|---|---|---|
| Proces stopt voordat `/config` wordt gelezen | Image of runtime | Start de bewaarde, bekende goed werkende image met de ongewijzigde definitie |
| Plex start als een nieuwe of lege server | Verkeerde `/config`-koppeling | Stop de service en herstel de oorspronkelijke bron van de koppeling |
| Configuratie of media geeft toestemmingsfouten | Eigenaarschap van de koppeling of alleen-lezenstatus | Herstel de bewezen UID/GID, groepen of opslagtoegang |
| Logs tonen migratie- of databasefouten | Applicatiestatus | Behoud de status en gebruik een compatibele image of een geverifieerde back-up |
Teruggaan naar de laatst bekende goed werkende Plex-image
Kies de exacte image die het laatst goed heeft gedraaid. Geef de voorkeur aan een bewaarde image-digest, een onveranderlijke versieaanduiding of een lokale image-ID boven een meebewegende tag. Houd automatische updates uitgeschakeld, zodat de updater de rollback niet meteen na het opstarten kan vervangen.
Maak alleen de Plex-service opnieuw aan op basis van de opgeslagen definitie. Behoud hetzelfde project of dezelfde containeridentiteit als die van invloed is op netwerken, dezelfde bronnen voor `/config` en media, dezelfde poorten, netwerkmodus, omgeving, UID/GID, groepen en apparaten. Verwijder geen volumes en voer geen systeembrede opschoning uit voordat de oude image is getest.
Volg de eerste keer opstarten in realtime. Bij een geslaagde rollback van de image moet de oorspronkelijke configuratie worden geopend, dezelfde serveridentiteit behouden blijven, toegang tot de bestaande bibliotheken beschikbaar zijn en de eerdere fatale fout verdwijnen. Laat optionele hardwaretranscodering en achtergrondscans achterwege totdat de basisaanmelding en toegang tot media werken.
Stop als de oude image meldt dat de database nieuwer of incompatibel is, of dat er een migratie wordt uitgevoerd. Herhaaldelijk van versie wisselen kan het herstelpunt moeilijker te begrijpen maken. Herstel een geverifieerde configuratiekopie van vóór de update naar een geïsoleerd pad of ga verder met een compatibele Plex-image, in plaats van een onveilige downgrade af te dwingen.
Herstel de oorspronkelijke containerdefinitie wanneer terugdraaien niet volstaat
Als de bekende goede image nog steeds niet werkt, ga dan terug naar de vergelijking van definities. Herstel één ontbrekende instelling tegelijk en start alleen Plex opnieuw op na elke wijziging. Zo blijft het bewijs overzichtelijk: wanneer de server weer werkt, weet je welke runtime-afhankelijkheid de oorzaak was.
Begin met de koppelingen voor `/config` en media. Controleer of de container de bedoelde paden ziet en er als de geconfigureerde gebruiker toegang toe heeft. Als de update Plex opnieuw heeft aangemaakt met een andere UID of GID, aanvullende groep of beveiligingscontext, herstel dan de laatst werkende identiteit of corrigeer de eigendomsrechten van de opslag zorgvuldig. Maak niet als snelle oplossing de volledige appdata-mapstructuur schrijfbaar voor iedereen.
Controleer vervolgens het webpad en eventuele apparaten. Herstel het vorige hostnetwerk of de gepubliceerde poort, netwerkaliassen en de configuratie van de reverse proxy voordat je firewallregels wijzigt. Controleer eerst de webinterface via het rechtstreekse serverpad. Voeg het GPU-apparaat en toegang tot de rendergroep pas toe nadat Plex kan starten, de bibliotheek kan laden en een basisstream kan leveren die compatibel is met softwarematige verwerking.
Een geslaagde reparatie van de definitie levert een duidelijke toestand op: de container ziet de bedoelde configuratie en media, het Plex-eindpunt is bereikbaar en de logboeken bevatten de geselecteerde afhankelijkheidsfout niet meer. Blijft dezelfde databasefout bestaan na deze controles, stop dan met het opnieuw aanmaken van de container en ga terug naar de tak voor het beschermen van de applicatiestatus.
Controleer de Plex-database, bibliotheek en weergave voordat je updates opnieuw inschakelt
Een actief proces is slechts de eerste controle tijdens herstel. Meld je aan via het rechtstreekse Plex-eindpunt en controleer of dit de oorspronkelijk geclaimde server is, en niet een nieuwe server die is aangemaakt met een lege configuratiemap. Controleer de opstartlogboeken op beschadiging van de database, herhaalde migratiepogingen en onverwachte initialisatie van de bibliotheek.
Open enkele bestaande items in de bibliotheek en controleer of posters, metadata, de kijkstatus en bestandspaden aanwezig zijn. Test de toegang tot één klein, bekend goed mediabestand op dezelfde opslag als vóór de update. Als de metadata aanwezig is maar de media niet beschikbaar is, is de database mogelijk gezond terwijl een mediamount of toestemming nog moet worden hersteld.
Speel het bekende bestand af op één lokale client en daarna, indien van toepassing, op de client waarop de storing aan het licht kwam. Noteer de afspeelmodus en controleer of vooruit- en terugspoelen werkt. Behandel ontbrekende GPU-versnelling, toegang op afstand of ondertitelgedrag als aparte vervolgpunten als de basisweergave werkt; ze mogen het veiligstellen van een herstelde server niet in de weg staan.
Voer ten slotte één gecontroleerde herstart van de Plex-service uit terwijl de updater nog is uitgeschakeld. Het herstel is geslaagd als dezelfde serveridentiteit, database, bibliotheken, metadata, mediamaptoegang en basisweergave na die herstart weer beschikbaar zijn. Bewaar de vastgelegde foutlogs en de back-up totdat dit volledige resultaat herhaalbaar is.
Weet wanneer je moet stoppen en de volgende Plex-update herstelbaar moet maken
Stop met het lokaal herstellen van de container als in de logs herhaaldelijk databasecorruptie wordt gemeld, het configuratiebestandssysteem I/O-fouten geeft, de enige kopie van de status gedeeltelijk is gemigreerd of geen compatibele image deze kan openen. Bewaar de image-ID's, de effectieve definitie, de logs en de configuratieback-up. Op dat moment is herstel met databasebewuste methoden of opslagreparatie veiliger dan de container steeds opnieuw aan te passen.
Zodra Plex stabiel is, documenteer je de digest van de herstelde image, de containerdefinitie, de persistente paden, de runtime-identiteit, de netwerkmodus, de apparaten en de verificatieresultaten. Het bredere herstelproces voor één service is nuttig wanneer Plex ook afhankelijk is van gedeelde databases, proxynetwerken of andere stackservices, maar die gezonde afhankelijkheden hoef je niet te herstellen alleen omdat Plex is uitgevallen.
Maak voor de volgende update een nieuwe back-up van `/config` en controleer deze, behoud de huidige image, schakel automatisch opschonen uit, werk Plex handmatig bij en herhaal de controles van de identiteit, bibliotheek, weergave en herstart voordat je automatisering weer inschakelt. Een update is pas voltooid als zowel een geteste rollbackmogelijkheid als een werkende nieuwe versie behouden blijft.
Ondersteuning en tips
Meer om te lezen

Zo houd je pornofilms op je NAS verborgen voor gezinsleden
Houd video's voor volwassenen privé op een NAS voor het hele gezin. Controleer mapmachtigingen, toegang tot Plex- en Jellyfin-bibliotheken, miniaturen, kijkgeschiedenis, gedeelde tv-aanmeldingen en...

Wat je moet controleren voordat je een communitymodel in Transformers laadt
Gebruik de Transformers Jinja-sandboxupdate om de herkomst van modellen, chatsjablonen, externe code, geserialiseerde gewichten en geïsoleerde eerste uitvoeringen te controleren.

Voer Mirage lokaal uit: OCR en objectdetectie vanuit één afbeelding
Probeer het kleine lokale visiemodel van Cactus Compute, test OCR en objectextractie met echte invoer en krijg inzicht in de beperkingen op het gebied...



