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

Docker Composeを使ってZimaOSにAgent DVRをインストールする

A new ZimaOS user imported Agent DVR's Docker CLI command and manually created AppData folders before adding the first camera.

Agent DVRはZimaOS上でカスタムDockerアプリとして実行できます。最適な設定では、最新のAgent DVR Dockerイメージを使用し、設定と録画をZimaOSの永続ストレージにマッピングして、ポート8090でWeb UIを公開します。TURN/WebRTCのUDPポートは、カメラやクライアントの利用環境で必要な場合にのみ追加してください。

元のユーザーはベンダー提供のDockerコマンドを正常にインポートしましたが、AppDataフォルダーを手動で作成する必要がありました。現在のAgent DVRコンテナのドキュメントでは、必要な永続パスとGPUデバイスのマッピングがより明確になっています。

ポート8090と永続メディアパスを示すAgent DVRウェブサイトのDocker Runコマンド
コミュニティのユーザーは、ZimaOSのカスタムアプリを作成する際、Agent DVRが公開しているDockerコマンドをベースとしてコピーしました。出典:IceWhaleコミュニティフォーラム。
Agent DVR用のZimaOSカスタムアプリDocker CLIインポートダイアログ
ZimaOSではAgent DVRのDocker CLIコマンドをインポートできますが、ホストのAppDataパスは正しくマッピングする必要があります。出典:IceWhaleコミュニティフォーラム。

最新のAgent DVRコンテナを使用

最新のAgent DVR Dockerガイドには、現在のDockerレイアウトとWebRTCのポート範囲が記載されています。

ZimaOSに永続フォルダーを作成

/DATA/AppData/agentdvr/config
/DATA/AppData/agentdvr/media
/DATA/AppData/agentdvr/models
/DATA/AppData/agentdvr/commands

アプリをインポートする前に設定してください。これにより、コンテナが重要な設定を使い捨てストレージに書き込むのを防げます。

現在のボリュームレイアウトを使用

/DATA/AppData/agentdvr/config:/AgentDVR/Media/XML
/DATA/AppData/agentdvr/media:/AgentDVR/Media/WebServerRoot/Media
/DATA/AppData/agentdvr/models:/AgentDVR/Media/Models
/DATA/AppData/agentdvr/commands:/AgentDVR/Commands

Web UIを8090で公開

コンテナーの起動後、http://ZIMA-IP:8090を開きます。UIが表示されない場合は、カメラの設定を変更する前にコンテナーのログを確認してください。

UDPポートを確認

Agent DVRの現行コンテナーガイドでは、TURN/WebRTCにUDP 3478と50000–50100を使用します。ローカルのみで利用し、リモートWebRTCなしでUIが動作する場合は、必要以上にポートを公開しないでください。

コンテナーが正常に動作してからカメラを追加

まずカメラを1台接続し、ライブ映像と録画先を確認してから、デバイスを追加してください。これにより、コーデック、認証情報、検出、ストレージの問題を特定しやすくなります。

必要な場合にのみGPUデバイスをマウント

Intel/AMDのハードウェアアクセラレーションでは通常、/dev/driを使用します。NVIDIAにはホスト側のNVIDIAランタイム/ツールキットが必要です。GPUパススルーでコンテナーを複雑にする前に、まずソフトウェアデコードが動作することを確認してください。

AppDataと録画データのアクセス権を確認

現在のコンテナーはPUID/PGIDに対応しています。読み取り専用のXML/設定や録画の失敗を避けるため、これらの値をZimaOSのディレクトリの所有者に合わせてください。

更新前にXMLをバックアップ

Agent DVRは重要な設定をXMLディレクトリに保存します。イメージタグやメジャーバージョンを変更する前に、バックアップしてください。

一般的なZimaOSの手順については、カスタムアプリガイドをご覧ください。

よくある質問

Agent DVRのWeb UIのポートは何番ですか?

現在のコンテナー例では、デフォルトは8090です。

録画データはどこに保存されますか?

/AgentDVR/Media/WebServerRoot/Mediaを永続化するホストフォルダーにマウントします。

TURN/WebRTCのポートはすべて必要ですか?

ローカルのみのすべての構成で必要なわけではありません。該当するパスを必要とする機能を使う場合にのみ追加してください。

Agent DVRはIntelまたはAMDのGPUアクセラレーションを利用できますか?

必要な/dev/driデバイスとアプリケーションの設定が正しく構成されていれば、はい。