Communityoplossing

qBittorrent-service niet beschikbaar op ZimaOS: wat u moet controleren

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

Een qBittorrent-pagina met de melding ‘Service is unavailable’ in ZimaOS 1.5.4 betekent niet dat je GPU-/apparaatdoorgifte of geprivilegieerde modus nodig hebt. De nuttige controles zijn het containerlog, de WebUI-poorttoewijzing, het gegenereerde wachtwoord, het permanente /config-pad en of de app-image zelf succesvol start.

In de brondiscussie werd nooit een bevestigde oplossing voor de oorspronkelijke hotio-container gevonden. Communityleden stelden in plaats daarvan een app op basis van LinuxServer voor en toonden verschillende installatiepaden via de App Store. Die suggesties moeten daarom als alternatieven worden beschouwd en niet als een bewezen oplossing.

Hoe de oorspronkelijke fout eruitzag

Foutpagina ‘Service is unavailable’ van qBittorrent in ZimaOS
De ingebouwde qBittorrent-app opende een algemene pagina met de melding ‘Service is unavailable’. Bron: IceWhale Community Forum.
Dialoogvenster met qBittorrent-tips waarin het beheerderswachtwoord uit het log en de DATA-paden worden getoond
ZimaOS gaf aan dat het tijdelijke beheerderswachtwoord uit het log moest worden gelezen en vermeldde de toegankelijke DATA-paden van de app. Bron: IceWhale Community Forum.

De qBittorrent-wrapper kon geen verbinding maken met de applicatie. ZimaOS verwees de gebruiker zelf al naar de opstartlogs, wat de juiste diagnostische laag is.

Controleer de bestaande container voordat je opnieuw installeert

qBittorrent-appinstellingen in ZimaOS met hotio-imageversie 5.0.4
De appdefinitie van de gebruiker gebruikte een hotio-qBittorrent-image, bridgenetwerken, hostpoort 8181 en containerpoort 8080. Bron: IceWhale Community Forum.
qBittorrent-instellingen voor PUID, PGID, tijdzone en UMASK in ZimaOS
De bestaande container had al de normale waarden voor PUID/PGID, tijdzone en UMASK. Bron: IceWhale Community Forum.
Gemarkeerde qBittorrent-privileges en apparaatvelden in ZimaOS
De gebruiker vroeg zich af of een apparaat of geprivilegieerde modus vereist was; geen van beide is normaal gesproken nodig voor de qBittorrent-WebUI. Bron: IceWhale Community Forum.

Controleer of de WebUI-poort van de host wordt toegewezen aan de poort waarop qBittorrent daadwerkelijk luistert, en of /config blijvend is en dat het containerlog geen fout bij het opstarten van de configuratie of database toont. Voor een normale qBittorrent-container is geen GPU of willekeurig hostapparaat vereist.

Als je de WebUI-poort in de LinuxServer-image wijzigt, vereist de huidige documentatie dat zowel de Docker-poorttoewijzing als WEBUI_PORT overeenkomen. Bekijk de LinuxServer-documentatie voor qBittorrent.

De suggestie van LinuxServer was een alternatieve image

LinuxServer qBittorrent-apptegel in een appstore
Een reactie uit de community stelde in plaats daarvan de qBittorrent-image van LinuxServer voor. Bron: IceWhale Community Forum.
LinuxServer qBittorrent-releasepagina voor 5.1.4 r2 ls441
De thread verwees naar een qBittorrent-containerrelease van LinuxServer, niet naar een bestand dat rechtstreeks in ZimaOS moet worden geïnstalleerd. Bron: IceWhale Community Forum.

De release-assets in de screenshot zijn downloads van broncode, geen pakketten die je naar ZimaOS kunt uploaden. Een gecontaineriseerde qBittorrent-installatie moet naar de Docker-image verwijzen en de container met de juiste instellingen opnieuw aanmaken.

De qBittorrent-containerhandleiding is nuttig zodra de WebUI start en je de opslagtoewijzingen moet controleren.

App Store-menu’s verschillen per ZimaOS-versie

Vervolgkeuzelijst met app-repositories van communitybronnen in ZimaOS
Een andere reactie toonde het menu voor repositorybronnen dat beschikbaar is in een nieuwere App Store-indeling. Bron: IceWhale Community Forum.
ZimaOS-dashboard met gemarkeerde App Store
De gebruiker vond de App Store in de gemengde Engels-Tsjechische interface. Bron: IceWhale Community Forum.
Interface voor het toevoegen van een gecontaineriseerde applicatie in de ZimaOS App Store
De nieuwere interface toonde een actie ‘Gecontaineriseerde applicatie toevoegen’ in plaats van exact het menu dat door een andere gebruiker werd getoond. Bron: IceWhale Community Forum.
Formulier voor handmatige app-installatie in ZimaOS
Met het formulier voor handmatige installatie kunnen gebruikers de image, Web UI, poorten, opslag en omgevingsvariabelen definiëren. Bron: IceWhale Community Forum.

Deze screenshots laten zien waarom oude stapsgewijze menu-instructies snel verouderen. Repositorybronnen en handmatige containerinstallatie zijn tussen releases verplaatst binnen de App Store-interface.

Gebruik de huidige App Store-indeling op je geïnstalleerde ZimaOS-versie in plaats van exact een screenshot van versie 1.5.4 te proberen na te bootsen.

Kort samengevat

De oorspronkelijke casus bewees geen enkele definitieve oplossing. Begin met de logs en de toewijzing van de WebUI/configuratie; voeg geen apparaten of de geprivilegieerde modus toe zonder gedocumenteerde noodzaak. Als je overstapt op LinuxServer, implementeer dan de huidige containerimage met de vereiste poorten, /config, PUID/PGID en een workflow met gegenereerde wachtwoorden in plaats van het downloaden van GitHub-broncodearchieven.