Zatrzymaj kontener Plex, który uległ awarii, i jego automatyczny aktualizator, zanim pobierzesz kolejny obraz. Najpierw zachowaj bieżące logi i rzeczywistą ścieżkę konfiguracji Plex; odzyskiwanie jest znacznie bezpieczniejsze, gdy uszkodzony kontener nie może się samoczynnie zastępować ani zapisywać danych aplikacji.
Na domowym serwerze NAS aktualizacja kontenera może zawieść na kilku różnych poziomach: nowy obraz może się nie uruchomić, odtworzona usługa może utracić ustawienie woluminu lub sieci albo nowa kompilacja Plex może inaczej otworzyć istniejące dane aplikacji. Kluczowym elementem są trwałe dane konfiguracji Plex, zwłaszcza baza danych i metadane w `/config`. Ta procedura oddziela obraz, definicję kontenera, punkty montowania i bazę danych, zanim cokolwiek zostanie zmienione, a następnie przywraca tylko tę warstwę, która uległa awarii, i sprawdza, czy tożsamość serwera, biblioteka i odtwarzanie pozostały bez zmian. Jeśli logi wskazują na uszkodzenie bazy danych lub nieodwracalną migrację, przerwij, zanim wymusisz starszy obraz na jedynej kopii tych danych.
Zatrzymaj pętlę aktualizacji i zachowaj stan po awarii
Wyłącz automatyczny aktualizator dla Plex i zatrzymaj szybką pętlę ponownych uruchomień. Pozostaw działające usługi włączone, chyba że Plex współdzieli bazę danych wymagającą skoordynowanego zatrzymania. Celem jest utrzymanie awarii w niezmienionym stanie na tyle długo, by ją zbadać, a nie ponowne uruchamianie całego stosu aplikacji i zatarcie przebiegu zdarzeń.
Zapisz dokładny tag obrazu, identyfikator obrazu i jego skrót, jeśli są dostępne, dla kontenera, który uległ awarii. Zapisz też efektywne punkty montowania, zmienne środowiskowe, opublikowane porty, tryb sieci, aliasy sieciowe, mapowania urządzeń, dodatkowe grupy, politykę ponownego uruchamiania i stan kondycji. Sam tag taki jak `latest` nie jest wiarygodnym zapisem umożliwiającym wycofanie zmian, ponieważ z czasem może wskazywać inną zawartość obrazu.
Przed kolejną próbą uruchomienia wyeksportuj najnowsze logi i zanotuj pierwszy komunikat o błędzie krytycznym, a nie tylko końcowy kod wyjścia. Brakujący plik, odmowa dostępu, błąd bazy danych, nieobsługiwana instrukcja lub konflikt adresów wymagają różnych ścieżek odzyskiwania. Zapisz też, kiedy wykonano aktualizację i czy kontener został odtworzony, ponieważ samo pobranie obrazu nie zmienia istniejącego kontenera, natomiast jego odtworzenie może zmienić jego efektywną konfigurację.
Możesz kontynuować, gdy awaria jest powtarzalna i potrafisz odpowiedzieć na cztery pytania: jaki obraz został uruchomiony, jakich ścieżek trwałych używał, jakie ustawienia środowiska wykonawczego otrzymał i jaki błąd pojawił się jako pierwszy. Jeśli te fakty są nadal nieznane, kolejne pobranie obrazu lub ponowne uruchomienie tylko zwiększy zamieszanie, nie czyniąc odzyskiwania bezpieczniejszym.
Zabezpiecz konfigurację Plex przed ponownym utworzeniem kontenera
Traktuj kontener jako wymienny, a konfigurację Plex jako trwałą. Kluczowe dane zwykle znajdują się w ścieżce hosta lub nazwanym woluminie zamontowanym w `/config`; biblioteki multimediów powinny być montowane osobno. Ponowne utworzenie usługi jest bezpieczne tylko wtedy, gdy łączy się ona z tym samym trwałym stanem, a nie z pustym katalogiem.
Sprawdź punkt montowania z poziomu hosta, a jeśli platforma na to pozwala, także w tymczasowym kontekście tylko do odczytu. Potwierdź, że istnieją oczekiwana baza danych, preferencje, metadane, dane wtyczek i dzienniki. Zapisz źródło punktu montowania, system plików, właściciela, uprawnienia, dostępną przestrzeń oraz informację, czy system plików nie został przełączony w tryb tylko do odczytu. Pusty katalog w oczekiwanej lokalizacji to sygnał ostrzegawczy, by się zatrzymać, a nie pozwolenie, by Plex utworzył tam nowy serwer.
Przed testowaniem wycofania wersji utwórz kopię zapasową całej zamierzonej ścieżki konfiguracji, a następnie sprawdź, czy można wyświetlić jej zawartość lub przywrócić ją w odizolowanej lokalizacji. Jeśli system plików obsługuje migawki, mogą one przyspieszyć odzyskiwanie, ale nie powinny być jedyną kopią, gdy może zawodzić to samo urządzenie pamięci masowej. Zachowaj zarówno uszkodzony stan, jak i ostatnią znaną dobrą kopię zapasową, aż do potwierdzenia, że serwer działa prawidłowo.
Nie usuwaj plików preferencji, plików bazy danych ani metadanych, aby uruchomić starszy obraz. Jeśli konfiguracji nie można odczytać w spójny sposób, jej właściciel jest nieznany albo nie można zweryfikować kopii, od razu przejdź do odzyskiwania danych z pamięci masowej lub bazy danych. Ponowne utworzenie kontenera nie naprawi niewiarygodnego źródła stanu.
Ustal, czy problem dotyczy obrazu, definicji, punktu montowania czy bazy danych
Zanim wybierzesz sposób naprawy, porównaj przechwyconą definicję kontenera z ostatnim działającym wdrożeniem. Zacznij od pierwszego krytycznego wiersza dziennika i faktycznie zastosowanej definicji, a następnie przypisz problem do jednej z czterech kategorii: nowy obraz nie może działać, zmieniła się definicja kontenera, ścieżka trwałego przechowywania jest niedostępna albo Plex nie może użyć istniejącego stanu aplikacji.
Błąd obrazu lub środowiska uruchomieniowego zwykle pojawia się, zanim Plex zdąży otworzyć `/config`: błędy architektury, nieobsługiwane instrukcje procesora, brakujące biblioteki środowiska uruchomieniowego albo natychmiastowe zakończenie procesu przy niezmienionej definicji kontenera. Problem z odtwarzaniem dotyczący konkretnej wersji zniknął po przywróceniu wcześniejszego obrazu Plex na serwerze, dlatego cofnięcie wersji jest przydatnym testem, gdy ta sama definicja wcześniej działała, a żaden punkt montowania ani uprawnienia się nie zmieniły.
Po ponownym utworzeniu kontenera mogą pojawić się problemy z definicją lub montowaniem: Plex uruchamia się bez multimediów, jako pusty serwer, z odmową dostępu do plików, bez dostępnego interfejsu WWW lub bez dostępu do sprzętu. Porównaj zapisane i faktycznie używane źródła woluminów, UID/GID, grupy, porty, tryb sieci, urządzenia i zmienne środowiskowe. Popraw pierwszą potwierdzoną niezgodność zamiast zmieniać wszystkie ustawienia naraz.
Komunikaty dotyczące bazy danych i migracji wymagają odrębnego podejścia. Jeśli nowa kompilacja rozpoczęła zmianę schematu, starszy obraz może nie być w stanie odczytać zmienionego stanu. Ponownie utwórz kopię zapasową bieżącej konfiguracji, zachowaj logi i nie wymuszaj kolejnych uruchomień na kilku wersjach. W tej sytuacji potrzebny jest zgodny obraz, sprawdzona kopia zapasowa sprzed aktualizacji lub naprawa uwzględniająca bazę danych.
| Zaobserwowany wynik | Główna gałąź | Pierwsza naprawa |
|---|---|---|
| Proces kończy się, zanim odczyta `/config` | Obraz lub środowisko uruchomieniowe | Uruchom zachowany, sprawdzony obraz z niezmienioną definicją |
| Plex uruchamia się jako nowy lub pusty serwer | Nieprawidłowe mapowanie `/config` | Zatrzymaj usługę i przywróć oryginalne źródło montowania |
| Błędy uprawnień w konfiguracji lub multimediach | Właściciel zamontowanego zasobu lub tryb tylko do odczytu | Przywróć sprawdzone wartości UID/GID, grupy lub dostęp do pamięci masowej |
| W logach widać błędy migracji lub bazy danych | Stan aplikacji | Zachowaj stan i użyj zgodnego obrazu lub zweryfikowanej kopii zapasowej |
Przywracanie ostatniego sprawdzonego obrazu Plex
Wybierz dokładnie ten obraz, który działał ostatnio poprawnie. Zamiast zmiennego tagu użyj zachowanego skrótu obrazu, niezmiennego odwołania do wersji lub lokalnego identyfikatora obrazu. Wyłącz automatyczne aktualizacje, aby program aktualizujący nie zastąpił obrazu przywróconego do poprzedniej wersji zaraz po jego uruchomieniu.
Odtwórz wyłącznie usługę Plex z zapisanej definicji. Zachowaj tę samą tożsamość projektu lub kontenera, jeśli ma wpływ na sieci, a także te same źródła `/config` i multimediów, porty, tryb sieci, zmienne środowiskowe, UID/GID, grupy i urządzenia. Nie usuwaj woluminów i nie przeprowadzaj ogólnego czyszczenia systemu, zanim nie przetestujesz starego obrazu.
Obserwuj pierwsze uruchomienie w czasie rzeczywistym. Udany powrót do poprzedniej wersji obrazu powinien przywrócić pierwotną konfigurację, zachować tę samą tożsamość serwera, udostępnić istniejące biblioteki i usunąć poprzedni błąd krytyczny. Nie zajmuj się opcjonalnym transkodowaniem sprzętowym ani skanowaniem w tle, dopóki nie będzie można się zalogować i uzyskać dostępu do multimediów.
Zatrzymaj się, jeśli stary obraz zgłasza, że baza danych jest nowsza, niezgodna lub w trakcie migracji. Wielokrotne przełączanie wersji może utrudnić zrozumienie stanu odzyskiwania. Przywróć sprawdzoną kopię konfiguracji sprzed aktualizacji w odizolowanej lokalizacji albo przejdź na zgodny obraz Plex, zamiast wymuszać niebezpieczne obniżenie wersji.
Przywróć pierwotną konfigurację kontenera, gdy wycofanie zmian nie wystarcza
Jeśli znany, działający obraz nadal nie działa, wróć do porównania konfiguracji kontenera. Przywracaj po jednym brakującym ustawieniu i po każdej zmianie uruchamiaj ponownie tylko Plex. Dzięki temu łatwiej analizować dostępne informacje: gdy serwer znów zacznie działać, będziesz wiedzieć, która zależność środowiska wykonawczego była przyczyną problemu.
Zacznij od montowań `/config` i plików multimedialnych. Potwierdź, że kontener widzi zamierzone ścieżki i może odczytywać ich zawartość jako skonfigurowany użytkownik. Jeśli aktualizacja odtworzyła Plex z innym UID lub GID, dodatkowymi grupami lub innym kontekstem bezpieczeństwa, przywróć ostatnią działającą tożsamość albo celowo popraw właściciela danych w pamięci masowej. Nie ustawiaj uprawnień do zapisu dla wszystkich w całym drzewie appdata.
Następnie sprawdź ścieżkę dostępu przez sieć i opcjonalne urządzenia. Zanim zmienisz reguły zapory, przywróć poprzednią konfigurację sieci hosta lub opublikowany port, aliasy sieciowe i członkostwo w odwrotnym proxy. Najpierw sprawdź interfejs WWW bezpośrednio na serwerze. Dodaj urządzenie GPU i dostęp do grupy renderowania dopiero wtedy, gdy Plex może się uruchomić, wczytać bibliotekę i obsłużyć podstawowy strumień zgodny z dekodowaniem programowym.
Pomyślna naprawa konfiguracji ma jasno określony stan: kontener widzi zamierzoną konfigurację i pliki multimedialne, punkt dostępu Plex jest osiągalny, a w dziennikach nie pojawia się już wybrany błąd zależności. Jeśli po tych kontrolach ten sam błąd bazy danych nadal występuje, przestań odtwarzać kontener i wróć do gałęzi dotyczącej chronionego stanu aplikacji.
Sprawdź bazę danych Plex, bibliotekę i odtwarzanie przed ponownym włączeniem aktualizacji
Uruchomiony proces to dopiero pierwszy krok weryfikacji po odzyskaniu działania. Zaloguj się przez bezpośredni punkt dostępu Plex i potwierdź, że to pierwotny, aktywowany serwer, a nie nowy serwer utworzony z pustym katalogiem konfiguracji. Sprawdź dzienniki uruchamiania pod kątem uszkodzenia bazy danych, powtarzających się prób migracji i nieoczekiwanej inicjalizacji biblioteki.
Otwórz kilka istniejących pozycji biblioteki i sprawdź, czy są dostępne plakaty, metadane, stan obejrzenia i ścieżki do plików. Sprawdź dostęp do jednego niewielkiego, sprawdzonego pliku multimedialnego z tego samego magazynu, który był używany przed aktualizacją. Jeśli metadane są dostępne, ale multimedia nie, baza danych może działać poprawnie, a naprawy nadal może wymagać podmontowanie multimediów lub uprawnienia.
Odtwórz znany plik na jednym kliencie lokalnym, a następnie na kliencie, na którym wystąpiła awaria, jeśli dotyczy. Zapisz tryb odtwarzania i potwierdź, że przewijanie działa. Brak akceleracji GPU, dostępu zdalnego lub obsługi napisów potraktuj jako osobne kwestie do późniejszego sprawdzenia, jeśli podstawowe odtwarzanie działa; nie powinny one blokować zabezpieczenia odzyskanego serwera.
Na koniec wykonaj jeden kontrolowany restart usługi Plex, pozostawiając aktualizator wyłączony. Odzyskiwanie jest udane tylko wtedy, gdy po restarcie wracają ta sama tożsamość serwera, baza danych, biblioteki, metadane, dostęp do multimediów i podstawowe odtwarzanie. Zachowaj zapisane logi awarii i kopię zapasową do czasu, aż ten pełny wynik będzie powtarzalny.
Wiedz, kiedy przerwać i przygotować możliwość odzyskania systemu po kolejnej aktualizacji Plex
Przerwij lokalną naprawę kontenera, gdy logi wielokrotnie zgłaszają uszkodzenie bazy danych, system plików konfiguracji zwraca błędy wejścia/wyjścia, jedyna kopia stanu została częściowo zmigrowana lub żaden zgodny obraz nie może jej otworzyć. Zachowaj identyfikatory obrazów, efektywną definicję, logi i kopię zapasową konfiguracji. Na tym etapie bezpieczniejsze będzie przywracanie uwzględniające bazę danych lub naprawa pamięci masowej niż dalsze wymienianie kontenerów.
Gdy Plex znów działa stabilnie, zapisz odzyskany skrót obrazu, definicję kontenera, ścieżki trwałych danych, tożsamość procesu, tryb sieciowy, urządzenia i wyniki weryfikacji. Szerszy proces odzyskiwania pojedynczej usługi jest przydatny, gdy Plex zależy również od współdzielonych baz danych, sieci serwera proxy lub innych usług stosu, ale nie należy przywracać tych sprawnych zależności tylko dlatego, że awarii uległ Plex.
Przed następną aktualizacją utwórz i zweryfikuj nową kopię zapasową `/config`, zachowaj bieżący obraz, wyłącz automatyczne usuwanie starych obrazów, zaktualizuj Plex ręcznie i ponownie sprawdź tożsamość serwera, bibliotekę, odtwarzanie i restart przed ponownym włączeniem automatyzacji. Aktualizacja jest zakończona dopiero wtedy, gdy zachowuje przetestowany punkt przywracania oraz działającą nową wersję.
Wsparcie i porady
Więcej do przeczytania

Jak ukryć filmy dla dorosłych na serwerze NAS przed członkami rodziny
Przechowuj filmy dla dorosłych prywatnie na rodzinnym serwerze NAS. Sprawdź uprawnienia folderów, dostęp do bibliotek Plex i Jellyfin, miniatury, historię oglądania, wspólne loginy do...

Co sprawdzić przed załadowaniem modelu społecznościowego w Transformers
Użyj aktualizacji piaskownicy Jinja dla Transformers, aby sprawdzić pochodzenie modelu, szablony czatu, zdalny kod, serializowane wagi i pierwsze uruchomienia w izolowanym środowisku.

Uruchom Mirage lokalnie: OCR i wykrywanie obiektów na podstawie jednego obrazu
Przetestuj niewielki lokalny model wizyjny Cactus Compute, zweryfikuj OCR i ekstrakcję obiektów na rzeczywistych danych wejściowych oraz poznaj ograniczenia związane z pamięcią, językiem i...



