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

Docker ComposeでZimaOSにAzuraCastをインストール:セットアップと安定性に関する警告

A community guide for importing an AzuraCast Docker Compose stack into ZimaOS 1.5.3 Plus, followed by an important author update warning that the method could be unstable and that automatic web updating had problems.

このコミュニティチュートリアルでは、変更したDocker Compose設定をカスタマイズアプリとしてインポートし、ZimaOS上でAzuraCastを実行する方法を解説します。2025年12月に公開された元の投稿は、ZimaOS 1.5.3 Plusを搭載したZimaBoardでテストされ、ローカルネットワークまたはTailscale経由でのプライベート利用や家庭での利用を主な対象としていました。

重要: 投稿者はその後、2026年1月5日にスレッドを更新し、追加テストの結果、このインストール方法は不安定になる場合や動作しない場合があり、AzuraCastの自動Web更新にもこの構成に起因する問題があると述べています。この後の訂正は、設定が完全に動作したという元の主張よりも重要です。

元のZimaOSセットアップで使用された構成

元の環境は、Intel Celeron N3450、8 GBメモリ、Intel HD Graphics 500、ZimaOS 1.5.3 Plusを搭載したZimaBoardでした。投稿者は、ZimaOSのカスタムアプリインターフェースから、カスタマイズしたAzuraCast Compose定義をインポートしました。

手順は次のとおりです。

  1. ZimaOSダッシュボードを開き、カスタマイズアプリをインストールを選択します。
  2. インポートを使用して、Docker Compose定義を送信します。
  3. インストール前に、生成されたWebアップデーターの設定を確認します。
  4. ホスト側のポートとZimaOS側のボリュームパスを調整します。ただし、対応するAzuraCastコンテナ側のパスは変更しません。
  5. アプリをインストールし、サーバーアドレスと設定したWeb UIポートを使ってAzuraCastを開きます。

現在のZimaOSドキュメントでも、カスタマイズアプリ用にDocker Compose YAMLをインポートできます。詳しくは現在のZimaOS機能ドキュメントをご覧ください。

コンテナ側のポートを変更せずにホストポートを割り当てる

元の設定では、投稿者はAzuraCastコンテナのポート80、443、8000に対応するホスト側の割り当てを示していました。ローカルのZimaOS環境に合ったポートへホスト側の値を変更し、コンテナ側の値は変更しないことが推奨されています。

インポートしたアプリのホストポートとコンテナポートの割り当てを示すZimaOSのAzuraCast Web設定
コミュニティガイドでは、ホスト側のポートを変更し、AzuraCastコンテナ側のポートは維持しています。これらの値は投稿者のZimaOS 1.5.3環境に基づいています。

アップデータータブにはWeb UIアドレスも含まれていました。このWeb UIポートは、コンテナポート80に割り当てたホスト側ポートと一致させる必要があります。

Webサービスに割り当てられたWeb UIポートを示すZimaOSのAzuraCastアップデーター設定
アップデーターには、AzuraCast Webサービスで選択したものと同じホスト側Web UIポートが設定されていました。

AzuraCastコンテナ側のパスを維持する

投稿者は、AzuraCast側のパスを変更せずに、ZimaOS側の永続ストレージも再割り当てしました。公開されたスタックには、ステーション、バックアップ、MySQLデータ、アップロード、オプションコンポーネント、および独立した音楽ディレクトリ用のストレージが含まれていました。

ホストのストレージパスをAzuraCastコンテナのディレクトリに割り当てるZimaOSのAzuraCastボリューム設定
青色で示されたZimaOS側のパスはローカルストレージに合わせて変更できます。一方、黄色で示されたAzuraCastコンテナ側のパスは、元の設定で使用されているアプリケーション構成を表します。

このガイドでは、管理者が目的を理解していない限り、環境変数を変更しないよう推奨しています。Composeの環境データには、アプリケーションの認証情報やデータベース設定が含まれる場合があるため、特に重要です。

公開されたComposeファイルを再利用可能な秘密情報テンプレートとして扱わない

元のフォーラムYAMLには、データベース関連の環境変数が含まれています。コミュニティページで、公開された値を再利用可能な認証情報テンプレートにしてはいけません。このスタックを再構築する場合は、自分の環境に適した認証情報を使用し、現在のAzuraCast設定ガイドに従ってください。

現在の公式インストールおよび設定情報については、公式AzuraCast Dockerインストールガイドをご利用ください。

投稿者は後に安定性と更新に関する問題を報告した

ガイドの公開から9日後、同じ投稿者が重要な訂正を投稿しました。追加の実験により、この方法は動作しない場合があり、不安定になる可能性もあるという内容です。また、このインストール方法ではAzuraCastの自動Web更新プロセスにも問題があると報告しています。

投稿者はSSHベースのインストールを試しており、より詳しいフォローアップガイドを作成する予定だと述べましたが、このスレッドでは代替手順は公開されていません。そのため、このページは既知の制限があるコミュニティ実験の記録として読むべきであり、現在公式にサポートされているAzuraCast on ZimaOSのインストール方法とみなすべきではありません。

コミュニティの方法を現在のAzuraCastガイダンスと比較する

現在のAzuraCastドキュメントでは、ほとんどのセルフホスト型インストールにDockerを推奨し、独自のDockerインストールおよび更新ワークフローを提供しています。また、更新に失敗するとステーションの停止やデータ損失が発生する可能性があるため、更新前にバックアップを取るよう警告しています。

この過去のZimaOS Composeスタックのアップデーター動作に依存する前に、公式AzuraCast更新ドキュメントをご確認ください。

元のガイドはプライベートネットワークでの利用を想定していた

投稿者は、このチュートリアルをローカルネットワークまたはTailscale経由での家庭内・プライベートアクセス向けとして明確に位置付けていました。インターネットへの公開には、コミュニティ投稿の範囲外である追加のネットワーク、TLS、ファイアウォール、認証、放送セキュリティに関する判断が必要になる場合があります。

ローカルでWeb UIが動作するだけで、公開ラジオサービスの準備が十分に整ったと考えないでください。

ZimaOSでのAzuraCastに関するFAQ

コミュニティの投稿者は、この方法が安定していると確認しましたか?

いいえ。元の投稿は楽観的な内容でしたが、2026年1月5日のフォローアップでは、テストによってはこの方法が不安定になったり、失敗したりする可能性が明確に示されています。

どのバージョンのZimaOSが使われましたか?

元のガイドでは、ZimaBoard上のZimaOS 1.5.3 Plusが使用されていました。スクリーンショットや生成されたアプリ設定は、すべての新しいリリースにそのまま適用できる手順ではなく、過去の例として扱ってください。

AzuraCastコンテナ側のボリュームパスを変更すべきですか?

元のガイドでは、必要に応じてZimaOSホスト側のパスを変更し、AzuraCastコンテナ側のパスは変更しないよう説明しています。

アップデーターのWeb UIポートをWebサービスの割り当てと一致させる必要があるのはなぜですか?

元の設定では、アップデーターのWeb UI項目が、コンテナポート80に割り当てられたホストポートを指していました。異なる値を使用すると、ZimaOSのショートカットが誤ったポートへ接続してしまいます。

このコミュニティスタックでは、AzuraCastの自動更新は安定して動作しますか?

投稿者は、追加テスト後に自動Web更新の問題を具体的に報告しています。過去のアップデーターコンテナが信頼できると仮定せず、現在のAzuraCast更新ドキュメントに従い、バックアップを維持してください。