Soluzione della community

Servizio qBittorrent non disponibile su ZimaOS: cosa controllare

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

Una pagina “Servizio non disponibile” di qBittorrent su ZimaOS 1.5.4 non significa che siano necessari il passthrough di una GPU o di un dispositivo, né la modalità privilegiata. I controlli utili sono il log del container, la mappatura della porta WebUI, la password generata, il percorso persistente /config e l’effettivo avvio dell’immagine dell’app.

La discussione originale non è mai arrivata a una soluzione confermata per il container hotio. I membri della community hanno invece suggerito un’app basata su LinuxServer e mostrato diversi percorsi di installazione dall’App Store; tali suggerimenti devono quindi essere considerati alternative, non una riparazione verificata.

Come appariva l’errore originale

Pagina di errore “Servizio non disponibile” di qBittorrent in ZimaOS
L’app qBittorrent integrata apriva una pagina generica “Servizio non disponibile”. Fonte: forum della community IceWhale.
Finestra dei suggerimenti di qBittorrent con la password amministratore dal log e i percorsi DATA
ZimaOS indicava che la password amministratore temporanea doveva essere letta dal log e mostrava i percorsi DATA accessibili dell’app. Fonte: forum della community IceWhale.

Il wrapper di qBittorrent non riusciva a raggiungere l’applicazione. ZimaOS indirizzava già l’utente ai log di avvio, che sono il livello diagnostico corretto.

Controlla il container esistente prima di reinstallare

Impostazioni dell’app qBittorrent in ZimaOS con l’immagine hotio versione 5.0.4
La definizione dell’app dell’utente utilizzava un’immagine qBittorrent hotio, rete bridge, porta host 8181 e porta del container 8080. Fonte: forum della community IceWhale.
Impostazioni PUID, PGID, fuso orario e UMASK di qBittorrent in ZimaOS
Il container esistente aveva già valori normali per PUID/PGID, fuso orario e UMASK. Fonte: forum della community IceWhale.
Privilegi e campi dei dispositivi dell’app qBittorrent in ZimaOS
L’utente si chiedeva se fosse necessario un dispositivo o la modalità privilegiata; nessuno dei due è normalmente richiesto dalla WebUI di qBittorrent. Fonte: forum della community IceWhale.

Verifica che la porta WebUI dell’host sia mappata sulla porta su cui qBittorrent è effettivamente in ascolto e che /config è persistente e che il log del container non mostri un errore di avvio della configurazione o del database. Un normale container qBittorrent non richiede una GPU né dispositivi host arbitrari.

Se modifichi la porta della WebUI nell’immagine LinuxServer, la documentazione attuale richiede che coincidano sia la mappatura della porta Docker sia WEBUI_PORT. Consulta la documentazione LinuxServer di qBittorrent.

Il suggerimento di LinuxServer era un'immagine alternativa

Riquadro dell'app qBittorrent di LinuxServer in un app store
Una risposta della community suggeriva invece l'immagine qBittorrent di LinuxServer. Fonte: forum della community IceWhale.
Pagina della release di LinuxServer qBittorrent per 5.1.4 r2 ls441
La discussione rimandava a una release del container qBittorrent di LinuxServer, non a un file da installare direttamente in ZimaOS. Fonte: forum della community IceWhale.

Gli elementi della release mostrati nello screenshot sono download del codice sorgente, non pacchetti da caricare in ZimaOS. Un'installazione containerizzata di qBittorrent dovrebbe fare riferimento all'immagine Docker e ricreare il container con le impostazioni corrette.

La guida al container qBittorrent è utile una volta avviata la WebUI e quando devi convalidare le mappature dello spazio di archiviazione.

I menu dell'App Store sono cambiati tra le versioni di ZimaOS

Menu a discesa dei repository delle app di ZimaOS con le fonti della community
Un'altra risposta mostrava il menu delle fonti dei repository disponibile in un layout più recente dell'App Store. Fonte: forum della community IceWhale.
Dashboard di ZimaOS con l'App Store evidenziato
L'utente ha individuato l'App Store nell'interfaccia mista in inglese e ceco. Fonte: forum della community IceWhale.
Interfaccia di ZimaOS per aggiungere un'applicazione containerizzata
L'interfaccia più recente mostrava un'azione “Aggiungi applicazione containerizzata” invece del menu esatto mostrato da un altro utente. Fonte: forum della community IceWhale.
Modulo di installazione manuale delle app di ZimaOS
Il modulo di installazione manuale consente agli utenti di definire l'immagine, la Web UI, le porte, lo spazio di archiviazione e le variabili d'ambiente. Fonte: forum della community IceWhale.

Questi screenshot mostrano perché le istruzioni dettagliate dei vecchi menu diventano rapidamente obsolete. Le fonti dei repository e l'installazione manuale dei container sono state spostate nell'interfaccia dell'App Store tra una versione e l'altra.

Usa il layout attuale dell'App Store nella versione di ZimaOS installata, invece di cercare di riprodurre esattamente uno screenshot della versione 1.5.4.

In sintesi

Il caso originale non ha dimostrato una soluzione definitiva. Inizia dai log e dalla mappatura della WebUI/configurazione; non aggiungere dispositivi né usare la modalità privilegiata senza una necessità documentata. Se passi a LinuxServer, distribuisci l'immagine del container attuale con le porte richieste, /config, PUID/PGID e il flusso di lavoro con password generata, invece di scaricare gli archivi del codice sorgente da GitHub.