Źródłowy wątek z lipca 2025 roku rozpoczął się od nieudanej instalacji qBittorrent ze sklepu z aplikacjami, a zakończył ręczną instalacją kontenera LinuxServer.io. W skrócie na tej stronie wcześniej zbyt szybko przechodzono od „pobieranie nie powiodło się” do „użyj LinuxServer”. Pełny wątek zawiera istotny wątek związany z wersją: IceWhale poprosiło użytkownika o przetestowanie ZimaOS 1.4.2 beta1, ponieważ poprawiono w nim działanie instalacji aplikacji; wersja beta zainstalowała się, ale spowodowała nowy problem związany z kartą GPU GTX 1070 użytkownika, który ostatecznie wrócił do wersji 1.4.1.
Ręcznie utworzony kontener qBittorrent działał wystarczająco dobrze dla użytkownika opisanego w źródle, ale zastosowane przez niego historyczne obejście problemu z WebUI wyłączało walidację nagłówka Host i ochronę CSRF. Nie należy stosować tego rozwiązania domyślnie w obecnej instalacji.
Pierwotna awaria dotyczyła problemu z pobieraniem obrazu
Błąd pobierania obrazu różni się od sytuacji, w której kontener uruchamia się, a następnie ulega awarii. Należy sprawdzić odwołanie do obrazu, dostęp do rejestru, definicję w sklepie z aplikacjami lub warstwę instalowania aplikacji w ZimaOS.
IceWhale zasugerowało ZimaOS 1.4.2 Beta1
Zima-Giorgio poprosił użytkownika o wypróbowanie najnowszej wówczas wersji beta 1.4.2 beta1, ponieważ ta wersja usprawniała instalowanie aplikacji i mogła naprawić problem. Gdy aktualizacja nie pojawiła się automatycznie, Giorgio podał oficjalną procedurę aktualizacji offline dla tej historycznej wersji beta.
Te polecenia pochodzą z kompilacji przedpremierowej z 2025 roku i nie należy ich ponownie używać na obecnym serwerze. Ich znaczenie jest historyczne: IceWhale uznało, że niepowodzenie pobierania ze sklepu z aplikacjami może mieć związek z wersją ZimaOS.
Wersja beta spowodowała u użytkownika inny problem
Użytkownik zainstalował wersję beta, ale później wrócił do 1.4.1, ponieważ — jak sam powiedział — wersja beta ignorowała kartę GPU GTX 1070. Pokazuje to, dlaczego aktualizacja do wersji beta wyłącznie w celu naprawy jednej aplikacji powinna obejmować testy regresji pozostałych funkcji serwera.
Obecny system powinien korzystać z bieżącej stabilnej wersji ZimaOS, chyba że istnieje konkretny powód związany ze wsparciem, aby przetestować kompilację prerelease.
Następnie użytkownik zainstalował obraz qBittorrent LinuxServer.io
Obecny qBittorrent LinuxServer.io korzysta z lscr.io/linuxserver/qbittorrent. Do jego najważniejszych trwałych i sieciowych ustawień należą:
-
/configdo konfiguracji qBittorrent; - folder pobierania na hoście zmapowany do kontenera;
- PUID i PGID do określania właściciela plików;
- port WebUI;
- port nasłuchiwania BitTorrenta przez TCP i UDP.
Użyj bieżących ustawień kontenera qBittorrent LinuxServer.io zamiast odtwarzać konfigurację z 2025 roku z pamięci.
Zachowaj zgodność WEBUI_PORT i mapowania portów Dockera
Obecny obraz zwykle udostępnia WebUI na porcie 8080. Jeśli chcesz użyć innego portu hosta, możesz zmapować ten port hosta na usługę kontenera. Jeśli zmienisz sam wewnętrzny port WebUI, LinuxServer.io wymaga WEBUI_PORT Dopasuj wartość zmiennej środowiskowej i mapowanie portów Dockera.
Niezgodny port WebUI może powodować błędy połączenia wyglądające jak problemy z uwierzytelnianiem lub nagłówkami bezpieczeństwa.
Użyj tymczasowego hasła z dziennika uruchamiania
Autor źródłowy słusznie zauważył, że pierwsze hasło można znaleźć w dziennikach. Obecne zachowanie LinuxServer.io generuje tymczasowe hasło dla admin konto przy uruchamianiu.
Otwórz dziennik kontenera qBittorrent, użyj tymczasowej wartości przy pierwszym logowaniu i natychmiast ustaw stałe hasło w WebUI.
Nie wyłączaj domyślnie HostHeaderValidation i CSRFProtection
Historyczny autor źródłowy dodał:
WebUI\HostHeaderValidation=false
WebUI\CSRFProtection=falsedo pliku konfiguracyjnego qBittorrent. Zgłosili, że aplikacja zaczęła wtedy działać, ale te opcje celowo osłabiają mechanizmy kontroli bezpieczeństwa przeglądarki.
W aktualnej instalacji należy najpierw prawidłowo skonfigurować port, adres URL WebUI, nagłówki odwrotnego serwera proxy i uwierzytelnianie. Nie traktuj „wyłącz CSRF” jako standardowej odpowiedzi na problem z dostępem do WebUI.
Jeśli używany jest odwrotny serwer proxy, skonfiguruj go prawidłowo
Błędy nagłówka hosta często pojawiają się, gdy aplikacja jest otwierana przez nazwę hosta lub serwer proxy, których WebUI nie oczekuje. Prawidłowym rozwiązaniem jest zwykle spójna konfiguracja serwera proxy i ustawień WebUI qBittorrent, a nie globalne wyłączanie całej walidacji.
Ruch WebUI i ruch peerów BitTorrenta korzystają z różnych portów
Port używany do administrowania qBittorrent w przeglądarce nie jest portem używanym do przychodzących połączeń z peerami. Udostępnij wybrany port nasłuchiwania torrentów przez TCP i UDP oraz ustaw w qBittorrent własną konfigurację portu nasłuchiwania na tę samą wartość.
Jeśli serwer znajduje się za NAT-em i pożądana jest możliwość nawiązywania przychodzących połączeń z peerami, projekt routera lub VPN-u jest odrębną decyzją od mapowania portów Dockera.
Zmapuj pobierane pliki na rzeczywistą przestrzeń dyskową ZimaOS
Nie pozwól, aby duże torrenty gromadziły się w nietrwałej warstwie kontenera lub na małym dysku systemowym. Zmapuj katalog pobierania na docelową przestrzeń dyskową ZimaOS i przed rozpoczęciem dużego pobierania potwierdź, że użytkownik kontenera może tam zapisywać dane.
Zachowaj /config przed ponownym utworzeniem kontenera
Preferencje qBittorrent, kategorie, ścieżki i stan aplikacji znajdują się w trwałym katalogu konfiguracji. Wykonaj jego kopię zapasową przed zmianą obrazów lub zastąpieniem wdrożenia ze sklepu z aplikacjami niestandardowym kontenerem.
Często zadawane pytania dotyczące qBittorrent w ZimaOS
Czy pierwotnym problemem było zawieszanie się qBittorrent?
Nie. Instalacja ze sklepu z aplikacjami nie powiodła się na etapie pobierania obrazu Dockera.
Dlaczego użytkownik wrócił z wersji beta do ZimaOS 1.4.1?
Zgłosili, że wersja beta nie obsługiwała ich karty GTX 1070 zgodnie z oczekiwaniami.
Skąd pochodzi pierwsze hasło qBittorrent?
Aktualne kontenery LinuxServer.io wyświetlają tymczasowe hasło administratora w dzienniku uruchamiania.
Czy należy wyłączyć ochronę CSRF, aby WebUI działał?
Nie jako domyślne podejście. Najpierw popraw konfigurację bieżącego portu, serwera proxy, nazwy hosta i uwierzytelniania.
