Biblioteki zewnętrzne i narzędzia firm trzecich

Jeśli samodzielnie hostowałeś Immich, możesz być przyzwyczajony do funkcji, które wymagają bezpośredniego dostępu do serwera, takich jak biblioteki zewnętrzne lub narzędzia łączące się z bazą danych Immich. Ponieważ PixelUnion jest usługą zarządzaną, niektóre z nich działają inaczej. Ten artykuł wyjaśnia, co jest możliwe, a co nie.

Biblioteki zewnętrzne nie są dostępne

W samodzielnie hostowanej instalacji Immich biblioteka zewnętrzna pozwala Immich odczytywać zdjęcia z folderu, który już istnieje na serwerze lub na podłączonym dysku, na przykład w udziale sieciowym NAS. Immich indeksuje te pliki w miejscu, w którym się znajdują, bez kopiowania ich do własnej przestrzeni dyskowej.

Ta funkcja nie jest dostępna w PixelUnion. Twoje środowisko PixelUnion działa w naszym centrum danych i nie ma dostępu do folderów na Twoim komputerze ani dysku NAS. Z tego samego powodu endpoint API /api/library, który zarządza bibliotekami zewnętrznymi, jest wyłączony.

Zamiast tego wszystkie zdjęcia i filmy w PixelUnion znajdują się w zwykłej bibliotece zarządzanej: pliki są przesyłane do Twojego środowiska i przechowywane przez PixelUnion. Oznacza to również, że masz pełną kontrolę nad wszystkim, co się w niej znajduje. Możesz edytować, przenosić do kosza i usuwać każde zdjęcie, co nie jest możliwe w przypadku plików tylko do odczytu z biblioteki zewnętrznej.

Alternatywy

Aby przenieść zdjęcia z folderu lub dysku NAS do PixelUnion, prześlij je:

• Immich Go: narzędzie wiersza poleceń, które przesyła cały folder za jednym razem. Gdy uruchomisz je ponownie później, prześle tylko nowe pliki. Przykład:

  ./immich-go upload from-folder --server=https://yourname.pixelunion.eu --api-key=YOUR_API_KEY /path/to/your/photos
  

  Zobacz Migracja z innego serwera Immich, aby dowiedzieć się, jak pobrać Immich Go i utworzyć klucz API.

• Aplikacja mobilna: automatycznie twórz kopię zapasową rolki aparatu i innych folderów w telefonie. Zobacz Aplikacja mobilna.

• Interfejs webowy: przeciągnij i upuść pliki lub foldery w przeglądarce. Zobacz Przesyłanie zdjęć.

Masz już własny serwer Immich z biblioteką zewnętrzną? Możesz przenieść tę bibliotekę do PixelUnion za pomocą Immich Go, zobacz Migracja z innego serwera Immich.

Korzystanie z Immich API i narzędzi firm trzecich

Możesz korzystać z Immich API przy użyciu własnych kluczy API, więc większość narzędzi opartych na API działa z PixelUnion. Utwórz klucz API w Ustawieniach konta → Klucze API. Wyłączone są tylko dwa endpointy: /api/library (biblioteki zewnętrzne) i /api/system-config (konfiguracja serwera).

Niektóre narzędzia firm trzecich potrzebują czegoś więcej niż API. Łączą się bezpośrednio z bazą danych Immich lub odczytują system plików serwera. PixelUnion nie zapewnia bezpośredniego dostępu do żadnego z nich, więc takie narzędzia, lub te ich funkcje, które od tego zależą, nie będą działać.

Przykładem jest Immich Power Tools: kilka jego funkcji wysyła zapytania bezpośrednio do bazy danych Immich. Funkcje korzystające wyłącznie z API mogą działać, ale licz się z tym, że część narzędzia będzie niedostępna.

Zanim zaczniesz polegać na narzędziu firmy trzeciej, sprawdź w jego dokumentacji, czy wymaga połączenia z bazą danych lub dostępu do systemu plików.

Usuwanie duplikatów bez dodatkowych narzędzi

Immich ma wbudowane wykrywanie duplikatów. W interfejsie webowym przejdź do Narzędzia → Przejrzyj duplikaty, aby porównać podobne zdjęcia obok siebie i wybrać, które chcesz zachować. Duplikaty są wykrywane dla każdego użytkownika osobno, więc zdjęcia przesłane przez dwóch różnych użytkowników nie są ze sobą porównywane.

Zachowanie struktury albumów w lokalnej kopii zapasowej

Twoje dane są objęte kopią zapasową PixelUnion, zobacz Backup: jak tworzymy kopie zapasowe Twoich danych. Jeśli chcesz mieć również własną kopię lokalną, pamiętaj, że wiele narzędzi do pobierania zapisuje same pliki, ale nie informację o tym, do których albumów należą.

Istnieje kilka sposobów na zachowanie albumów:

1. immich-archiver: nasze własne narzędzie do pobierania zapisuje plik .json obok każdego zdjęcia i filmu, zawierający albumy, do których dany plik należy. Zobacz Pobierz Wszystkie Zdjęcia i Filmy.
2. Pobieranie według albumu: otwórz album w interfejsie webowym i pobierz go. Otrzymasz plik ZIP ze wszystkimi zdjęciami i filmami z tego albumu, ale bez informacji o albumie poza samym folderem.
3. Użyj API: Immich API zwraca wszystkie Twoje albumy i zdjęcia w każdym z nich, więc możesz napisać własny skrypt, jeśli potrzebujesz innej struktury.

Potrzebujesz pomocy?

Nie masz pewności, czy narzędzie lub sposób pracy będzie działać z PixelUnion? Skontaktuj się z naszym zespołem wsparcia, a pomożemy Ci to sprawdzić.