ZimaOSのDockerアプリがインターネットにアクセスできない理由

ISPを変更してZimaOSを再インストールした後、あるコミュニティメンバーは、ホストからインターネット上のサイトにpingを送信でき、App Storeのイメージもダウンロードできる一方で、コンテナ内のアプリケーションから外部サービスに接続できないことに気づきました。qBittorrentではダウンロードできず、Jellyfinではメタデータを取得できませんでした。

元の事例は、問題のあるコンテナのネットワークモードをブリッジネットワークからホストモードに変更することで解決しました。その後の返信では、似た症状を示す別の事例が紹介されましたが、原因は異なっていました。パブリックWANアドレスがゲートウェイとして入力されており、さらにユーザーのISP経路ではJellyfinでIPv4と併せてIPv6も必要でした。

ホストの接続性だけではコンテナの接続性は証明できない

投稿者はZimaOSのWebターミナルを使用してアプリをインストールできたため、オペレーティングシステム自体には正常な外向き通信経路があることが示されました。しかし、それだけでは各Dockerネットワークに正しいルーティングが設定されていることまでは確認できません。したがって、アプリの障害はホストの状態から推測するのではなく、コンテナ側からテストする必要がありました。

ZimaチームのメンバーであるGiorgioは、ブラウザーコンテナを使って接続性をテストし、アプリケーションの設定パネルから別のネットワークモードを試すことを提案しました。また、サードパーティーストア、YAMLインストール、CLIインストールから診断用アプリを導入できるとも記載されていますが、これらは選択肢であり、必須であることが確認されたわけではありません。

Dockerネットワークモードの設定項目が表示されたZimaOSアプリケーション設定 — ネットワークモードはアプリケーションの設定パネルから変更できます。

ホストモードで元のブリッジネットワークの事例は解決した

投稿者は影響を受けたすべてのコンテナをホストモードに変更し、インターネットアクセスが機能し始めたと報告しました。クリーンインストール後にブリッジモードが機能しなかった理由は、このスレッドでは特定されていません。そのため、この環境で成功した変更としてホストモードを記録すべきであり、ブリッジネットワーク全般に問題がある証拠とみなすべきではありません。

後の参加者は、重要な副作用について指摘しました。モードを切り替えた後も、ダッシュボードのリンクが以前に公開されていたホストポートを指したままになる場合があります。Jellyfinでは、ダッシュボードが引き続きポート8097を開いていたため、その参加者はポート8096に直接アクセスする必要がありました。

コンテナをホストネットワークに切り替えた後に表示されたアプリケーションページ — 後のユーザーは、ネットワークモード変更後に最初は誤ったアドレスへアクセスしていました。

後の事例で誤ったゲートウェイが判明した

2人目のユーザーのJellyfinログには、外部メタデータサービスへの接続中にNo route to hostと表示されていました。コミュニティメンバーは、VPNを使わずにテストし、ZimaOSのネットワーク設定に表示されているゲートウェイを確認するよう勧めました。

スクリーンショットから、設定されたゲートウェイがユーザーのパブリックWANアドレスであることが判明しました。返信では、ゲートウェイは同じLANサブネット上にあるローカルルーターのアドレスにすべきだと説明されました。ユーザーはゲートウェイを修正し、AT&T接続ではIPv6が優先されるため、JellyfinでIPv4と併せてIPv6も有効にしました。その後、メタデータと画像を取得できるようになったことを確認しました。

コミュニティで調査されたゲートウェイ値が表示されたZimaOSネットワーク設定 — ゲートウェイ欄をきっかけに、調査の焦点はコンテナイメージからホストのルーティングへ移りました。

コンテナ設定とターミナルを開くために使用するZimaOSアプリメニュー — 設定とコンテナレベルの診断にアクセスするために使用されたアプリメニューです。

コミュニティで得られた2つの結果を分けて考える

2025年10月の元の事例：投稿者のコンテナではブリッジネットワークが機能せず、ホストモードに変更すると接続が回復しました。
2026年1月のフォローアップ事例：ゲートウェイにパブリックIPが設定されており、そのISP経路ではJellyfinでIPv6も有効にする必要がありました。

どちらも大まかには「アプリがインターネットにアクセスできない」という症状でしたが、確認された根本原因は同じではありません。このスレッドからは、ネットワークモード、モード変更後に使用するアドレス、ゲートウェイ設定、VPNの影響、プロトコルの利用可能性を、それぞれ別の切り分け項目として確認すべきことが分かります。

FAQ

ZimaOSではアプリをダウンロードできるのに、コンテナがオフラインのままなのはなぜですか？

ホストとDockerコンテナでは、異なるルーティングやネットワーク設定が使われる場合があります。元の事例では、ホストの接続性は正常なまま、ブリッジネットワーク上のアプリケーションだけが機能しませんでした。

Jellyfinをホストモードに変更すると、以前のダッシュボードポートは維持されますか？

必ずしも維持されるとは限りません。ある参加者は、ダッシュボードが引き続きポート8097にリンクしていた一方で、ホストモードのJellyfinには8096で直接アクセスできることを確認しました。