Jellyfin, Seerr i JellyBridge nie są trzema częściami jednej aplikacji ZimaOS. Wątek społeczności IceWhale z czerwca 2026 roku stał się łatwiejszy do zrozumienia po rozdzieleniu stosu na warstwy: Jellyfin to serwer multimediów, Seerr to samodzielna aplikacja do obsługi zapytań o multimedia, a JellyBridge to wtyczka Jellyfin, która łączy funkcje wyszukiwania w Jellyfin i działania związane z zapytaniami z Seerr.
Autor pierwotnego wpisu miał już uruchomiony Jellyfin ze Sklepu aplikacji ZimaOS, ale nie mógł uruchomić pozostałych elementów stosu. Odpowiedzi społeczności zalecały diagnozowanie każdej warstwy niezależnie, zamiast zmieniania wszystkiego naraz. Później inny użytkownik potwierdził, że Jellyfin i Seerr działały u niego prawidłowo na ZimaBoard 2, podczas gdy stos Sonarr/Radarr działał na osobnym Raspberry Pi. Pokazuje to, że te usługi nie muszą działać w tym samym kontenerze ani nawet na tej samej maszynie, o ile adresy URL, dane uwierzytelniające API i trasy sieciowe są poprawne.
Najpierw poznaj stos Jellyfin → Seerr → JellyBridge
Najprościej myśleć o tej konfiguracji w następujący sposób:
- Jellyfin: udostępnia i zarządza istniejącymi bibliotekami filmów i seriali.
- Seerr: udostępnia funkcje wyszukiwania i zapytań o multimedia, a następnie wysyła zatwierdzone zapytania do Sonarr i Radarr.
- Sonarr/Radarr: obsługują procesy pozyskiwania seriali telewizyjnych i filmów.
- JellyBridge: działa w Jellyfin jako wtyczka i komunikuje się z Seerr, dzięki czemu wyszukiwanie lub dodawanie ulubionych w Jellyfin może tworzyć zapytania.
Obecna dokumentacja Seerr opisuje Seerr jako menedżer zapytań o multimedia i ich wyszukiwania dla Jellyfin, Plex i Emby, z natywną integracją z Sonarr i Radarr. Seerr zwykle działa jako osobny kontener Docker i udostępnia interfejs webowy na porcie 5055. Zobacz aktualny przewodnik Seerr dotyczący rozpoczęcia pracy.
Seerr jest obecnym następcą Jellyseerr i Overseerr
W jednej z odpowiedzi społeczności zauważono, że Seerr zastąpił starszą aplikację Jellyseerr. Obecna dokumentacja projektu Seerr potwierdza, że Seerr jest wspólnym następcą dla użytkowników Jellyseerr i Overseerr.
Ma to znaczenie, ponieważ w starszej dokumentacji JellyBridge, na zrzutach ekranu, w zmiennych środowiskowych lub nazwach kontenerów może nadal pojawiać się Jellyseerr. Obecny projekt JellyBridge stwierdza, że Seerr 3.x korzysta ze zgodnego interfejsu API w przetestowanej integracji, zachowując jednak terminologię Jellyseerr w części swojej dokumentacji.
Jeśli dopiero tworzysz ten stos, zacznij od aktualnej wersji Seerr, zamiast celowo instalować przestarzałą wersję Jellyseerr, chyba że konkretna wersja wtyczki wyraźnie jej wymaga.
Krok 1: Uruchom Seerr przed zainstalowaniem JellyBridge
Nie diagnozuj JellyBridge, dopóki sam Seerr nie działa prawidłowo. Zainstaluj Seerr jako oddzielną aplikację Docker w ZimaOS lub użyj obsługiwanego źródła aplikacji dostępnego w Twoim systemie.
Po instalacji bezpośrednio sprawdź interfejs internetowy Seerr:
http://ZIMAOS_LAN_IP:5055
Port hosta może być inny, jeśli mapowanie kontenera w ZimaOS używa innego portu zewnętrznego. Użyj portu po stronie hosta wyświetlanego w rzeczywistych ustawieniach aplikacji.
Jeśli Seerr się nie otwiera, przed sprawdzaniem Jellyfin sprawdź kontener:
docker ps
docker images
docker logs SEERR_CONTAINER_NAME --tail 100
Te polecenia były pierwszymi czynnościami diagnostycznymi sugerowanymi w wątku społeczności. Jeśli polecenia Docker wymagają podwyższonych uprawnień na hoście w Twojej wersji ZimaOS, użyj autoryzowanego procesu pracy w terminalu zamiast osłabiać uprawnienia do gniazda Docker.
Krok 2: Połącz Seerr z Jellyfin
Podczas konfiguracji Seerr skonfiguruj Jellyfin przy użyciu konta administratora Jellyfin. Aktualna dokumentacja Seerr wskazuje, że strona ustawień Jellyfin odpowiada za połączenie z serwerem i synchronizację bibliotek.
Przed kontynuowaniem potwierdź następujące kwestie:
- Seerr może połączyć się z wprowadzonym adresem URL Jellyfin.
- Konto Jellyfin użyte podczas konfiguracji ma wymagane uprawnienia administratora.
- Biblioteki Jellyfin pojawiają się w Seerr po synchronizacji.
- Ręczne skanowanie biblioteki kończy się pomyślnie.
Zapoznaj się z przewodnikiem Seerr dotyczącym ustawień serwera multimediów, aby poznać aktualny proces łączenia z Jellyfin.
Krok 3: Połącz Seerr z Sonarr i Radarr
Seerr samodzielnie nie pobiera multimediów. Przekazuje zatwierdzone żądania do Sonarr i Radarr, które następnie koordynują działanie pozostałych elementów stosu automatyzacji.
Sonarr i Radarr mogą działać:
- na tym samym hoście ZimaOS;
- w oddzielnych kontenerach Docker;
- na innym serwerze domowym;
- albo, jak opisał to jeden z użytkowników społeczności, na oddzielnym Raspberry Pi.
Najważniejsza jest osiągalność. Seerr musi używać adresu, który działa z poziomu kontenera Seerr lub kontekstu hosta. Adres URL działający w przeglądarce na laptopie nie jest automatycznie prawidłowym adresem komunikacji między kontenerami.
Nie zakładaj, że kontenery ze Sklepu aplikacji ZimaOS współdzielą tę samą sieć Docker
Najbardziej użyteczna uwaga dotycząca sieci w odpowiedzi społeczności była taka, że kontener Jellyfin zainstalowany ze Sklepu aplikacji ZimaOS może nie widzieć automatycznie kontenera Seerr zainstalowanego ręcznie po jego nazwie.
Jeśli oba kontenery znajdują się w tej samej zdefiniowanej przez użytkownika sieci Dockera, możesz użyć nazwy usługi, takiej jak:
http://seerr:5055
może działać. Jeśli znajdują się w różnych sieciach Dockera, użyj zamiast tego osiągalnego adresu hosta i opublikowanego portu, na przykład:
http://ZIMAOS_LAN_IP:5055
Nie używaj localhost swobodnie między kontenerami. Wewnątrz kontenera Jellyfin localhost odnosi się do samego kontenera Jellyfin, a nie do oddzielnego kontenera Seerr.
Krok 4: Zainstaluj JellyBridge wewnątrz Jellyfin
JellyBridge to wtyczka Jellyfin, a nie kolejna aplikacja ZimaOS, która ma zastąpić Jellyfin. Aktualna metoda instalacji projektu zaleca dodanie repozytorium wtyczki za pośrednictwem interfejsu administracyjnego Jellyfin.
W Jellyfin:
- Otwórz Pulpit nawigacyjny > Wtyczki.
- Otwórz zarządzanie repozytoriami.
- Dodaj adres URL repozytorium wtyczki JellyBridge podany przez projekt.
- Otwórz katalog wtyczek.
- Zainstaluj kompilację JellyBridge zgodną z używaną wersją Jellyfin.
- Uruchom ponownie Jellyfin.
Aktualne repozytorium JellyBridge zawiera informacje o kompilacjach wtyczki przeznaczonych dla poszczególnych wersji Jellyfin 10.10 i 10.11. Przed wyborem pakietu sprawdź informacje o zgodności. Zobacz dokumentację projektu JellyBridge.
Krok 5: Skonfiguruj JellyBridge, aby łączył się z Seerr
Po ponownym uruchomieniu Jellyfin otwórz konfigurację wtyczki JellyBridge i podaj:
- adres URL Seerr dostępny z Jellyfin;
- klucz API Seerr wymagany przez wtyczkę;
- dedykowany katalog na dane biblioteki JellyBridge;
- zachowanie synchronizacji, którego chcesz używać.
Przed zaimportowaniem zawartości Discover użyj funkcji Test Connection wtyczki. Jeśli test się nie powiedzie, nie twórz jeszcze kolejnych bibliotek. Najpierw popraw adres URL Seerr, sieć Dockera lub klucz API.
Krok 6: Utwórz bibliotekę Discover JellyBridge
JellyBridge tworzy zawartość zastępczą i odkrytą, którą Jellyfin może wyświetlać jako bibliotekę. Aktualna dokumentacja wtyczki zawiera procedurę konfiguracji w samej wtyczce, umożliwiającą wygenerowanie i skonfigurowanie tej biblioteki.
Oddziel tę bibliotekę od rzeczywistych ścieżek multimediów z filmami i serialami. Elementy wykryte przez JellyBridge nie zastępują prawdziwych plików zarządzanych przez Sonarr, Radarr i Jellyfin.
Gdy użytkownicy dodadzą obsługiwane elementy z sekcji Discover do ulubionych w Jellyfin, JellyBridge może wysłać odpowiednie żądanie do Seerr. Następnie Seerr zajmuje się zatwierdzeniem i przekazuje żądanie do Sonarr lub Radarr zgodnie z konfiguracją.
Społecznościowy przykład ZimaBoard 2
Późniejszy uczestnik powiedział, że uruchomił Jellyfin i nowszą aplikację Seerr razem na ZimaBoard 2, podczas gdy jego stos ARR działał na Raspberry Pi 4. To przydatny dowód na to, że taka architektura może obejmować wiele systemów.
Obecnie oferowaną ścieżką produktową dla sprzętu ZimaBoard jest jednopłytkowy serwer ZimaBoard 2.
Odpowiedź nie zawierała dokładnych plików Docker Compose ani ustawień sieciowych użytkownika, dlatego nie należy traktować jej jako zweryfikowanej konfiguracji gotowej do skopiowania i wklejenia. Jej wartość ma charakter architektoniczny: usługi mogą być rozdzielone, o ile każdy punkt końcowy integracji jest osiągalny.
Rozwiązywanie problemów ze stosem w tej kolejności
- Potwierdź, że Jellyfin działa niezależnie.
- Potwierdź, że kontener Seerr pozostaje uruchomiony.
- Otwórz bezpośrednio interfejs internetowy Seerr.
- Potwierdź, że Seerr może uwierzytelnić się w Jellyfin i zsynchronizować biblioteki.
- Potwierdź, że Seerr może połączyć się z Sonarr i Radarr.
- Zainstaluj wersję JellyBridge zgodną z używaną wersją Jellyfin.
- Potwierdź, że JellyBridge może przetestować połączenie z Seerr.
- Utwórz bibliotekę wykrywania JellyBridge dopiero po pomyślnym przejściu testu połączenia.
- Wyślij jedno żądanie z Jellyfin i potwierdź, że pojawiło się w Seerr.
- Następnie sprawdź, czy Seerr przekazuje żądanie do właściwej instancji Sonarr lub Radarr.
Często zadawane pytania dotyczące Jellyfin, Seerr i JellyBridge
Czy Seerr potrzebuje własnego kontenera Docker?
Tak. Seerr to samodzielna aplikacja do zarządzania żądaniami. JellyBridge to wtyczka Jellyfin, która się z nią komunikuje.
Czy JellyBridge powinien pojawić się jako aplikacja w sklepie ZimaOS App Store?
Niekoniecznie. Obecny projekt JellyBridge jest dystrybuowany jako wtyczka Jellyfin instalowana za pośrednictwem systemu repozytoriów wtyczek Jellyfin.
Dlaczego localhost:5055 nie działa z JellyBridge?
Jeśli Jellyfin i Seerr działają w osobnych kontenerach, localhost wewnątrz Jellyfin wskazuje z powrotem na kontener Jellyfin. Użyj współdzielonej nazwy usługi w sieci Docker lub adresu hosta/IP, do którego kontener Jellyfin ma rzeczywiście dostęp.
Czy powinienem zainstalować Jellyseerr czy Seerr?
W przypadku nowego wdrożenia Seerr jest obecnie utrzymywaną ścieżką migracji. Dokumentacja JellyBridge nadal zawiera terminologię Jellyseerr i informacje o zgodności, ponieważ przejście jest niedawne, dlatego sprawdź zgodność swojej wersji JellyBridge z instalowaną wersją Seerr.
Czy Sonarr i Radarr mogą działać na innym serwerze?
Tak. Użytkownik społeczności opisał dokładnie taki układ. Seerr potrzebuje jedynie dostępu sieciowego do punktów końcowych API Sonarr/Radarr oraz prawidłowych kluczy API; aplikacje nie muszą działać na tym samym fizycznym serwerze.
