Der ursprüngliche Thread aus dem Juli 2025 begann mit einem Fehler bei der qBittorrent-Installation aus dem App Store und endete mit einem manuell installierten LinuxServer.io-Container. Die Kurzfassung dieser Seite sprang zuvor zu schnell von „Abrufen fehlgeschlagen“ zu „LinuxServer verwenden“. Der vollständige Thread enthält einen wichtigen Versionsumweg: IceWhale bat den Benutzer, ZimaOS 1.4.2 beta1 zu testen, da das Installationsverhalten von Apps dort verbessert worden war. Die Betaversion wurde installiert, verursachte jedoch ein neues GPU-bezogenes Problem mit der GTX 1070 des Benutzers, woraufhin dieser letztlich zu 1.4.1 zurückkehrte.
Der manuell erstellte qBittorrent-Container funktionierte für den ursprünglichen Benutzer ausreichend gut, aber dessen historische WebUI-Umgehung deaktivierte die Host-Header-Validierung und den CSRF-Schutz. Das sollte bei einer aktuellen Installation nicht als Standardlösung übernommen werden.
Der ursprüngliche Fehler betraf das Abrufen eines Images
Ein Fehler beim Abrufen eines Images unterscheidet sich von einem Container, der startet und anschließend abstürzt. Das Problem ist beim Image-Verweis, beim Registry-Zugriff, bei der App-Store-Definition oder bei der ZimaOS-Schicht für die App-Installation zu suchen.
IceWhale schlug ZimaOS 1.4.2 Beta1 vor
Zima-Giorgio bat den Benutzer, die damals neueste Betaversion 1.4.2 beta1 auszuprobieren, da diese Version die App-Installation verbessert hatte und das Problem möglicherweise beheben konnte. Als das Update nicht automatisch angezeigt wurde, stellte Giorgio den offiziellen Weg für die Offline-Aktualisierung dieser historischen Betaversion bereit.
Diese Befehle gehören zu einem Vorab-Build aus dem Jahr 2025 und sollten auf einem aktuellen Server nicht erneut verwendet werden. Ihre Bedeutung ist historischer Natur: IceWhale vermutete, dass der Fehler beim Abrufen aus dem App Store mit der ZimaOS-Version zusammenhängen könnte.
Die Betaversion verursachte ein anderes Problem für den Benutzer
Der Benutzer installierte die Betaversion, wechselte später jedoch zu 1.4.1 zurück, da die Betaversion seiner Aussage nach die GTX-1070-GPU ignorierte. Das zeigt, warum ein Upgrade auf eine Betaversion zur Behebung nur einer App Regressionstests für den restlichen Server umfassen sollte.
Ein aktuelles System sollte die aktuelle stabile ZimaOS-Version verwenden, sofern nicht aus einem bestimmten Supportgrund ein Vorab-Build getestet werden soll.
Der Nutzer installierte anschließend das qBittorrent-Image von LinuxServer.io
Das aktuelle qBittorrent von LinuxServer.io verwendet lscr.io/linuxserver/qbittorrent. Zu den wichtigen persistenten und Netzwerkeinstellungen gehören:
-
/configfür die qBittorrent-Konfiguration; - einen in den Container eingebundenen Download-Ordner des Hosts;
- PUID und PGID für Dateibesitz;
- einen WebUI-Port;
- einen BitTorrent-Listening-Port über TCP und UDP.
Verwenden Sie die aktuellen LinuxServer.io-Einstellungen für den qBittorrent-Container, anstatt die Konfiguration von 2025 aus dem Gedächtnis neu zu erstellen.
WEBUI_PORT und Docker-Portzuordnung synchron halten
Das aktuelle Image stellt das WebUI normalerweise auf Port 8080 bereit. Wenn Sie einen anderen Host-Port verwenden möchten, können Sie diesen Host-Port dem Containerdienst zuordnen. Wenn der interne WebUI-Port selbst geändert wird, verlangt LinuxServer.io den WEBUI_PORT Umgebungswert und Docker-Zuordnung müssen übereinstimmen.
Ein nicht übereinstimmender WebUI-Port kann Verbindungsfehler verursachen, die wie Probleme mit der Authentifizierung oder Sicherheits-Headern aussehen.
Temporäres Passwort aus dem Startprotokoll verwenden
Der ursprüngliche Nutzer wies korrekt darauf hin, dass das erste Passwort in den Protokollen zu finden ist. Das aktuelle Verhalten von LinuxServer.io erzeugt ein temporäres Passwort für das admin Konto beim Start.
Öffnen Sie das Containerprotokoll von qBittorrent, verwenden Sie den temporären Wert für die erste Anmeldung und legen Sie anschließend sofort im WebUI ein dauerhaftes Passwort fest.
HostHeaderValidation und CSRFProtection nicht standardmäßig deaktivieren
Der ursprüngliche Nutzer fügte hinzu:
WebUI\HostHeaderValidation=false
WebUI\CSRFProtection=falsezur qBittorrent-Konfigurationsdatei. Sie berichteten, dass die Anwendung danach scheinbar funktionierte, diese Optionen jedoch absichtlich die browserseitigen Sicherheitsprüfungen schwächen.
Bei einer aktuellen Installation sollten zunächst der richtige Port, die WebUI-URL, die Reverse-Proxy-Header und die Authentifizierungskonfiguration korrekt eingerichtet werden. Mache „CSRF deaktivieren“ nicht zur Standardantwort auf ein WebUI-Zugriffsproblem.
Bei Verwendung eines Reverse-Proxys diesen ordnungsgemäß konfigurieren
Host-Header-Fehler treten häufig auf, wenn eine Anwendung über einen Hostnamen oder Proxy aufgerufen wird, den die WebUI nicht erwartet. Die richtige Lösung besteht normalerweise darin, Proxy und qBittorrent-WebUI konsistent zu konfigurieren, nicht die gesamte Validierung global zu deaktivieren.
WebUI- und BitTorrent-Peer-Datenverkehr verwenden unterschiedliche Ports
Der Port, über den qBittorrent im Browser verwaltet wird, ist nicht der Port für eingehende Peer-Verbindungen. Veröffentliche den gewählten Torrent-Listening-Port über TCP und UDP und stelle sicher, dass qBittorrents eigene Einstellung für den Listening-Port damit übereinstimmt.
Wenn der Server hinter NAT steht und eingehende Peer-Verbindungen gewünscht sind, ist die Router- oder VPN-Konfiguration eine separate Entscheidung von der Docker-Portzuordnung.
Downloads auf echten ZimaOS-Speicher verknüpfen
Lass große Torrents nicht innerhalb der verworfenen Containerebene oder auf einer kleinen Systemfestplatte anwachsen. Verknüpfe das Downloadverzeichnis mit dem vorgesehenen ZimaOS-Speicher und bestätige vor dem Start eines großen Downloads, dass der Containerbenutzer dort schreiben kann.
/config vor dem Neuerstellen des Containers beibehalten
Die qBittorrent-Einstellungen, Kategorien, Pfade und der Anwendungsstatus befinden sich im persistenten Konfigurationsverzeichnis. Sichere es, bevor du Images änderst oder eine App-Store-Bereitstellung durch einen benutzerdefinierten Container ersetzt.
qBittorrent-FAQ für ZimaOS
War das ursprüngliche Problem ein Absturz von qBittorrent?
Nein. Die Installation aus dem App Store ist beim Abrufen des Docker-Images fehlgeschlagen.
Warum ist der Benutzer von der Beta zu ZimaOS 1.4.1 zurückgekehrt?
Es wurde berichtet, dass die Beta die GTX 1070 nicht wie erwartet unterstützte.
Woher stammt das erste qBittorrent-Passwort?
Aktuelle LinuxServer.io-Container geben beim Start ein temporäres Admin-Passwort im Startprotokoll aus.
Soll der CSRF-Schutz deaktiviert werden, damit die WebUI funktioniert?
Nein, nicht als Standardvorgehen. Korrigiere zuerst die aktuelle Konfiguration für Port, Proxy, Hostnamen und Authentifizierung.
