Docker Compose dla stosu arr: Prowlarr, Sonarr, Radarr
Skonfiguruj Prowlarr, Sonarr, Radarr oraz qBittorrent w jednym pliku Docker Compose. Dowiedz się, jak poprawnie ustawić PUID, PGID i wolumeny, aby zapewnić działanie hardlinków.
Co budujesz
Stos Docker Compose typu arr składa się z czterech kontenerów zarządzających biblioteką multimediów: Prowlarr do obsługi indeksatorów, Sonarr do seriali, Radarr do filmów oraz qBittorrent jako klient pobierania. Komunikują się one ze sobą wewnątrz sieci Compose za pomocą nazw usług i współdzielą jedno drzewo katalogów na hoście. Instalacja jest krótka. Elementem decydującym o tym, czy stos będzie działał bezawaryjnie przez lata, czy sprawiał problemy co tydzień, jest struktura wolumenów, dlatego większość tego przewodnika poświęcono właśnie temu zagadnieniu.
Stos nie wyszukuje treści za użytkownika. Prowlarr przechowuje dodane do niego indeksatory, a wybór konkretnych indeksatorów oraz odpowiedzialność prawna z tym związana należą do użytkownika. Ten przewodnik opisuje infrastrukturę: użytkowników, ścieżki, uprawnienia, sieciowanie kontenerów oraz testy weryfikujące poprawność działania.
Jeśli nigdy nie tworzyłeś pliku Compose, przeczytaj najpierw podstawy Docker Compose dla VPS. Ten wpis zakłada, że docker compose version wyświetla już wynik na Twoim serwerze. Użyj Docker Engine 28.0.0 lub nowszego: starsze wydania pozwalają hostom w tym samym segmencie sieci lokalnej na dostęp do portów opublikowanych na localhost.
Dlaczego hardlinki przestają działać i dlaczego to kluczowa kwestia
Gdy Sonarr kończy pobieranie, importuje plik do biblioteki. Jeśli folder pobierania i folder biblioteki znajdują się na tym samym systemie plików, a obsługa hardlinków jest włączona, Sonarr próbuje utworzyć hardlink: drugą nazwę wskazującą na te same dane na dysku. Nie zajmuje to dodatkowego miejsca ani czasu. Torrent kontynuuje seedowanie pod starą nazwą, podczas gdy serwer multimediów odczytuje plik pod nową.
Jeśli oba foldery znajdują się na różnych systemach plików, jądro nie może utworzyć takiego dowiązania. Sonarr przełącza się wtedy na kopiowanie. Sezon o rozmiarze 40 GB zajmuje teraz 80 GB miejsca na dysku i wymaga kilku minut operacji wejścia/wyjścia. Sonarr loguje błędy hardlinków między systemami plików na poziomie Trace, a inne wyjątki dotyczące hardlinków na poziomie Debug, więc standardowe logi nie gwarantują wyświetlenia komunikatu o błędzie. Na serwerze VPS z ograniczonym miejscem na dysku w ten sposób można wyczerpać przestrzeń w ciągu tygodnia.
Oto pułapka. Wewnątrz kontenera bind mount stanowi granicę systemu plików. Jeśli zamontujesz /mnt/data/torrents jako /downloads oraz /mnt/data/media jako /tv, to mimo że oba znajdują się na jednym dysku hosta, Sonarr widzi dwa oddzielne punkty montowania i nie może utworzyć hardlinka między nimi. Oficjalna dokumentacja obrazu LinuxServer.io mówi o tym wprost: używanie oddzielnych ścieżek /downloads oraz /tv uniemożliwia korzystanie z hardlinków.
Rozwiązaniem jest jeden punkt montowania. Każdy kontener obsługujący multimedia otrzymuje ten sam pojedynczy wolumen, /mnt/data:/data, a każda używana przez niego ścieżka jest folderem wewnątrz tego wolumenu. Jeden punkt montowania, jeden system plików, działające hardlinki.
Utworzenie użytkownika, grupy i katalogów
Kontenery zapisują pliki przy użyciu numerycznego identyfikatora użytkownika, określonego przez PUID oraz PGID. Należy użyć własnego konta, aby móc odczytywać i edytować te pliki przez SSH bez użycia sudo.
id -u
id -gObie wartości zazwyczaj zwracają 1000 na świeżej instalacji Ubuntu VPS. Teraz należy zbudować strukturę katalogów. Należy umieścić ją na dysku, na którym przechowywane są multimedia, i zachować całe drzewo na tym samym nośniku.
sudo mkdir -p /mnt/data/torrents/movies /mnt/data/torrents/tv
sudo mkdir -p /mnt/data/media/Movies /mnt/data/media/Shows
sudo chown -R 1000:1000 /mnt/data
sudo chmod -R 775 /mnt/dataPrzed przejściem dalej należy sprawdzić, czy faktycznie jest to jeden system plików:
df --output=source,target /mnt/data/torrents /mnt/data/mediaObie linie muszą wskazywać to samo urządzenie źródłowe. Dwa różne urządzenia oznaczają, że hardlinki nie będą działać, niezależnie od konfiguracji kontenera.
Katalogi bibliotek zostały celowo nazwane Movies oraz Shows. Jeśli użytkownik korzysta już z Jellyfin jako serwera multimediów, należy zamontować /mnt/data/media w Jellyfin jako /media, dzięki czemu biblioteki znajdą się w /media/Movies oraz /media/Shows, dokładnie tam, gdzie wskazuje wspomniany przewodnik.
Plik środowiskowy
Przechowuj wartości zmienne dla każdego serwera w .env, obok pliku Compose.
mkdir -p ~/arr && cd ~/arrUtwórz ~/arr/.env:
PUID=1000
PGID=1000
TZ=Etc/UTC
DATA_ROOT=/mnt/dataUstaw TZ na własną strefę czasową, na przykład Europe/Berlin. Aplikacje z rodziny arr planują zadania i oznaczają wpisy w logach zgodnie z tą strefą, więc błędna wartość utrudnia późniejszą analizę dzienników.
Plik Compose
Wpisz ~/arr/docker-compose.yml:
services:
prowlarr:
image: lscr.io/linuxserver/prowlarr:latest
container_name: prowlarr
environment:
- PUID=${PUID}
- PGID=${PGID}
- TZ=${TZ}
volumes:
- ./config/prowlarr:/config
ports:
- 127.0.0.1:9696:9696
restart: unless-stopped
sonarr:
image: lscr.io/linuxserver/sonarr:latest
container_name: sonarr
environment:
- PUID=${PUID}
- PGID=${PGID}
- TZ=${TZ}
volumes:
- ./config/sonarr:/config
- ${DATA_ROOT}:/data
ports:
- 127.0.0.1:8989:8989
restart: unless-stopped
radarr:
image: lscr.io/linuxserver/radarr:latest
container_name: radarr
environment:
- PUID=${PUID}
- PGID=${PGID}
- TZ=${TZ}
volumes:
- ./config/radarr:/config
- ${DATA_ROOT}:/data
ports:
- 127.0.0.1:7878:7878
restart: unless-stopped
qbittorrent:
image: lscr.io/linuxserver/qbittorrent:latest
container_name: qbittorrent
environment:
- PUID=${PUID}
- PGID=${PGID}
- TZ=${TZ}
- WEBUI_PORT=8080
- TORRENTING_PORT=6881
volumes:
- ./config/qbittorrent:/config
- ${DATA_ROOT}:/data
ports:
- 127.0.0.1:8080:8080
- 6881:6881
- 6881:6881/udp
stop_grace_period: "10s"
restart: unless-stoppedCztery elementy w tym pliku wykonują właściwą pracę.
${DATA_ROOT}:/data jest identyczny w trzech kontenerach, które mają dostęp do multimediów. Prowlarr go nie otrzymuje, ponieważ Prowlarr nigdy nie otwiera plików multimedialnych.
Każdy port sieciowy jest powiązany z 127.0.0.1, więc Docker publikuje go wyłącznie na adresie loopback. Zwykły 8989:8989 opublikowałby go na każdym interfejsie, a własne reguły firewalla Dockera przepuściłyby ten ruch bezpośrednio z pominięciem reguły ufw deny. To zachowanie stale zaskakuje użytkowników i zostało wyjaśnione w dlaczego Docker publikuje porty z pominięciem ufw.
Port 6881 jest celowo publikowany na wszystkich interfejsach. Jest to port nasłuchiwania torrentów, który musi być osiągalny dla przychodzących połączeń od peerów. To samo zachowanie Dockera ma tu zastosowanie, więc nie potrzebujesz dla niego reguły ufw, a jej dodanie niczego nie zmieni. Dokumentacja Dockera, sprawdzona 8 listopada 2026, podaje, że ruch do opublikowanego portu jest trasowany, zanim dotrze do łańcuchów używanych przez ufw, więc sudo ufw allow 6881 nie ma wpływu na ten port. Docker publikuje go na wszystkich interfejsach hosta natychmiast po uruchomieniu kontenera, a reguła ufw deny również go nie zamknie. Jeśli kiedykolwiek zajdzie potrzeba ograniczenia dostępu do tego portu, dokumentacja Dockera wskazuje na reguły w łańcuchu DOCKER-USER przy domyślnym backendzie iptables; backend nftables wymaga natomiast reguł w oddzielnej tablicy nftables. Używaj ufw dla usług, które nie działają w Dockerze, takich jak SSH, i przeczytaj podstawy firewalla ufw dla VPS, jeśli to narzędzie jest nowe.
Katalogi konfiguracyjne są oddzielne dla każdej aplikacji, a współdzielony jest tylko wolumen z multimediami. Utwórz je przed pierwszym uruchomieniem, aby ich właścicielem był użytkownik, a nie root:
mkdir -p ~/arr/config/prowlarr ~/arr/config/sonarr ~/arr/config/radarr ~/arr/config/qbittorrent
docker compose up -d
docker compose psWszystkie cztery usługi powinny odczytywać running. Według stanu na 8 listopada 2026 obrazy te są publikowane w lscr.io, a tag latest wskazuje na bieżące stabilne wydanie, więc przypnij konkretny tag wersji, jeśli chcesz, aby aktualizacje były świadomą decyzją, a nie niespodzianką.
Bezpieczny dostęp do interfejsów WWW
Interfejsy WWW są powiązane z interfejsem loopback. Przekieruj je przez SSH ze swojej maszyny:
ssh -L 9696:127.0.0.1:9696 -L 8989:127.0.0.1:8989 \
-L 7878:127.0.0.1:7878 -L 8080:127.0.0.1:8080 you@your-serverTeraz http://127.0.0.1:8989 w przeglądarce pozwala uzyskać dostęp do Sonarr na serwerze. Aby uzyskać stały dostęp, umieść stos za Traefik z certyfikatami TLS dla wielu aplikacji lub połącz się z serwerem przez samodzielnie hostowany VPN WireGuard. Sam VPN nie zapewnia jednak dostępu do tych portów. Dokumentacja Docker, sprawdzona 8 listopada 2026 r., podaje, że w przypadku Docker Engine 28.0.0 lub nowszego oraz domyślnej konfiguracji bridge, tylko host Docker może uzyskać dostęp do portu opublikowanego na adresie localhost. Aby korzystać z VPN, należy albo utrzymać tunel SSH przez to połączenie, albo zmienić powiązania w pliku Compose z 127.0.0.1 na adres serwera w interfejsie VPN. Żadna z tych aplikacji nie powinna być wystawiona bezpośrednio do publicznego Internetu, chroniona jedynie własną stroną logowania. Jeśli wybierzesz rozwiązanie z reverse proxy i wolisz jedno konto dla wszystkich czterech interfejsów zamiast zarządzania czterema oddzielnymi logowaniami, Authentik zapewnia samodzielnie hostowane logowanie jednokrotne (SSO), które Traefik może wymuszać przy każdym żądaniu za pomocą forward auth. Sonarr i Radarr mają dwie specyficzne cechy podczas pracy za proxy, więc przed skierowaniem ruchu przez Traefik, przeczytaj jak uruchomić Sonarr i Radarr za reverse proxy, aby poznać wpisy Allowed Hosts, które eliminują błędy Invalid Hostname, oraz powód, dla którego /api musi pominąć logowanie.
qBittorrent generuje losowe hasło administratora przy pierwszym uruchomieniu i wypisuje je w dzienniku kontenera. Odczytaj je, a następnie zmień w interfejsie WWW:
docker compose logs qbittorrent | grep -i passwordJeśli pominiesz tę zmianę, przy każdym restarcie generowane będzie nowe losowe hasło, co zmusi do ponownego sprawdzania dzienników.
Ustawienie ścieżek wewnątrz każdej aplikacji
W qBittorrent otwórz Options, następnie Downloads i ustaw domyślną ścieżkę zapisu na /data/torrents. Folder dla nieukończonych pobrań (incomplete-downloads) powinien znajdować się w tym samym drzewie katalogów, na przykład /data/torrents/incomplete. Pobieranie zakończone poza /data uniemożliwi utworzenie twardego dowiązania (hardlink) do biblioteki przy użyciu tego pliku Compose.
W Sonarr otwórz Settings, następnie Media Management i dodaj folder główny /data/media/Shows. W Radarr folderem głównym jest /data/media/Movies. Są to ścieżki wewnątrz kontenera. Ścieżka hosta /mnt/data/media/Shows zostanie odrzucona, ponieważ ten katalog nie istnieje z punktu widzenia kontenera.
Zarówno w Sonarr, jak i w Radarr otwórz Settings, następnie Download Clients i dodaj qBittorrent. Hostem jest qbittorrent, a portem 8080. Nazwa usługi działa jako nazwa hosta, ponieważ Compose umieszcza wszystkie cztery kontenery w jednej sieci z wewnętrzną usługą DNS (domain name system). Nie używaj tutaj localhost: wewnątrz kontenera Sonarr, localhost to Sonarr.
Pozostaw Remote Path Mappings puste. Ta funkcja służy do tłumaczenia ścieżki zgłaszanej przez klienta pobierania na ścieżkę widoczną dla aplikacji typu arr. Dzięki jednemu współdzielonemu punktowi montowania /data, oba kontenery są zgodne co do każdej ścieżki, co stanowi drugi powód, dla którego warto zastosować ten układ.
Łączenie Prowlarr z Sonarr i Radarr
Prowlarr przesyła definicje indeksatorów do pozostałych aplikacji, dzięki czemu konfigurację indeksatora wykonuje się tylko raz. Wymagany jest do tego klucz API (application programming interface) z każdej z nich.
W Sonarr otwórz Settings, następnie General i skopiuj klucz API. W Prowlarr otwórz Settings, następnie Apps, dodaj aplikację Sonarr i wypełnij trzy pola. Prowlarr Server to http://prowlarr:9696. Sonarr Server to http://sonarr:8989. API Key to skopiowana wcześniej wartość. Naciśnij Test. Zielony wynik oznacza, że Prowlarr uzyskał połączenie z Sonarr poprzez sieć Compose. Powtórz procedurę dla Radarr pod adresem http://radarr:7878.
Czerwony wynik z komunikatem o odrzuceniu połączenia oznacza, że żądanie nie dotarło do usługi nasłuchującej pod skonfigurowanym adresem i portem. Potwierdź, czy nazwa jest poprawnie rozpoznawana z wnętrza kontenera:
docker compose exec prowlarr curl -sS -o /dev/null -w '%{http_code}\n' http://sonarr:8989Kod stanu HTTP potwierdza poprawność ścieżki sieciowej. Błąd rozpoznawania nazwy oznacza, że nazwa usługi nie została rozwiązana; sprawdź jej pisownię oraz czy oba kontenery działają w tej samej sieci Compose.
Weryfikacja działania twardych dowiązań (hardlinks)
Nie należy ufać konfiguracji, dopóki nie zostanie zweryfikowana liczba dowiązań. Po zaimportowaniu jednego elementu należy porównać pobrany plik z plikiem w bibliotece:
stat -c '%i %h %n' /mnt/data/torrents/tv/*/*.mkv
stat -c '%i %h %n' /mnt/data/media/Shows/*/*/*.mkvPierwsza liczba to numer i-węzła (inode), a druga to liczba dowiązań. W obrębie tego samego systemu plików dwa pliki będące twardymi dowiązaniami do tego samego obiektu mają ten sam numer i-węzła oraz liczbę dowiązań wynoszącą co najmniej 2; każde kolejne twarde dowiązanie zwiększa tę wartość. Różne numery i-węzłów oznaczają, że pliki nie są twardymi dowiązaniami względem siebie, jednak nie stanowi to dowodu na niepowodzenie próby utworzenia dowiązania. Sonarr kopiuje pliki również wtedy, gdy opcja twardych dowiązań jest wyłączona. Błędy tworzenia twardych dowiązań między różnymi systemami plików są rejestrowane na poziomie Trace, a inne wyjątki związane z twardymi dowiązaniami na poziomie Debug, dlatego standardowe logi importu nie zawsze zawierają wyjaśnienie przyczyny.
Należy również monitorować użycie dysku. Wartość df -h /mnt/data powinna niemal nie drgnąć podczas importu, ponieważ twarde dowiązanie dodaje jedynie nazwę pliku, nie kopiując danych.
Co faktycznie ulega awarii
Błędy uprawnień podczas importu oznaczają, że identyfikator użytkownika kontenera nie ma uprawnień do zapisu w folderze biblioteki. Komunikat to Access to the path ... is denied. Należy sprawdzić za pomocą ls -ln /mnt/data/media, czy identyfikator właściciela jest zgodny z PUID oraz pamiętać, że katalogi wymagają bitu wykonywania, aby kontener mógł uzyskać do nich dostęp.
Katalogi należące do root mogą być wynikiem uruchomienia kontenera przed utworzeniem katalogu na hoście, ponieważ Docker automatycznie tworzy brakujące katalogi dla bind-mount. Należy zatrzymać stos, wykonać chown na katalogu i uruchomić go ponownie.
Usunięcie torrenta z qBittorrent, po którym znika plik z biblioteki, wymaga sprawdzenia, które ścieżki zostały usunięte; usunięcie samego pobierania nie usuwa oddzielnej kopii bibliotecznej ani twardego dowiązania (hardlink). W przypadku poprawnego twardego dowiązania, usunięcie jednej nazwy pozostawia drugą nienaruszoną, ponieważ dane są zwalniane dopiero wtedy, gdy licznik dowiązań osiągnie zero.
Szybsze zapełnianie się dysku niż wynika to z dodanych mediów to problem kopiowania w najbardziej kosztownej postaci. Przed zakupem dodatkowej pamięci należy przeprowadzić kontrolę stat opisaną powyżej.
Wymagania tego stosu względem VPS
Trzy aplikacje typu arr są lekkie. Odpytują indeksery, zapisują dane do niewielkiej bazy SQLite i zmieniają nazwy plików. Obciążenie generowane jest gdzie indziej. Klient pobierania nasyca wejście/wyjście dysku przy dużych torrentach, a serwer multimediów transkodujący wideo na tej samej maszynie zajmie procesor. Przechowuj multimedia na wolumenie o rzeczywistej przepustowości i ustaw limit pasma w kliencie pobierania, jeśli serwer wykonuje inne istotne zadania. Zaplanuj budżet dla tych pozostałych elementów oddzielnie, zamiast zakładać, że dostępny jest zapas mocy: samodzielnie hostowany obszar roboczy AFFiNE to kolejne cztery kontenery z bazą danych, a AFFiNE zaleca 2 GB pamięci RAM do podstawowego użytkowania i 4 GB dla dokumentów przekraczających 10 000 słów. W przypadku rozwiązań jednofunkcyjnych, takich jak samodzielnie hostowany tracker treningowy openGym, zapewnij własną obsługę TLS i zlokalizuj folder z danymi, zanim powierzysz mu roczną historię treningów. Każde rozwiązanie zawierające aplikację webową, bazę danych Postgres i kolejkę zadań w tle plasuje się bliżej wymagań AFFiNE, więc zdecyduj, czy samodzielnie hostowany system wsparcia Chatwoot powinien znajdować się na tym serwerze, czy na osobnym, zanim napotkasz ograniczenia w połowie importu danych. Obciążenia skokowe wymagają jeszcze większej ostrożności, ponieważ to ich szczytowe, a nie średnie zapotrzebowanie, koliduje z importem: jeśli rozważasz samodzielnie hostowane rozwiązanie OneCLI przydzielające każdemu użytkownikowi własnego izolowanego agenta, porównaj opublikowane wymagania sprzętowe z zasobami faktycznie dostępnymi podczas pracy qBittorrent na pełnej prędkości, a nie z tym, co pokazuje free -h na bezczynnej maszynie.
FAQ
Dlaczego Sonarr kopiuje pliki zamiast tworzyć twarde dowiązania (hardlinks)?
Dzieje się tak, ponieważ obsługa twardych dowiązań jest wyłączona lub operacja kończy się niepowodzeniem, na przykład gdy źródło i cel znajdują się na różnych systemach plików z perspektywy kontenera. Dwa osobne punkty montowania (bind mounts), takie jak /downloads i /tv, są traktowane jako odrębne systemy plików, nawet jeśli fizycznie pochodzą z tego samego dysku hosta, a twarde dowiązania nie mogą przekraczać ich granic. Należy zamontować jeden wspólny katalog nadrzędny jako /data w każdym kontenerze i umieścić w nim zarówno katalog pobierania, jak i bibliotekę; wtedy utworzenie dowiązania stanie się możliwe. Wynik można zweryfikować za pomocą stat -c '%i %h %n' dla obu plików: jeśli znajdują się na tym samym systemie plików, muszą posiadać ten sam numer inode oraz liczbę dowiązań wynoszącą co najmniej 2.
Jakich wartości PUID i PGID należy użyć?
Należy użyć numerycznego identyfikatora konta użytkownika na hoście, który jest właścicielem drzewa plików multimedialnych; wartości te można uzyskać za pomocą id -u oraz id -g. Na nowym serwerze VPS z systemem Ubuntu zazwyczaj jest to 1000 dla obu parametrów. Każdy kontener w stosie musi używać tej samej pary identyfikatorów, w przeciwnym razie jedna aplikacja będzie zapisywać pliki, których druga nie będzie mogła modyfikować. Po zmianie wartości należy odtworzyć kontenery za pomocą docker compose up -d --force-recreate i naprawić uprawnienia istniejących plików za pomocą chown -R.
Czy należy wystawiać te interfejsy WWW do Internetu?
Nie, i nie powinno się tego robić. Należy powiązać każdy opublikowany port z 127.0.0.1 w pliku Compose, a następnie uzyskiwać dostęp do interfejsów przez tunel SSH lub przez reverse proxy na serwerze, które dokonuje terminacji TLS (transport layer security) i dodaje własne uwierzytelnianie. W przypadku Docker Engine 28.0.0 lub nowszego oraz domyślnej konfiguracji bridge, sama sieć VPN nie pozwoli na dostęp do portu opublikowanego na 127.0.0.1, ponieważ Docker sprawia, że taki port jest dostępny wyłącznie z poziomu samego hosta. Starsze wersje Docker pozwalały hostom w tym samym segmencie sieci lokalnej na dostęp do portów opublikowanych na localhost. Jeśli wymagany jest bezpośredni dostęp przez VPN, należy opublikować porty na adresie VPN serwera. Publikowanie ich bezpośrednio na interfejsie publicznym jest bardziej ryzykowne, niż się wydaje, ponieważ Docker wstawia własne reguły zapory sieciowej, przez co reguła ufw deny nie zablokuje tego ruchu.
Gdzie znaleźć hasło do qBittorrent?
Obraz LinuxServer.io drukuje tymczasowe hasło dla użytkownika admin w dzienniku startowym. Należy uruchomić docker compose logs qbittorrent | grep -i password, aby je odczytać, a następnie ustawić stałe hasło w sekcji Options oraz Web UI. Nowe tymczasowe hasło jest generowane przy każdym restarcie, dopóki nie zostanie ustawione własne.
Czy Jellyfin może korzystać z tych samych folderów?
Tak, i jest to główny cel takiej struktury. Należy zamontować /mnt/data/media w serwerze multimediów jako /media, dzięki czemu jego biblioteki będą dostępne w /media/Movies i /media/Shows, podczas gdy Sonarr i Radarr będą zapisywać dane w tych samych katalogach przez /data/media. Należy nadać serwerowi multimediów te same wartości PUID i PGID, aby mógł odczytywać pliki zapisane przez stos arr.