Napraw Immich, gdy awaria jest lokalna, a trwałość danych została jednoznacznie potwierdzona; odbuduj środowisko uruchomieniowe, gdy rozbieżności w konfiguracji są rozległe, ale zweryfikowana baza danych, biblioteka multimediów, definicja wdrożenia i kopia umożliwiająca wycofanie zmian pozwalają bezpiecznie odtworzyć usługę.
Odbudowa nie oznacza usunięcia wszystkiego. Kontenery i sieci można odtworzyć, natomiast baza danych i oryginały są zapisem biblioteki. Najpierw określ integralność, zakres i możliwość odtworzenia. Jeśli baza danych lub jedyna kopia zdjęć może być uszkodzona, zachowaj ją i przerwij działania — rozpoczęcie od zera na podstawie tych danych może zmienić możliwy do zdiagnozowania incydent w trwałą utratę danych.
Naprawiaj, gdy usterka jest lokalna i odwracalna
Wybierz naprawę, gdy pojedynczy punkt montowania, uprawnienie, wartość środowiskowa, zależność, zadanie lub przypięty obraz wyjaśnia awarię, a system działał poprawnie przed znaną zmianą. Zbierz logi, utwórz kopię zapasową, zmień tylko tę jedną warstwę i ponownie wywołaj problem.
Po pomyślnym teście uszkodzona funkcja powinna zostać przywrócona bez tworzenia brakujących zasobów, błędów bazy danych ani nowych ostrzeżeń podczas uruchamiania. Jeśli ta sama usterka powraca po odtworzeniu, jej przyczyna może znajdować się w definicji wdrożenia lub stanie trwałym, więc wielokrotna wymiana kontenera nie jest już naprawą opartą na dowodach.
Dyskusja o uszkodzeniu bazy danych pokazuje, jak szybko decyzje dotyczące odzyskiwania stają się ryzykowne, gdy podejrzaną warstwą jest baza danych. Skorzystaj z lekcji opisanej w dyskusji o zachowaniu danych przed naprawą, a nie z żadnego niezweryfikowanego destrukcyjnego polecenia.
Odbuduj środowisko uruchomieniowe, gdy rozbieżności są nieograniczone
Wybierz czystą odbudowę środowiska uruchomieniowego, gdy wersji obrazów, sieci, wartości środowiskowych, punktów montowania i ręcznych zmian w kontenerach nie da się już odtworzyć, ale zweryfikowane komponenty trwałe pozostają nienaruszone. Zbuduj nowe środowisko obok starej instancji, używając przypiętych wersji i odizolowanych portów, zamiast ją usuwać.
Odbudowa jest również właściwa po przejęciu hosta lub gdy niewspierana instalacja zgromadziła nieznane zmiany, ponieważ przywrócenie zaufanych danych wejściowych wdrożenia tworzy nową granicę audytu. Zmień ujawnione dane uwierzytelniające i sprawdź kopie zapasowe przed podłączeniem ich do czystego celu.
Przegląd ZimaSpace dotyczący wdrażania aplikacji hostowanych samodzielnie zapewnia szerszy kontekst stosu usług; w przypadku Immich relację między bazą danych a multimediami nadal trzeba zweryfikować niezależnie.
Nie odbudowuj środowiska na niepewnych danych trwałych
Przerwij działania, gdy baza danych i biblioteka przesłanych plików mogą być niespójne, jedyna kopia zapasowa nie została przetestowana lub nie wiadomo, która kopia jest nadrzędna. Wykonaj migawkę albo klon wszystkich kandydatów i zapisz znaczniki czasu przed próbą odzyskania bazy danych lub uzgodnienia biblioteki multimediów.
Wątek dotyczący odzyskiwania w Unraid pokazuje trudności operacyjne związane z przywracaniem Immich, gdy komponenty kopii zapasowej i wersje nie są zgodne. Jego dyskusja o granicy przywracania przemawia za testowaniem w izolacji zamiast nadpisywania ścieżek produkcyjnych.
Jeśli oryginały są nienaruszone, ale bazy danych nie można odzyskać, zachowaj oba elementy i opisz konsekwencje przed rozważeniem importu do nowej biblioteki. To decyzja dotycząca rekonstrukcji danych, a nie rutynowa naprawa; może spowodować utratę albumów, stanu udostępniania, danych twarzy, ulubionych lub historycznych metadanych.
Zweryfikuj dane trwałe na czystym celu
Przywróć skopiowane dane trwałe lub podłącz je do czystego celu, a następnie przetestuj użytkowników, liczbę elementów na osi czasu, losowo wybrane oryginały, albumy, wyszukiwanie, dane twarzy, biblioteki zewnętrzne, nowe przesyłanie, zadania, a także świeżą kopię bazy danych. Porównaj wyniki z zachowanymi dowodami źródłowymi.
Porównaj liczbę zasobów w bazie danych z próbkami plików z kilku dat, użytkowników i typów multimediów. Potwierdź ścieżki bibliotek zewnętrznych, zadania generujące dane pochodne oraz nowy zrzut bazy danych przed przypisaniem adresu produkcyjnego. Sam ekran logowania nie potwierdza integralności danych.
Uruchom ponownie kontenery i hosta dwukrotnie. Test jest zaliczony, gdy punkty montowania są stabilne, konfigurację można odtworzyć, nie występuje pętla migracji, a pierwotne obciążenie działa poprawnie. Jeśli czysty cel odtwarza ten sam błąd bazy danych lub pliku, rozbieżności środowiska uruchomieniowego nie były przyczyną i bezpieczniejszą ścieżką pozostaje specjalistyczne odzyskiwanie danych.
Przełącz usługę z wyraźną granicą wycofania zmian
Przenieś adres produkcyjny dopiero po pomyślnym zakończeniu testów w izolacji, a stary system pozostaw wyłączony, lecz możliwy do odzyskania przez uzgodniony okres obserwacji. Nie dopuść do tego, by obie instancje jednocześnie przyjmowały przesyłane pliki lub obsługiwały tę samą automatyzację.
Po przełączeniu uruchom zwykły rodzinny proces przesyłania, przeglądania, wyszukiwania, udostępniania i tworzenia kopii zapasowej. Test jest zaliczony, jeśli liczby i oryginały pozostaną niezmienione po kolejnym ponownym uruchomieniu; w przypadku rozbieżności skieruj ruch z powrotem do zachowanego celu, nie nadpisując żadnego z zestawów danych.
Wróć do naprawy lub specjalistycznego odzyskiwania, jeśli czysty cel odtwarza te same błędy bazy danych lub plików — środowisko uruchomieniowe nie było przyczyną. Wycofaj przełączenie, jeśli liczby lub oryginały się różnią. Eskaluj problem, podając wersje, sumy kontrolne, znaczniki czasu kopii zapasowych, pierwszy błąd oraz dokładną granicę między stanem skopiowanym a nowo utworzonym.
Wsparcie i wskazówki
Więcej do przeczytania

Jak zoptymalizować połączenia z bazą danych Immich dla równoczesnych kontenerów
Nie zwiększaj najpierw wartości max_connections. Zmierz sesje Immich, zsumuj zapotrzebowanie wszystkich kontenerów, zachowaj rezerwę dla administratora i dostosuj tylko faktycznie potwierdzone wąskie gardło.

Jak zapobiegać duplikowaniu zadań lub importów w Immich
Oddziel powtarzające się zadania od zduplikowanych zasobów. Użyj jednej kanonicznej ścieżki pozyskiwania danych, kontroluj ponowne próby i zmiany ścieżek, a następnie przetestuj ponowne wprowadzanie...

Jak naprawić Immich po zapełnieniu woluminu bazy danych
Nigdy nie usuwaj dziennika WAL PostgreSQL, aby zwolnić miejsce. Zatrzymaj operacje zapisu w Immich, zachowaj stan bazy danych, bezpiecznie zwiększ pojemność, odzyskaj działanie PostgreSQL,...

