Jak przenieść dane Immich bez utraty użytkowników, historii ani ustawień

Eva Wong

IceWhale author

Eva Wong jest Technicznym pisarzem i stałym majsterkowiczem w ZimaSpace. Całe życie geek z pasją do homelabów i oprogramowania open-source, specjalizuje się w tłumaczeniu skomplikowanych koncepcji technicznych na przystępne, praktyczne przewodniki. Eva wierzy, że samodzielne hostowanie powinno być zabawą, a nie czymś onieśmielającym. Poprzez swoje samouczki umożliwia społeczności rozwiewanie tajemnic konfiguracji sprzętu, od budowy pierwszego NAS po opanowanie kontenerów Docker.

How to Move Immich Data Without Losing Users, History, or Settings - Zima Store Online

Przenieś Immich jako migrację stanu aplikacji, a nie jako kopiowanie folderu: zachowaj bazę danych, drzewo multimediów, konfigurację, sekrety oraz ścieżki, które je łączą.

Migracja może wyglądać na udaną, ponieważ każdy plik JPEG znajduje się na nowym dysku, podczas gdy brakuje kont, albumów, osób, udostępnień, ulubionych lub historycznych relacji. Najpierw utwórz punkt wycofania, zapisz jeden spójny stan źródłowy, skopiuj go bez zmiany identyfikatorów, odtwórz na odizolowanym serwerze docelowym i przełącz system dopiero po potwierdzeniu, że przepływy pracy domowników działają tak samo.

Zinwentaryzuj stan, który musi zostać przeniesiony razem

Wymień bazę danych PostgreSQL, przesłane multimedia, wygenerowane dane, które chcesz zachować, definicje bibliotek zewnętrznych, konfigurację Compose lub aplikacji, wartości środowiskowe, sekrety, nazwy sieci oraz bieżące mapowania pamięci. Oznacz, który element jest źródłem prawdy, a który można odtworzyć po przywróceniu.

Dyskusja z 2026 roku dotycząca zachowania użytkowników Immich podczas przenoszenia potwierdza najważniejszą kwestię: stan użytkowników i bibliotek jest powiązany z bazą danych oraz zamontowanymi ścieżkami, a nie z obrazem kontenera. Traktuj polecenia społeczności jako przykłady i dostosuj je do dokładnej używanej wersji.

Przed przeniesieniem zapisz niewielki zestaw kontrolny: dwóch użytkowników, kilka albumów, ulubione, udostępnione elementy, jedną osobę lub wynik wyszukiwania, starsze i nowsze zasoby oraz jedną ścieżkę biblioteki zewnętrznej, jeśli jest używana. Te znane rekordy znacznie ułatwią walidację po migracji w porównaniu z samym porównaniem całkowitego rozmiaru plików.

Utwórz spójny punkt odzyskiwania przed kopiowaniem

Wstrzymaj nowe przesyłanie lub zaplanuj okno konserwacyjne, aby źródło przestało się zmieniać podczas zapisywania stanu migracji. Wykonaj kopię zapasową natywną dla bazy danych oraz zabezpiecz multimedia źródłowe i konfigurację. Po wykonaniu kopii pozostaw oryginalną instancję nietkniętą do czasu pomyślnego zakończenia weryfikacji miejsca docelowego.

Przewodnik odzyskiwania ZimaSpace dotyczący wspólnego przywracania elementów biblioteki zdjęć wyjaśnia, dlaczego oryginały, stan katalogu i konfiguracja określająca ścieżki muszą reprezentować zgodny punkt odzyskiwania. Tę samą granicę należy zachować podczas migracji.

Nie używaj aktywnego katalogu bazy danych produkcyjnej jako zwykłego celu kopiowania plików, gdy baza się zmienia. Jeśli przestój musi być krótki, użyj zrzutu uwzględniającego bazę danych oraz metody przechowywania, której kolejność przechwytywania rozumiesz. Migracja jest możliwa do odtworzenia tylko w takim stopniu, w jakim można przywrócić zapisany punkt, a nie w zależności od liczby skopiowanych plików.

Kopiuj multimedia z zachowaniem ścieżek i uprawnień

Skopiuj drzewo multimediów do miejsca docelowego bez reorganizowania folderów w trakcie migracji. Zachowaj właścicieli, uprawnienia, znaczniki czasu oraz wszystkie funkcje systemu plików, od których zależy wdrożenie. Jeśli ścieżka widoczna w kontenerze ma pozostać taka sama, zmień źródło wiązania po stronie hosta, zachowując mapowanie wewnątrz kontenera.

Aktualny proces migracji z użyciem rsync podkreśla tryb archiwizacji, uruchomienia testowe, możliwość wznawiania transferów oraz zagrożenia związane z destrukcyjnymi opcjami tworzenia lustrzanej kopii. Przed usunięciem czegokolwiek wykonaj próbne porównanie i zweryfikuj miejsce docelowe, zamiast zakładać, że zakończenie polecenia oznacza pełną migrację aplikacji.

Porównaj liczbę i rozmiary plików, a następnie zweryfikuj reprezentatywną próbkę sum kontrolnych obejmującą stare zdjęcia, nowe zdjęcia, nagrania wideo i duże pliki. Jeśli pojawią się błędy kopiowania lub komunikaty o „znikniętych plikach” wynikające ze zmian w źródle, wstrzymaj przyjmowanie przesyłanych danych i powtórz przebieg różnicowy, zamiast usuwać źródło, aby uzyskać pozornie czyste miejsce docelowe.

Featured

ZimaCube 2 Osobisty domowy NAS w chmurze

ZimaCube2

Odtwórz bazę danych i konfigurację na odizolowanym serwerze docelowym

Uruchom miejsce docelowe pod tymczasową nazwą hosta lub w odizolowanej sieci, aby aplikacje mobilne nie mogły przesyłać do niego danych podczas walidacji. Podłącz skopiowane multimedia w oczekiwanych ścieżkach kontenera, odtwórz zgodną bazę danych oraz odtwórz środowisko, sekrety, sieci i ustawienia serwera proxy wymagane przez daną wersję.

Osobny opis etapowej migracji serwera z 2026 roku pokazuje, dlaczego operatorzy testują nowy host przed wycofaniem starego. Wykorzystaj takie relacje do poznania możliwych problemów, ale to znane rekordy powinny decydować o tym, czy migracja rzeczywiście zachowała stan.

Zatrzymaj się, jeśli miejsce docelowe otwiera się jako nowa instalacja, zgłasza brak pamięci masowej lub proponuje destrukcyjną inicjalizację. Objawy te zwykle oznaczają, że baza danych lub zamontowane zasoby nie są właściwe. Najpierw popraw ścieżkę albo cel przywracania; nie przesyłaj nowych plików do instancji wyglądającej na pustą i nie twórz dwóch konkurencyjnych historii.

Przełącz system dopiero po sprawdzeniu użytkowników, historii i nowych zapisów

Zaloguj się jako każdy użytkownik referencyjny i sprawdź członkostwo w albumach, ulubione, udostępnienia, stan wyszukiwania lub osób, reprezentatywne oryginały, znaczniki czasu oraz oczekiwaną liczbę elementów w bibliotece. Następnie prześlij jedno nowe zdjęcie testowe i potwierdź, że pojawia się w systemie, zostaje przetworzone i przetrwa ponowne uruchomienie kontenera.

Zmień docelowy serwer DNS lub proxy dopiero po pomyślnym zakończeniu testu izolowanego. Pozostaw starą instancję zatrzymaną, ale możliwą do odzyskania, aby oba systemy nie mogły jednocześnie przyjmować zapisów. Zachowaj kopię zapasową bazy danych sprzed migracji i multimedia źródłowe do czasu, aż nowy host wykona standardowe kopie zapasowe oraz co najmniej jeden test przywracania.

Wycofaj migrację, jeśli liczby się nie zgadzają, znane relacje znikają, nowe przesyłane dane trafiają na niewłaściwy dysk lub miejsce docelowe nie działa po ponownym uruchomieniu. Przy zgłoszeniu problemu podaj wersje źródła i miejsca docelowego, znacznik czasu kopii bazy danych, mapowania montowanych zasobów, logi kopiowania, różnice w uprawnieniach oraz pierwszy element weryfikacji, który się nie powiódł.