Community-Lösung

qBittorrent-Dienst auf ZimaOS nicht verfügbar: Was Sie prüfen sollten

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

Eine qBittorrent-Seite mit der Meldung „Dienst ist nicht verfügbar“ in ZimaOS 1.5.4 bedeutet nicht, dass Sie GPU-/Geräte-Passthrough oder den privilegierten Modus benötigen. Die wichtigen Prüfungen betreffen das Containerprotokoll, die WebUI-Portzuordnung, das generierte Kennwort, den persistenten /config-Pfad und die Frage, ob das App-Image selbst erfolgreich startet.

Der ursprüngliche Thread erreichte keine bestätigte Lösung für den ursprünglichen hotio-Container. Community-Mitglieder schlugen stattdessen eine auf LinuxServer basierende App vor und zeigten mehrere Installationswege über den App Store. Diese Vorschläge sollten daher als Alternativen und nicht als nachgewiesene Reparatur betrachtet werden.

So sah der ursprüngliche Fehler aus

qBittorrent-Fehlerseite „Dienst ist nicht verfügbar“ in ZimaOS
Die integrierte qBittorrent-App öffnete eine allgemeine Seite mit der Meldung „Dienst ist nicht verfügbar“. Quelle: IceWhale-Community-Forum.
qBittorrent-Dialog mit Hinweisen zum Administratorkennwort aus dem Protokoll und zu DATA-Pfaden
ZimaOS zeigte an, dass das temporäre Administratorkennwort aus dem Protokoll gelesen werden sollte, und listete die zugänglichen DATA-Pfade der App auf. Quelle: IceWhale-Community-Forum.

Der qBittorrent-Wrapper konnte die Anwendung nicht erreichen. ZimaOS verwies den Benutzer bereits auf die Startprotokolle – das ist die richtige diagnostische Ebene.

Vor der Neuinstallation den vorhandenen Container prüfen

ZimaOS-qBittorrent-App-Einstellungen mit der hotio-Image-Version 5.0.4
Die App-Definition des Benutzers verwendete ein hotio-qBittorrent-Image, Bridge-Netzwerk sowie den Host-Port 8181 und den Container-Port 8080. Quelle: IceWhale-Community-Forum.
qBittorrent-Einstellungen für PUID, PGID, Zeitzone und UMASK in ZimaOS
Der vorhandene Container hatte bereits die üblichen Werte für PUID/PGID, Zeitzone und UMASK. Quelle: IceWhale-Community-Forum.
Hervorgehobene qBittorrent-Berechtigungen und Gerätefelder in ZimaOS
Der Benutzer fragte sich, ob ein Gerät oder der privilegierte Modus erforderlich sei; beides ist für die normale qBittorrent-WebUI nicht erforderlich. Quelle: IceWhale-Community-Forum.

Überprüfen Sie, ob der WebUI-Port des Hosts dem Port zugeordnet ist, auf dem qBittorrent tatsächlich lauscht, und /config ist persistent, und dass das Containerprotokoll keinen Startfehler bei der Konfiguration oder Datenbank anzeigt. Ein normaler qBittorrent-Container benötigt weder eine GPU noch ein beliebiges Hostgerät.

Wenn Sie den WebUI-Port im LinuxServer-Image ändern, müssen laut der aktuellen Dokumentation sowohl die Docker-Portzuordnung als auch WEBUI_PORT übereinstimmen. Siehe die LinuxServer-qBittorrent-Dokumentation.

Der LinuxServer-Vorschlag war ein alternatives Image

LinuxServer-qBittorrent-App-Kachel in einem App Store
Eine Antwort aus der Community schlug stattdessen das LinuxServer-qBittorrent-Image vor. Quelle: IceWhale-Community-Forum.
LinuxServer-qBittorrent-Release-Seite für 5.1.4 r2 ls441
Der Thread verwies auf eine qBittorrent-Containerveröffentlichung von LinuxServer, nicht auf eine Datei, die direkt in ZimaOS installiert werden sollte. Quelle: IceWhale-Community-Forum.

Die Release-Assets im Screenshot sind Quellcode-Downloads und keine Pakete, die in ZimaOS hochgeladen werden sollten. Eine containerisierte qBittorrent-Installation sollte auf das Docker-Image verweisen und den Container mit den korrekten Einstellungen neu erstellen.

Der qBittorrent-Containerleitfaden ist nützlich, sobald die WebUI startet und Sie die Speicherzuordnungen überprüfen müssen.

App-Store-Menüs haben sich zwischen den ZimaOS-Versionen geändert

Dropdown-Liste der App-Repositorys mit Community-Quellen in ZimaOS
Eine weitere Antwort zeigte das Menü für Repository-Quellen, das in einem neueren App-Store-Layout verfügbar ist. Quelle: IceWhale-Community-Forum.
ZimaOS-Dashboard mit hervorgehobenem App Store
Der Benutzer fand den App Store in der gemischten englisch-tschechischen Oberfläche. Quelle: IceWhale-Community-Forum.
Oberfläche zum Hinzufügen einer Containeranwendung im ZimaOS-App-Store
Die neuere Oberfläche bot eine Aktion „Containeranwendung hinzufügen“ anstelle des genauen Menüs, das ein anderer Benutzer zeigte. Quelle: IceWhale-Community-Forum.
Formular zur manuellen App-Installation in ZimaOS
Das Formular für die manuelle Installation ermöglicht es Benutzern, das Image, die WebUI, Ports, den Speicher und Umgebungsvariablen festzulegen. Quelle: IceWhale-Community-Forum.

Diese Screenshots zeigen, warum alte Schritt-für-Schritt-Menüanweisungen schnell veralten. Repository-Quellen und die manuelle Containerinstallation wurden zwischen den Versionen in der App-Store-Oberfläche verschoben.

Verwenden Sie das aktuelle App-Store-Layout Ihrer installierten ZimaOS-Version, statt zu versuchen, einen Screenshot von Version 1.5.4 exakt nachzubilden.

Kurz gesagt

Der Ausgangsfall belegte keine eindeutige Lösung. Beginnen Sie mit den Protokollen und der WebUI-/Konfigurationszuordnung. Fügen Sie Geräte oder den privilegierten Modus nicht ohne dokumentierten Bedarf hinzu. Wenn Sie zu LinuxServer wechseln, stellen Sie das aktuelle Container-Image mit den erforderlichen Ports bereit, /config, PUID/PGID und einen Workflow mit generiertem Passwort statt des Herunterladens von GitHub-Quellcodearchiven.