Jak skonfigurować biblioteki zewnętrzne Immich jako źródła tylko do odczytu

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.

Zewnętrzna biblioteka Immich indeksuje zdjęcia, które znajdują się poza zarządzanym katalogiem przesyłanych plików. Zamontowanie tego źródła tylko do odczytu chroni oryginały przed pomyłkami aplikacji lub operatora, ale Immich nadal potrzebuje pamięci z uprawnieniami do zapisu na miniatury, zakodowane filmy, dane profilu i stan bazy danych.

Konfiguracja wykorzystuje więc dwie strefy zaufania: niezmienne foldery źródłowe i zapisywalne dane wygenerowane. Mała biblioteka pilotażowa powinna przejść testy wykrywania, metadanych, miniatur, ponownego skanowania i usuwania, zanim zostanie dodane duże archiwum. Taki pilotaż potwierdza również zgodność ścieżki w kontenerze, własności plików i planu odzyskiwania.

Mapuj osobno źródło i pamięć zarządzaną

Wybierz ścieżkę na hoście dla istniejącego archiwum oraz odrębną ścieżkę w kontenerze, taką jak /external/family-photos. Nie umieszczaj jej w katalogu przesyłanych plików Immich, ponieważ zasoby zewnętrzne i zarządzane podlegają różnym zasadom cyklu życia.

Przepływ pracy z zewnętrzną biblioteką Immich wymaga, aby serwer miał dostęp do ścieżki przypisanej użytkownikowi. Zapisz obie strony montowania, aby administrator nie wkleił do aplikacji ścieżki dostępnej wyłącznie na hoście.

Upewnij się, że lokalizacje Immich z uprawnieniami do zapisu dla przesyłanych plików, miniatur, zakodowanych filmów i danych bazy danych są objęte standardowym monitorowaniem kopii zapasowych i wolnego miejsca. Oryginały tylko do odczytu nie chronią wygenerowanych danych ani rekordów zasobów, dzięki którym biblioteka jest użyteczna.

Zastosuj montowanie kontenera tylko do odczytu

Dodaj archiwum jako montowanie bind z flagą tylko do odczytu w Compose lub menedżerze kontenerów. Typowy wzorzec mapuje /srv/photos/archive na hoście na /external/archive w kontenerze, z :ro.

Przyznaj procesowi kontenera uprawnienia do przechodzenia przez wszystkie katalogi nadrzędne i odczytu ich zawartości. Tylko do odczytu nie oznacza braku wymaganych uprawnień: brak uprawnienia do wykonywania w katalogu uniemożliwia wyszukiwanie, nawet jeśli poszczególne pliki można odczytać.

Jeśli źródłem jest udział sieciowy, ustabilizuj montowanie na hoście, zanim uruchomi się kontener. Przewodnik po niezawodnym dostępie Immich do udziałów sieciowych wyjaśnia różnicę między dostępną ścieżką a niezawodną zależnością aplikacji.

Dodaj zewnętrzną bibliotekę pilotażową i przeskanuj ją

Utwórz lub wybierz użytkownika Immich, który będzie właścicielem biblioteki, dodaj bibliotekę zewnętrzną i podaj ścieżkę importu widoczną dla kontenera. Zacznij od katalogu zawierającego kopie lub niekrytyczne oryginały, zamiast wskazywać całe archiwum.

Uruchom skanowanie i sprawdź, czy pojawiły się oczekiwane liczby zdjęć i filmów. Otwórz zasoby z podfolderów, sprawdź daty i lokalizacje oraz potwierdź, że miniatury i zakodowane podglądy są zapisywane w zarządzanej pamięci, a nie obok oryginałów.

Na hoście porównaj daty modyfikacji lub sumy kontrolne pliku źródłowego użytego do testu przed skanowaniem i po nim. Spróbuj też utworzyć plik w zamontowanej ścieżce z poziomu kontenera; operacja powinna się nie powieść, a odczyt powinien działać.

Testowanie ponownego skanowania, brakujących plików i odzyskiwania

Dodaj jeden plik do źródła na hoście, uruchom ponowne skanowanie i sprawdź, czy plik się pojawi. Następnie tymczasowo przenieś plik testowy poza źródło, ponownie skanuj i sprawdź, jak zainstalowana wersja Immich oznacza lub usuwa rekord zasobu, zanim powtórzysz to na rzeczywistych danych.

Utwórz kopię zapasową bazy danych i danych Immich z prawem zapisu zgodnie ze swoim standardowym planem odzyskiwania. Oryginały zewnętrzne wymagają osobnej, niezależnej kopii zapasowej, ponieważ montowanie aplikacji tylko do odczytu nie chroni przed awarią dysku, usunięciem po stronie hosta ani uszkodzeniem danych.

Warunek zaliczenia testu jest taki: Immich może indeksować archiwum i wyświetlać jego zawartość, ale nie może w nim nic zapisywać, a archiwum można odbudować bez traktowania zewnętrznego źródła jak zarządzanych przesłanych plików. Przerwij test, jeśli wśród oryginałów pojawią się wygenerowane pliki lub brakujące montowanie zostanie uznane za pustą bibliotekę.

Często zadawane pytania

Czy montowanie tylko do odczytu uniemożliwia Immich usunięcie oryginału? Uniemożliwia zapisy za pośrednictwem tego montowania kontenera. Nie chroni przed usunięciem po stronie hosta, innym udziałem z prawem zapisu, awarią systemu plików ani zmianą trybu montowania przez administratora.

Gdzie trafiają miniatury biblioteki zewnętrznej? Pozostają w zarządzanej przez Immich lokalizacji z prawem zapisu. Trzymaj ją oddzielnie od oryginałów dostępnych tylko do odczytu i uwzględnij ją w planie odzyskiwania wraz z bazą danych.

Czy kilku użytkowników może indeksować ten sam folder zewnętrzny? Nie przypisuj folderu wielu właścicielom, dopóki nie przetestujesz działania konkretnej wersji. Zduplikowane indeksowanie może prowadzić do niejasności związanych z własnością i udostępnianiem.

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.