Jak zoptymalizować połączenia z bazą danych Immich dla współbieżnych kontenerów

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.

Aby zoptymalizować połączenia z bazą danych Immich, zmierz łączne zapotrzebowanie na sesje ze strony wszystkich procesów Immich i pozostałych klientów PostgreSQL zamiast najpierw zwiększać max_connections. Baza danych potrzebuje wystarczającej liczby sesji do obsługi rzeczywistego obciążenia oraz zapasu na potrzeby administracyjne, ale nadmierna współbieżność może zwiększać zużycie pamięci i rywalizację o zasoby, nie przyspieszając zapytań.

Na wielokontenerowym serwerze domowym rejestruj liczbę aktywnych, bezczynnych i oczekujących połączeń wraz z opóźnieniami zapytań, użyciem procesora i pamięci oraz opóźnieniami pamięci masowej podczas normalnego użytkowania i jednoczesnego uruchamiania usług. Błąd „too many clients” może wynikać ze zbiorczej konfiguracji, innej usługi lub lawiny restartów, nawet gdy jeden kontener Immich wydaje się mało obciążony.

Przed zmianą limitów zinwentaryzuj wszystkich klientów PostgreSQL

Wypisz każdy proces serwera Immich lub każdą replikę, zadanie migracji lub konserwacji, zadanie tworzenia kopii zapasowej, narzędzie monitorujące oraz niezwiązane z Immich aplikacje łączące się z tą samą instancją PostgreSQL. Jeśli to możliwe, przypisz im osobnych użytkowników bazy danych, aby pg_stat_activity pokazywało, kto utrzymuje sesje. Zapisz bieżącą wartość max_connections i zachowaj jedną administracyjną ścieżkę dostępu na potrzeby reagowania na incydenty.

W dyskusji o Immich „too many clients” znajduje się komentarz projektowy, według którego w tamtym wydaniu Immich używał domyślnej puli o wielkości 10. W osobnej dyskusji z 2026 roku zauważono, że wiele procesów roboczych Immich może utrzymywać osobne pule. Traktuj te liczby jako kontekst dotyczący implementacji w konkretnych wersjach, a nie wartość, którą należy bezrefleksyjnie mnożyć w przyszłych wydaniach. Jeśli baza danych zbliża się do limitu połączeń, gdy Immich jest bezczynny, przed dostosowaniem ustawień Immich ustal, kto odpowiada za te sesje. Jeśli aktywnych sesji jest niewiele, ale zapytania działają wolno, liczba połączeń może być objawem opóźnień po stronie pamięci masowej lub zapytań, a nie głównym wąskim gardłem.

Utwórz budżet połączeń na podstawie zmierzonej współbieżności

Zarezerwuj sesje na potrzeby administracji bazą danych, narzędzi do tworzenia kopii zapasowych i przywracania, migracji oraz monitorowania.

Następnie rozdziel pozostałą liczbę połączeń aplikacji między równocześnie działające procesy Immich i inne aplikacje. Pula powinna być wystarczająco duża, by normalna praca nie czekała bez potrzeby, ale nie większa, niż baza danych jest w stanie efektywnie obsłużyć.

Analiza wielkości puli połączeń PostgreSQL opisuje idealną pulę jako wystarczająco dużą, by obsłużyć normalne zapotrzebowanie, a zarazem możliwie małą, ponieważ mniejsza liczba sesji zaplecza ogranicza rywalizację o zasoby. Zastosuj tę zasadę do zaobserwowanego obciążenia Immich zamiast kopiować wielkość puli serwera WWW z innego obciążenia.

Jeśli dana wersja Immich nie udostępnia obsługiwanego ustawienia rozmiaru puli, nie modyfikuj wewnętrznego kodu tylko po to, by osiągnąć docelową wartość. Kontroluj to, na co masz wpływ: liczbę replik aplikacji, niepowiązanych klientów, czas ponownych uruchomień, nakładanie się kopii zapasowych i wydajność bazy danych. Weryfikuj ponownie obsługiwaną konfigurację po zmianie wersji.

Ogranicz częste nawiązywanie połączeń i oczekiwanie na bazę danych, zanim zwiększysz liczbę sesji

Rozłóż w czasie uruchamianie kontenerów, aby Immich, analityka, zadania tworzenia kopii zapasowych i inne aplikacje nie nawiązywały ponownie połączeń ani nie przeprowadzały migracji jednocześnie. Używaj kontroli stanu i gotowości, które czekają, aż PostgreSQL będzie gotowy do pracy, ale unikaj krótkich pętli ponawiania prób, które powodują lawinę połączeń, gdy baza danych wciąż się odzyskuje.

Poradnik ZimaSpace dotyczący bezpieczeństwa zewnętrznej bazy danych Immich wyznacza ważną granicę: po oddzieleniu PostgreSQL od domyślnego stosu trzeba jawnie określić obowiązki związane z wersjami, rozszerzeniami, uprawnieniami, kopiami zapasowymi i wycofywaniem zmian. Nie należy wdrażać serwera proxy połączeń ani dodatkowego hosta bazy danych wyłącznie po to, by ukryć wolne zapytania lub przeciążoną pamięć masową.

Jeśli wiele sesji jest bezczynnych, a liczba aplikacji jest zasadnie duża, w niektórych architekturach PostgreSQL pośrednik puli połączeń może ograniczyć liczbę sesji zaplecza, ale dopiero po przetestowaniu konkretnej wersji Immich, migracji, semantyki transakcji i obsługi przygotowanych instrukcji. Pula połączeń nie zastąpi naprawy klienta, który zużywa nieproporcjonalnie dużo zasobów, ani rozwiązania problemu przeciążonej bazy danych.

Weryfikacja przy równoczesnym przesyłaniu plików, wyszukiwaniu, zadaniach i ponownym uruchomieniu

Przygotuj powtarzalny test szczytowego obciążenia: wykonuj typowe przesyłanie plików z urządzeń mobilnych, starszą operację wyszukiwania lub przeglądania oraz zwykły zestaw zadań w tle, gdy działają też inne oczekiwane kontenery. Zapisz liczbę połączeń według użytkownika i stanu, błędy przydzielania połączeń lub żądań, opóźnienie zapytań, użycie procesora i pamięci przez bazę danych oraz opóźnienie dysku. Następnie powtórz test po jednej zmianie.

Poprawna konfiguracja utrzymuje liczbę sesji poniżej limitu powodującego awarię, zapewnia zapas dla operacji administracyjnych, zapobiega błędom „too many clients”, utrzymuje opóźnienie zapytań w granicach przyjętych dla domowego środowiska i pozwala opróżnić kolejki po szczytowym obciążeniu. Większa liczba połączeń jest uzasadniona tylko wtedy, gdy żądania rzeczywiście czekają na sesję, a baza danych nadal ma wystarczające zasoby procesora, pamięci i operacji wejścia/wyjścia.

Uruchom ponownie stos aplikacji, a następnie raz hosta, aby przetestować maksymalny skok liczby połączeń. Jeśli problem występuje tylko podczas uruchamiania, popraw kolejność uruchamiania lub obsługę ponownych prób, zamiast podnosić stały limit. Jeśli liczba sesji z czasem rośnie, zapisz użytkowników i zapytania, które je zajmują, a następnie zgłoś ten wzorzec wycieku wraz z wersjami i danymi o stanie połączeń.

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.