Rozwiązanie społecznościowe

Usługa qBittorrent niedostępna w ZimaOS: co sprawdzić

A ZimaOS 1.5.4 qBittorrent install opened a Service unavailable page; replies suggested logs, an alternative LinuxServer image and newer App Store paths.

Strona „Usługa jest niedostępna” aplikacji qBittorrent w ZimaOS 1.5.4 nie oznacza, że potrzebujesz przekazywania GPU/urządzenia ani trybu uprzywilejowanego. Warto sprawdzić dziennik kontenera, mapowanie portu WebUI, wygenerowane hasło, trwałą ścieżkę /config oraz to, czy sam obraz aplikacji uruchamia się pomyślnie.

Wątek źródłowy nie doprowadził do potwierdzonego rozwiązania pierwotnego kontenera hotio. Członkowie społeczności zasugerowali zamiast tego aplikację opartą na LinuxServer i pokazali kilka sposobów instalacji ze sklepu z aplikacjami, więc sugestie te należy traktować jako alternatywy, a nie sprawdzoną naprawę.

Jak wyglądał pierwotny błąd

Strona błędu „Usługa jest niedostępna” aplikacji qBittorrent w ZimaOS
Wbudowana aplikacja qBittorrent otwierała ogólną stronę „Usługa jest niedostępna”. Źródło: forum społeczności IceWhale.
Okno wskazówek qBittorrent pokazujące hasło administratora z dziennika i ścieżki DATA
ZimaOS informował, że tymczasowe hasło administratora należy odczytać z dziennika, i wyświetlał dostępne ścieżki DATA aplikacji. Źródło: forum społeczności IceWhale.

Warstwa qBittorrent nie mogła połączyć się z aplikacją. ZimaOS już kierował użytkownika do dzienników uruchamiania, co jest właściwą warstwą diagnostyczną.

Sprawdź istniejący kontener przed ponowną instalacją

Ustawienia aplikacji qBittorrent w ZimaOS z obrazem hotio w wersji 5.0.4
Definicja aplikacji użytkownika korzystała z obrazu qBittorrent hotio, sieci bridge, portu hosta 8181 i portu kontenera 8080. Źródło: forum społeczności IceWhale.
Ustawienia PUID, PGID, strefy czasowej i UMASK qBittorrent w ZimaOS
Istniejący kontener miał już standardowe wartości PUID/PGID, strefę czasową i UMASK. Źródło: forum społeczności IceWhale.
Wyróżnione uprawnienia i pola urządzeń aplikacji qBittorrent w ZimaOS
Użytkownik zastanawiał się, czy wymagane jest urządzenie lub tryb uprzywilejowany; żadne z nich nie jest wymagane przez standardowy interfejs WebUI qBittorrent. Źródło: forum społeczności IceWhale.

Sprawdź, czy port WebUI hosta jest mapowany na port, na którym faktycznie nasłuchuje qBittorrent, oraz czy /config jest trwała, a dziennik kontenera nie pokazuje błędu uruchamiania konfiguracji/bazy danych. Normalny kontener qBittorrent nie wymaga procesora graficznego ani dowolnego urządzenia hosta.

Jeśli zmienisz port WebUI w obrazie LinuxServer, aktualna dokumentacja wymaga, aby zarówno mapowanie portu Dockera, jak i wartość WEBUI_PORT były zgodne. Zobacz dokumentację qBittorrent LinuxServer.

Sugestia dotycząca LinuxServer była alternatywnym obrazem

Kafelek aplikacji qBittorrent firmy LinuxServer w sklepie z aplikacjami
Użytkownik społeczności zasugerował zamiast tego obraz qBittorrent firmy LinuxServer. Źródło: forum społeczności IceWhale.
Strona wydania qBittorrent firmy LinuxServer dla wersji 5.1.4 r2 ls441
Wątek odsyłał do wydania kontenera qBittorrent firmy LinuxServer, a nie do pliku, który należy zainstalować bezpośrednio w ZimaOS. Źródło: forum społeczności IceWhale.

Zasoby wydania widoczne na zrzucie ekranu to pliki do pobrania z kodem źródłowym, a nie pakiety do przesłania do ZimaOS. Instalacja qBittorrent w kontenerze powinna odwoływać się do obrazu Dockera, a następnie odtworzyć kontener z prawidłowymi ustawieniami.

Przewodnik po kontenerze qBittorrent jest przydatny, gdy WebUI już działa i trzeba zweryfikować mapowania pamięci masowej.

Menu App Store zmieniały się między wersjami ZimaOS

Lista źródeł społecznościowych w menu repozytoriów aplikacji ZimaOS
Inna odpowiedź pokazywała menu źródeł repozytoriów dostępne w nowszym układzie App Store. Źródło: forum społeczności IceWhale.
Panel ZimaOS z wyróżnioną sekcją App Store
Użytkownik znalazł App Store w interfejsie łączącym język angielski i czeski. Źródło: forum społeczności IceWhale.
Interfejs dodawania aplikacji w kontenerze w ZimaOS App Store
Nowszy interfejs udostępniał opcję „Dodaj aplikację w kontenerze” zamiast dokładnego menu pokazanego przez innego użytkownika. Źródło: forum społeczności IceWhale.
Formularz ręcznej instalacji aplikacji w ZimaOS
Formularz ręcznej instalacji umożliwia określenie obrazu, interfejsu Web UI, portów, pamięci masowej i zmiennych środowiskowych. Źródło: forum społeczności IceWhale.

Te zrzuty ekranu pokazują, dlaczego stare instrukcje krok po kroku dotyczące menu szybko się dezaktualizują. W kolejnych wydaniach źródła repozytoriów i ręczna instalacja kontenerów były przenoszone w interfejsie App Store.

Korzystaj z aktualnego układu App Store w zainstalowanej wersji ZimaOS, zamiast próbować dokładnie odtworzyć zrzut ekranu z wersji 1.5.4.

Podsumowanie

Analiza przypadku nie potwierdziła jednego, definitywnego rozwiązania. Zacznij od logów oraz mapowania WebUI/konfiguracji; nie dodawaj urządzeń ani trybu uprzywilejowanego bez udokumentowanej potrzeby. Jeśli przełączysz się na LinuxServer, wdroż aktualny obraz kontenera z wymaganymi portami, /config, PUID/PGID i procedura generowania hasła zamiast pobierania archiwów źródłowych z GitHub.