Solution communautaire

Service qBittorrent indisponible sur ZimaOS : points à vérifier

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

Une page « Service indisponible » de qBittorrent sur ZimaOS 1.5.4 ne signifie pas que vous avez besoin d’un transfert de GPU ou de périphérique, ni du mode privilégié. Les vérifications utiles concernent le journal du conteneur, le mappage du port WebUI, le mot de passe généré, le chemin /config persistant et le démarrage réussi de l’image de l’application elle-même.

Le fil de discussion source n’a jamais abouti à une solution confirmée pour le conteneur hotio d’origine. Des membres de la communauté ont plutôt suggéré une application basée sur LinuxServer et présenté plusieurs méthodes d’installation depuis l’App Store ; ces suggestions doivent donc être considérées comme des alternatives plutôt que comme une réparation avérée.

À quoi ressemblait l’erreur d’origine

Page d’erreur « Service indisponible » de qBittorrent dans ZimaOS
L’application qBittorrent intégrée ouvrait une page générique « Service indisponible ». Source : forum communautaire IceWhale.
Boîte de dialogue d’astuces de qBittorrent affichant le mot de passe administrateur du journal et les chemins DATA
ZimaOS indiquait que le mot de passe administrateur temporaire devait être lu dans le journal et répertoriait les chemins DATA accessibles de l’application. Source : forum communautaire IceWhale.

L’interface qBittorrent ne parvenait pas à joindre l’application. ZimaOS orientait déjà l’utilisateur vers les journaux de démarrage, qui constituent le bon niveau de diagnostic.

Vérifier le conteneur existant avant de le réinstaller

Paramètres de l’application qBittorrent dans ZimaOS utilisant l’image hotio, version 5.0.4
La définition de l’application de l’utilisateur utilisait une image qBittorrent hotio, le réseau bridge, le port hôte 8181 et le port du conteneur 8080. Source : forum communautaire IceWhale.
Paramètres PUID, PGID, du fuseau horaire et d’UMASK de qBittorrent dans ZimaOS
Le conteneur existant disposait déjà de valeurs normales pour PUID/PGID, le fuseau horaire et UMASK. Source : forum communautaire IceWhale.
Privilèges et champs de périphériques de qBittorrent dans ZimaOS mis en évidence
L’utilisateur se demandait si un périphérique ou le mode privilégié était nécessaire ; ni l’un ni l’autre ne constitue une exigence normale pour l’interface WebUI de qBittorrent. Source : forum communautaire IceWhale.

Vérifiez que le port WebUI de l’hôte est mappé vers le port sur lequel qBittorrent écoute réellement, et que /config est persistant et que le journal du conteneur n’affiche aucune erreur de démarrage de la configuration ou de la base de données. Un conteneur qBittorrent normal ne nécessite ni GPU ni périphérique hôte arbitraire.

Si vous modifiez le port de l’interface WebUI sur l’image LinuxServer, sa documentation actuelle exige que le mappage du port Docker et WEBUI_PORT correspondent. Consultez la documentation LinuxServer de qBittorrent.

La suggestion de LinuxServer était une image alternative

Tuile de l’application qBittorrent LinuxServer dans un magasin d’applications
Une réponse de la communauté suggérait plutôt l’image qBittorrent de LinuxServer. Source : forum communautaire IceWhale.
Page de version qBittorrent LinuxServer pour 5.1.4 r2 ls441
La discussion renvoyait vers une version du conteneur qBittorrent de LinuxServer, et non vers un fichier à installer directement dans ZimaOS. Source : forum communautaire IceWhale.

Les ressources de la version affichées dans la capture d’écran sont des téléchargements de code source, et non des paquets à téléverser dans ZimaOS. Une installation conteneurisée de qBittorrent doit utiliser l’image Docker et recréer le conteneur avec les paramètres appropriés.

Le guide du conteneur qBittorrent est utile une fois que l’interface Web démarre et que vous devez vérifier les correspondances de stockage.

Les menus de l’App Store ont changé selon les versions de ZimaOS

Menu déroulant des dépôts d’applications ZimaOS répertoriant les sources communautaires
Une autre réponse présentait le menu des sources de dépôts disponible dans une version plus récente de l’App Store. Source : forum communautaire IceWhale.
Tableau de bord ZimaOS avec l’App Store mis en évidence
L’utilisateur a trouvé l’App Store dans l’interface mêlant l’anglais et le tchèque. Source : forum communautaire IceWhale.
Interface d’ajout d’une application conteneurisée dans l’App Store de ZimaOS
La nouvelle interface affichait une action « Ajouter une application conteneurisée » au lieu du menu exact présenté par un autre utilisateur. Source : forum communautaire IceWhale.
Formulaire d’installation manuelle d’une application ZimaOS
Le formulaire d’installation manuelle permet de définir l’image, l’interface Web, les ports, le stockage et les variables d’environnement. Source : forum communautaire IceWhale.

Ces captures d’écran montrent pourquoi les instructions de menu détaillées et anciennes deviennent rapidement obsolètes. Les sources de dépôts et l’installation manuelle de conteneurs ont changé de place dans l’interface de l’App Store au fil des versions.

Utilisez la présentation actuelle de l’App Store sur votre version installée de ZimaOS plutôt que d’essayer de reproduire exactement une capture d’écran de la version 1.5.4.

En bref

Le cas source n’a pas permis d’établir une solution unique et définitive. Commencez par consulter les journaux et vérifier la correspondance WebUI/configuration ; n’ajoutez pas de périphériques et n’utilisez pas le mode privilégié sans nécessité documentée. Si vous passez à LinuxServer, déployez l’image de conteneur actuelle avec ses ports requis, /config, PUID/PGID et processus de génération du mot de passe plutôt que de télécharger des archives de code source GitHub.