Czy Immich może niezawodnie działać, gdy jego dane znajdują się na udziale sieciowym?

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.

Immich może niezawodnie korzystać z udziału sieciowego na potrzeby multimediów lub biblioteki zewnętrznej, jeśli odpowiednio zaprojektowano i przetestowano montowanie, uprawnienia, opóźnienia oraz zachowanie podczas awarii. Katalog danych PostgreSQL powinien jednak pozostać na obsługiwanym nośniku o niskich opóźnieniach, a nie na ogólnym udziale SMB lub NFS.

Słowo „dane” skrywa różne typy obciążenia: oryginały to duże, trwałe pliki, miniatury generują wiele mniejszych operacji, biblioteki zewnętrzne mogą być tylko do odczytu, a PostgreSQL wymaga semantyki systemu plików odpowiedniej dla bazy danych. Zdecyduj o każdej ścieżce osobno, zamontuj udział przed uruchomieniem kontenerów, nie dopuść, by pusty lokalny katalog udawał NAS, i sprawdź działanie zarówno po ponownym uruchomieniu hosta, jak i podczas kontrolowanego przerwania połączenia z udziałem.

Sklasyfikuj każdą ścieżkę Immich przed jej przeniesieniem

Wymień osobno bibliotekę przesyłanych plików, miniatury lub zakodowane multimedia, biblioteki zewnętrzne, katalog bazy danych, pamięć podręczną modeli i kopie zapasowe. Określ, kto zapisuje dane w każdej ścieżce i jakie są skutki ich utraty. Udział na multimedia może się sprawdzić; traktowanie wszystkich woluminów jako zamiennych nie spełnia wymogów projektu.

Praktyczny poradnik konfiguracji NFS pokazuje, jak podłączyć zewnętrzną bibliotekę Immich ze współdzielonego zasobu. Wzorzec montowania biblioteki zewnętrznej jest przydatny przy planowaniu ścieżek i uprawnień, ale nie dowodzi, że baza danych powinna korzystać z NFS.

Przechowuj PostgreSQL na nośniku zalecanym dla baz danych i chroń go za pomocą natywnych zrzutów oraz kopii zapasowych. Jeśli lokalna pamięć na bieżące dane jest ograniczona, przenieś tylko ścieżkę multimediów zajmującą najwięcej miejsca, co potwierdzono pomiarami, i udokumentuj ten zakres zamiast przenosić cały stan aplikacji.

Zapewnij deterministyczną kolejność montowania udziału zdalnego

Zamontuj udział na hoście, używając jawnie określonych danych uwierzytelniających lub reguł eksportu, stabilnego adresu i zamierzonego trybu odczytu i zapisu. Przed uruchomieniem Immich sprawdź oczekiwaną tożsamość systemu plików i obecność znanego pliku znacznika. Zamontowaną ścieżkę hosta podłącz do kontenerów.

Skonfiguruj menedżera usług tak, aby Immich czekał na zamontowanie udziału i nie uruchamiał się z pustym katalogiem zapasowym. Test rozruchu kończy się powodzeniem tylko wtedy, gdy znacznik jest widoczny w kontenerze, a plik testowy otrzymuje oczekiwanego właściciela; pusty katalog lub plik należący do roota oznacza bezwzględny zakaz uruchomienia.

Uruchom system ponownie raz, gdy udział jest dostępny, a drugi raz podczas okna serwisowego, gdy celowo nie jest dostępny. Pierwszy test kończy się powodzeniem tylko wtedy, gdy znacznik pojawi się przed uruchomieniem Immich; drugi tylko wtedy, gdy Immich zatrzyma się lub wyraźnie zgłosi błąd, zamiast zapisywać do pustego lokalnego punktu montowania.

Udowodnij tożsamość kontenera i uprawnienia do udziału

Dopasuj numeryczne identyfikatory użytkownika i grupy na serwerze, kliencie i w kontenerze, a następnie przetestuj tworzenie, zmianę nazwy, odczyt i usuwanie plików w osobnym folderze testowym. Nie rozwiązuj problemu niedopasowanych uprawnień przez przyznanie globalnego prawa zapisu, które udostępniłoby rodzinną bibliotekę.

Powtórz test na pliku tymczasowym wewnątrz kontenera serwera Immich, a nie tylko na hoście. Upewnij się, że NAS widzi oczekiwany numeryczny identyfikator właściciela i że Immich może ponownie otworzyć plik po odtworzeniu kontenera. Pomyślny test na hoście nie potwierdza poprawności ścieżki w kontenerze.

Jeśli różnią się identyfikatory lub działanie operacji tworzenia i zmiany nazwy, przerwij testy i skoryguj ustawienia eksportu, montowania lub mapowania kontenerów. Przed skanowaniem prawdziwej biblioteki wykonaj test ponownie; szerokie zmiany uprawnień mogą ukryć rozbieżności, a jednocześnie udostępnić wszystkie rodzinne zdjęcia niepowiązanym usługom.

Zmierz opóźnienia i przetestuj przerwę w dostępie do udziału

Przeprowadź reprezentatywne przesyłanie plików, generowanie miniaturek, przeglądanie osi czasu, pobieranie oryginałów i skanowanie zewnętrznej biblioteki, mierząc przy tym opóźnienia serwera i postęp zadań. Test uznaje się za zaliczony, jeśli interakcja jest płynna, a kolejka nie rośnie stale; sama surowa przepustowość łącza nie wystarcza do oceny wydajności operacji na metadanych.

Zgłoszenie dotyczące Immich opisuje niespójność bazy danych i plików w jednym wdrożeniu z niestabilnym NFS. Ograniczony przypadek awarii NFS wskazuje, że rozłączenia podczas zapisu należy traktować jako ryzyko związane z odzyskiwaniem danych, a nie zakładać, że NFS zawsze powoduje uszkodzenie Immich.

W oknie serwisowym, po wykonaniu kopii zapasowych, przerwij dostęp do udziału z multimediami podczas aktywnego, niekrytycznego testu. Immich powinien wyraźnie zgłosić błąd, zamiast zapisywać pliki w pustym punkcie montowania. Przywróć udział i sprawdź, czy zasób testowy oraz rekord w bazie danych są ponownie spójne, bez zapętlenia restartów.

Podejmij decyzję „Go” lub „No-Go” po testach restartu

Uruchom ponownie kontenery i hosta osobno. Upewnij się, że najpierw montowany jest właściwy udział, stare i nowe oryginały otwierają się prawidłowo, skanowanie zewnętrznych bibliotek nie duplikuje zasobów, a nowy przesłany plik pozostaje dostępny po kolejnym restarcie. Porównanie DAS i NAS w ZimaSpace przedstawia kompromis między opóźnieniami a domeną awarii.

Korzystaj z udziału, jeśli testy zakończą się powodzeniem i monitoring będzie ostrzegał o braku udziału, opóźnieniach, wolnym miejscu i presji na liczbę i-węzłów. Wybierz pamięć lokalną lub podłączoną bezpośrednio, gdy sieć albo NAS nie zapewnia wymaganej dostępności lub nie da się zapobiec montowaniu w trybie fail-open.

Wróć do poprzedniej lokalnej ścieżki, jeśli po przerwaniu Immich uruchamia się z pustą biblioteką, tworzy pliki należące do roota lub zgłasza błędy brakujących plików. Eskalując problem, podaj protokół, opcje montowania, identyfikatory, mapowania ścieżek, opóźnienia i kolejność uruchamiania; nigdy nie wykonuj destrukcyjnego ponownego skanowania, dopóki nie ustalisz, które oryginały są nadrzędne, oraz jaki jest stan bazy danych.

Wsparcie i porady

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.