ZimaOSでは、古いアーカイブ済みの kerberos/kerberos イメージではなく、現在のKerberos Agentコンテナを使用してください。 現在のプロジェクトでは kerberos/agent を使用し、AMD64 Dockerをサポートしており、カメラ1台につきAgentインスタンスを1つ配置する設計になっています。
録画をSynology NASに保存する場合は、まずZimaOSでSynology共有を確実にマウントし、実際のホスト側マウントパスを確認してから、そのパスをAgentの録画ディレクトリにバインドしてください。NASが再接続するたびに消えるネットワークパスをKerberosに指定しないでください。
古いKerberos Dockerリポジトリはアーカイブ済みです
以前のKerberos Open Source Dockerリポジトリは、現在ユーザーを新しいKerberos Agentプロジェクトリポジトリへ案内しています。
現在のAgentイメージから始める
docker run -p 8080:80 --name camera1 -d --restart=always kerberos/agent:latestホストポート8080を使用すると、ZimaOSホストのポート80を占有せずに済みます。
設定と録画を永続化する
docker run -p 8080:80 --name camera1 -v /DATA/AppData/kerberos/camera1/config:/home/agent/data/config -v /DATA/AppData/kerberos/camera1/recordings:/home/agent/data/recordings -d --restart=always kerberos/agent:latest現在のAgentドキュメントでは、設定と録画に永続ボリュームを使用することが明示的に推奨されています。
カメラ1台につきAgentを1つ使用する
Kerberos Agentは、カメラごとに分離された処理インスタンスとして設計されています。複数のカメラを使用する場合は、名前、Webポート、永続ディレクトリがそれぞれ異なるコンテナを作成してください。
録画先としてSynologyを使用する際の注意点
まずZimaOSでSynologyのSMB/NFS共有をマウントし、再起動後もマウント状態が維持されることを確認してから、findmnt で実際のホスト側マウントパスを確認してください。その安定したホストパスを /home/agent/data/recordings にバインドします。
設定のみをSynology共有に保存しない
Agentの設定をZimaOSのローカルに保存し、録画をSynologyに保存すると、起動時の耐障害性を高められます。Synologyが一時的に利用できない場合でも、Agentは起動してストレージの問題を適切に報告できます。
デフォルトのログイン情報を変更する
現在のKerberos Agentドキュメントには、新規Agentのデフォルト認証情報が引き続き記載されています。ローカルでのテストを超えて使用する前に、直ちに変更してください。
IPカメラにはRTSPを使用する
通常のIPカメラ用途では、Kerberos AgentはRTSP H264/H265カメラフィードを想定しています。コンテナを疑う前に、ストリームが独立して正常に動作することを確認してください。
カスタムDockerガイドでは、一般的なカスタムアプリのワークフローを説明しています。
録画前にSynologyマウントをテストする
findmnt
touch /path/to/synology/test-write
rm /path/to/synology/test-writeKerberos Agentにマッピングする前に、意図した権限でZimaOSホストからマウント済み共有に書き込めることを確認してください。カメラアプリで、その下層にあるSMB/NFSの権限問題を解決することはできません。
Synologyの停止に備える
Synologyが再起動したりネットワーク共有が切断されたりすると、カメラストリームが正常でもAgentの録画に失敗する可能性があります。小容量のローカル録画バッファを用意するか、NAS停止中の録画欠落を許容するかを決めておきましょう。
空き容量と保存期間を監視する
動画はストレージを急速に消費します。保存期間や自動削除のルールを適切に設定し、Synologyの保存先を監視してください。共有NASボリューム上の録画ディレクトリを無制限のままにしないでください。
よくある質問
現在はどのKerberosイメージを使用すべきですか？
現在の kerberos/agent イメージを使用してください。古い kerberos/kerberos プロジェクトはアーカイブ済みです。
録画をSynologyに保存できますか？
はい。Synology共有がZimaOSホストに確実にマウントされ、そのホストパスがAgentの録画ディレクトリにバインドマウントされていれば可能です。
1つのコンテナで複数のカメラを管理できますか？
現在のAgentモデルは、カメラ1台につきAgentインスタンスを1つ配置する設計になっています。
AgentのUIはどのポートを使用しますか？
コンテナはポート80で待ち受けます。8080など、空いているZimaOSホストポートに割り当ててください。
