コミュニティソリューション

ZimaOSでqBittorrentが利用できない場合:確認すべきこと

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

ZimaOS 1.5.4でqBittorrentの「サービスを利用できません」ページが表示されても、GPUやデバイスのパススルー、または特権モードが必要という意味ではありません。確認すべきなのは、コンテナログ、WebUIのポートマッピング、生成されたパスワード、永続化された/configパス、そしてアプリイメージ自体が正常に起動しているかどうかです。

元のhotioコンテナについては、元のスレッドで確実な解決策に至りませんでした。コミュニティのメンバーは代わりにLinuxServerベースのアプリを提案し、App Storeからの複数のインストール方法を示しました。そのため、これらの提案は実証済みの修復方法ではなく、代替案として扱うべきです。

元のエラーの状態

ZimaOSにおけるqBittorrentの「サービスを利用できません」エラーページ
内蔵のqBittorrentアプリを開くと、一般的な「サービスを利用できません」ページが表示されました。 出典:IceWhale Community Forum。
ログから管理者パスワードとDATAパスを確認するqBittorrentのヒントダイアログ
ZimaOSには、一時的な管理者パスワードをログから確認することと、アプリからアクセス可能なDATAパスが表示されていました。 出典:IceWhale Community Forum。

qBittorrentのラッパーからアプリケーションに接続できませんでした。ZimaOS自体がすでに起動ログを確認するよう案内しており、これは適切な診断レイヤーです。

再インストールする前に既存のコンテナを確認する

hotioイメージのリリース5.0.4を使用したZimaOSのqBittorrentアプリ設定
ユーザーのアプリ定義では、hotioのqBittorrentイメージ、ブリッジネットワーク、ホストポート8181、コンテナポート8080が使用されていました。 出典:IceWhale Community Forum。
ZimaOSにおけるqBittorrentのPUID、PGID、タイムゾーン、UMASK設定
既存のコンテナには、通常のPUID/PGID、タイムゾーン、UMASKの値がすでに設定されていました。 出典:IceWhale Community Forum。
ZimaOSのqBittorrentの権限とデバイス欄
ユーザーはデバイスまたは特権モードが必要かどうか疑問に思っていましたが、通常のqBittorrent WebUIにそのどちらも必要ありません。 出典:IceWhale Community Forum。

ホストのWebUIポートが、qBittorrentが実際にリッスンしているポートにマッピングされていることを確認します。 /config 永続化されており、コンテナログに設定またはデータベースの起動エラーが表示されていないことを確認します。通常のqBittorrentコンテナにGPUや任意のホストデバイスは必要ありません。

LinuxServerイメージでWebUIポートを変更する場合、現在のドキュメントでは、DockerのポートマッピングとWEBUI_PORTの両方を一致させる必要があります。LinuxServerのqBittorrentドキュメントを参照してください。

LinuxServerの提案は代替イメージでした。

App StoreにあるLinuxServer qBittorrentのアプリタイル
コミュニティからの返信では、代わりにLinuxServerのqBittorrentイメージが提案されていました。 出典:IceWhale Community Forum。
LinuxServer qBittorrent 5.1.4 r2 ls441のリリースページ
スレッドでリンクされていたのはLinuxServerのqBittorrentコンテナのリリースであり、ZimaOSに直接インストールするファイルではありません。 出典:IceWhale Community Forum。

スクリーンショットにあるリリースアセットは、ZimaOSにアップロードするパッケージではなく、ソースコードのダウンロードです。コンテナ化されたqBittorrentのインストールでは、Dockerイメージを指定し、正しい設定でコンテナを再作成する必要があります。

qBittorrentコンテナガイドは、WebUIが起動した後、ストレージマッピングを検証する必要がある場合に役立ちます。

ZimaOSのバージョン間で変更されたApp Storeメニュー

コミュニティソースを一覧表示するZimaOSアプリリポジトリのドロップダウン
別の返信では、より新しいApp Storeレイアウトで利用できるリポジトリソースメニューが示されていました。 出典:IceWhale Community Forum。
App Storeが強調表示されたZimaOSダッシュボード
ユーザーは英語とチェコ語が混在するインターフェースでApp Storeを見つけました。 出典:IceWhale Community Forum。
ZimaOSのApp Storeにあるコンテナアプリケーション追加インターフェース
新しいインターフェースでは、別のユーザーが示したものとまったく同じメニューではなく、「コンテナ化アプリケーションを追加」アクションが表示されました。 出典:IceWhale Community Forum。
ZimaOSのアプリ手動インストールフォーム
手動インストールフォームでは、イメージ、Web UI、ポート、ストレージ、環境変数を定義できます。 出典:IceWhale Community Forum。

これらのスクリーンショットは、古い手順形式のメニュー案内がすぐに古くなる理由を示しています。リリース間で、リポジトリソースとコンテナの手動インストールの場所がApp StoreのUI内で変更されています。

インストール済みのZimaOSバージョンで現在のApp Storeレイアウトを使用し、1.5.4のスクリーンショットを正確に再現しようとしないでください。

要点

元のケースでは、決定的な解決策は一つに絞り込めませんでした。まずログとWebUI/設定のマッピングを確認し、文書化された必要性がない限り、デバイスの追加や特権モードの使用は避けてください。LinuxServerに切り替える場合は、必要なポートを設定して現在のコンテナイメージをデプロイし、 /config、PUID/PGID、生成パスワードのワークフローを使用し、GitHubのソースアーカイブをダウンロードする方法は避けます。