Jak przeniosłem 14000 zdjęć na ZimaCube 2 bez utraty danych — przewodnik migracji Immich

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

💡 Wyróżnienie społeczności: u/Ambitious_Shallot_79, r/minilab

Masz bibliotekę zdjęć. Lata wspomnień. Starannie uporządkowane albumy. Oznaczone przez siebie twarze. Linki udostępnione rodzinie.

A potem modernizujesz swój NAS — i zdajesz sobie sprawę, że samo przeniesienie plików nie wystarczy. Bez bazy danych tracisz wszystkie albumy, wszystkie tagi twarzy i każde wspomnienie, które uporządkowałeś. Zdjęcia są na miejscu, ale ich organizacja przepada.

Właśnie przeniosłem 14 505 zdjęć i 925 filmów — łącznie 134 GiB — z własnoręcznie skonfigurowanego serwera ZimaOS do ZimaCube 2. Wszystkie albumy zostały zachowane. Wszystkie tagi twarzy zostały przeniesione. Wszystkie udostępnione linki nadal działają.

Oto dokładny opis tego, jak to zrobiłem, co omal się nie posypało i co ZimaCube 2 zaoferował w porównaniu z moją poprzednią konfiguracją.

Dlaczego Immich i dlaczego właśnie teraz

Immich stał się najpopularniejszym rozwiązaniem do samodzielnego hostowania zdjęć nie bez powodu. Oferuje funkcje na poziomie Google Photos — rozpoznawanie twarzy, wyszukiwanie semantyczne, automatyczne kopie zapasowe z telefonu i udostępnione albumy — bez wysyłania zdjęć na serwer należący do kogoś innego.

Ale Immich przechowuje swoją duszę w PostgreSQL. Baza danych zawiera albumy, wektory twarzy, klastry osób, embeddingi CLIP na potrzeby inteligentnego wyszukiwania oraz wszystkie metadane, dzięki którym biblioteka jest naprawdę Twoja. Przenieś pliki bez bazy danych, a otrzymasz folder pełen zdjęć i pustą instancję Immich.

Ta migracja miała jedną zasadę: zero utraty danych. Stary serwer nie zostałby wyczyszczony, dopóki nie zweryfikowano nowego.

Co faktycznie przechowuje Immich (i dlaczego to ważne)

Zanim ruszyłem jakiekolwiek pliki, dokładnie ustaliłem, co trzeba przenieść:

Komponent Lokalizacja Zawartość Czy trzeba przenieść?
pgdata /DATA/AppData/immich/pgdata Pełna baza PostgreSQL — albumy, twarze, osoby, metadane ✅ Krytyczne
model-cache /DATA/AppData/immich/model-cache Pobrane modele CLIP/rozpoznawania twarzy ✅ Pozwala uniknąć ponownego pobierania
Biblioteka zdjęć /DATA/Gallery/immich 14 505 zdjęć + 925 filmów + miniatury (134 GiB) ✅ Rzeczywiste pliki multimedialne
Automatyczne kopie zapasowe /DATA/Gallery/immich/backups Ostatnie 14 codziennych migawek bazy danych 💡 Już obecne
🎁 Przeniesienie samych plików ze zdjęciami — bez katalogu pgdata — zapewni Ci wszystkie zdjęcia, ale żaden z albumów, tagów twarzy, osób, wspomnień ani udostępnionych linków. Immich traktuje PostgreSQL jako główne źródło danych. Oba elementy muszą zostać przeniesione razem.

Immich tworzy również automatyczne kopie zapasowe bazy danych codziennie o 2:00 i przechowuje 14 ostatnich w katalogu kopii zapasowych. Przed utworzeniem ręcznego zrzutu sprawdź, czy nie ma tam już aktualnej automatycznej kopii zapasowej.

Metoda: aplikacja Pliki ZimaOS (kopiowanie przez LAN)

Na obu komputerach działa ZimaOS i są połączone z tą samą siecią LAN. Dzięki temu mogłem skorzystać z wbudowanej aplikacji Pliki, aby przesłać dane bezpośrednio przez LAN — bez dysków zewnętrznych, poleceń SCP ani pamięci pośredniczącej.

Krok 1: Zamontuj komputer źródłowy

Na ZimaCube 2 otwórz aplikację Pliki → + Dodaj pamięć masową → Pamięć masowa LAN → wpisz lokalny adres IP komputera źródłowego i uwierzytelnij się. System plików komputera źródłowego pojawi się teraz jako dostępna do przeglądania pamięć masowa na ZimaCube 2.

Krok 2: Zatrzymaj Immich na komputerze źródłowym

Ten krok jest często pomijany, czego później się żałuje. Zatrzymaj Immich przed kopiowaniem. Działająca instancja PostgreSQL nieustannie zapisuje dane — baza musi być w spójnym stanie, z opróżnionym buforem. Na komputerze źródłowym: Sklep z aplikacjami ZimaOS → Immich → Zatrzymaj.

Krok 3: Skopiuj oba katalogi

W aplikacji Pliki na ZimaCube 2 przejdź do zamontowanego źródła i wybierz:

Ścieżka źródłowa Ścieżka docelowa w ZimaCube 2
/DATA/AppData/immich /DATA/AppData/immich
/DATA/Gallery/immich /DATA/Gallery/immich

Wybierz obie lokalizacje i kliknij „Migruj”. Wybierz: Zastąp pliki w lokalizacji docelowej i Zachowaj oryginały w lokalizacji źródłowej — nie usuwaj źródła, dopóki nie zweryfikujesz transferu.

⚡ Przy połączeniu 2,5 GbE w ZimaCube 2 transfer 134 GiB trwa około 10–15 minut. Mój stary serwer DIY był ograniczony do 1 GbE — ten sam transfer trwałby 30–40 minut. Tego rodzaju różnica w rzeczywistym użytkowaniu nie jest widoczna w specyfikacji, ale ma znaczenie za każdym razem, gdy przenosisz dane.

Krok 4: Zainstaluj Immich na ZimaCube 2

Otwórz Sklep z aplikacjami ZimaOS i wyszukaj Immich. Ważne ostrzeżenie: w sklepie mogą być dostępne różne warianty Immich. Musisz zainstalować dokładnie ten sam wariant, którego używa komputer źródłowy:

Immich (oficjalna aplikacja ZimaOS/CasaOS) — użyj jej, jeśli wcześniej korzystałeś właśnie z niej

BigBearCasaOS Immich — inne zmienne docker-compose, inne dane logowania PostgreSQL, inna nazwa bazy danych — niezgodny z bezpośrednim kopiowaniem pgdata z oficjalnej aplikacji

🔑 Zmienne docker-compose — nazwa użytkownika PostgreSQL, hasło, nazwa bazy danych, tryb sieci — są wbudowane w definicję aplikacji. Każda niezgodność między wariantami aplikacji źródłowej i docelowej uniemożliwi Immichowi połączenie się z przywróconą bazą danych. To zdecydowanie najczęstszy problem podczas migracji Immich.

Po instalacji nie uruchamiaj aplikacji od razu. Przy pierwszym uruchomieniu Immich wykryje istniejący katalog pgdata i połączy się z nim zamiast inicjować nową, pustą bazę danych.

Wyszukiwanie aplikacji „immich” w sklepie z aplikacjami ZimaOS / CasaOS podczas konfiguracji NAS-a

Krok 5: Zaloguj się przy użyciu dotychczasowych danych

Otwórz Immich pod adresem http://192.168.x.x:2283 i zaloguj się przy użyciu tej samej nazwy użytkownika i hasła co w instancji źródłowej. Cała biblioteka — albumy, twarze, osoby, ustawienia — będzie wyglądać dokładnie tak samo jak wcześniej.

Ekran powitalny aplikacji Immich z przyciskiem rozpoczęcia po pomyślnej migracji bazy danych

Krok 6: Sprawdź kolejki zadań

Przejdź do Profil → Administracja → Kolejki zadań. Po migracji pgdata baza danych zawiera już wszystkie wcześniej przetworzone wyniki, więc w większości kolejek powinno być wyświetlane Aktywne: 0 / Oczekujące: 0.

Jeśli w którejkolwiek kolejce liczba przy pozycji Brakujące jest większa od zera, kliknij przycisk „Brakujące”, aby przetworzyć tylko nieprzetworzone pliki:

Kolejka Kiedy uruchomić brakujące zadania
Generuj miniatury Jeśli podgląd któregokolwiek zdjęcia jest pusty
Wyodrębnij metadane Jeśli w plikach brakuje danych GPS, lokalizacji lub daty
Inteligentne wyszukiwanie Jeśli wyszukiwanie semantyczne nie zwraca żadnych wyników
Wykrywanie twarzy Jeśli dane o twarzach są niekompletne

Statystyki migracji

Metryka Wartość
Przeniesione zdjęcia 14,505
Przeniesione filmy 925
Łączna ilość danych 134 GiB
Czas transferu (2.5GbE) ~12 minut
Zachowane albumy Wszystkie
Zachowane tagi twarzy Wszystkie
Zachowane udostępnione linki Wszystkie
Utrata danych Zero

Dlaczego warto było przejść na ZimaCube 2

Nie migrowałem po to, żeby uzyskać takie samo działanie. ZimaCube 2 oferuje trzy ulepszenia, z którymi mój stary, samodzielnie złożony serwer ZimaOS nie mógł się równać:

Transfery 2.5GbE. Biblioteki zdjęć rosną. Każda pełna kopia zapasowa, każdy duży import i każda migracja korzystają z 2,5-krotnie większej przepustowości niż w standardowym gigabicie. Dwa porty 2.5GbE w ZimaCube 2 pozwalają mi w pełni wykorzystać przepustowość podczas tworzenia kopii zapasowej, a reszta sieci nadal działa płynnie.

Pamięć masowa NVMe na potrzeby bazy danych. Baza danych PostgreSQL Immich działa znacznie lepiej na NVMe niż na wirujących talerzach. Generowanie miniatur, inteligentne zapytania wyszukiwania, rozpoznawanie twarzy — wszystko to odczytuje dane z pgdata. Na puli NVMe ZimaCube 2 operacje na bazie danych, które wcześniej zacinały się na HDD, teraz wykonują się natychmiast.

Możliwość rozbudowy o 6 zatok. Dziś 134 GiB. A co w przyszłym roku? ZimaCube 2 ma sześć zatok SATA oraz cztery gniazda M.2 w 7. zatoce, dzięki czemu ta biblioteka zdjęć może rosnąć przez lata bez ograniczeń związanych z brakiem miejsca na dane.

IceWhale ZimaCube 2 — 6-zatokowy NAS z widocznymi z przodu zatokami na dyski wymieniane podczas pracy, zapewniający wysoką wydajność prywatnego magazynu danych

Przenieś bibliotekę zdjęć na ZimaCube 2 →

Konfigurujesz własną chmurę zdjęć? Przeczytaj nasz przewodnik po prywatnych urządzeniach do przechowywania danych w chmurze oraz szczegółowy artykuł o Dockerze i CI/CD na ZimaCube 2, a także obejrzyj rozpakowywanie ZimaCube 2 Pro.

Najczęściej zadawane pytania

Czy mogę przenieść Immich na ZimaCube 2 bez utraty albumów i oznaczeń twarzy?

Tak — musisz jednak skopiować zarówno pliki ze zdjęciami, jak i katalog pgdata (bazę danych PostgreSQL). Baza przechowuje wszystkie albumy, wektory twarzy, grupy osób i metadane. Samo przeniesienie zdjęć pozostawi Ci pliki bez uporządkowanej struktury. Skopiuj oba katalogi, aby zachować bibliotekę w całości.

Jaki jest najszybszy sposób przesłania danych Immich do ZimaCube 2?

Jeśli oba urządzenia są w tej samej sieci LAN i korzystają z ZimaOS, użyj wbudowanej aplikacji Pliki z podłączonym magazynem sieciowym LAN. Przy połączeniu 2.5GbE w ZimaCube 2 transfer 134 GiB zajmuje około 10–15 minut. W przypadku większych bibliotek lub urządzeń w różnych sieciach najlepszym kolejnym rozwiązaniem jest zewnętrzny dysk USB.

Czy wersja Immich ze sklepu z aplikacjami ma znaczenie podczas migracji?

Tak — to kluczowe. Sklep z aplikacjami ZimaOS może wyświetlać kilka wariantów Immich (oficjalny i BigBearCasaOS). Korzystają one z różnych zmiennych docker-compose — dane logowania do Postgresa, nazwy baz danych i konfiguracje sieci są niezgodne. Zainstaluj dokładnie ten sam wariant, którego używa komputer źródłowy, w przeciwnym razie przywrócona baza danych nie połączy się.

Czy przed kopiowaniem muszę zatrzymać Immich na komputerze źródłowym?

Tak. Działająca instancja PostgreSQL stale zapisuje dane. Kopiowanie aktywnej bazy danych grozi uzyskaniem niespójnego stanu. Zatrzymaj Immich na komputerze źródłowym, skopiuj foldery, a następnie uruchom go na urządzeniu docelowym. Komputer źródłowy może pozostać wyłączony lub służyć jako kopia zapasowa, dopóki nie sprawdzisz, czy migracja się powiodła.

Ile miejsca potrzebuje Immich na ZimaCube 2?

Zaplanuj miejsce na bibliotekę zdjęć oraz dodatkową przestrzeń na bazę danych PostgreSQL (która rośnie wraz z biblioteką), pamięć podręczną miniatur i transkodowane wersje filmów. Biblioteka o rozmiarze 134 GiB zawierająca 14 500 zdjęć zajmuje łącznie około 150–160 GiB wraz z narzutem. Sześć zatok SATA w ZimaCube 2 zapewnia miejsce na dalszy rozwój.

Centrum kampanii Zima

Więcej do przeczytania

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.