元のスレッドは、外部の2023年チュートリアルを紹介するものであり、Frigateの完全なデプロイ記録ではありません。CasaOSにFrigateをインストールし、Google Coralとカメラを統合すると説明されていますが、その時点で使用されていたDockerイメージ、ボリューム、ポート、共有メモリサイズ、検出器の設定は記録されていません。
現在のセットアップでは、Frigateの公式メンテナンスドキュメントを技術的な基準としてください。Docker Composeは引き続き推奨インストール方法ですが、Google Coralは現在、複数あるハードウェアアクセラレーションの選択肢や検出器・映像処理パスの一つにすぎません。
現在のFrigateはDocker Composeを推奨
Frigateの現在のインストールガイドでは、ghcr.io/blakeblackshear/frigate:stable、永続化された設定・メディア、明示的な共有メモリサイズ、選択したアクセラレーターに応じたデバイスマッピングを使用しています。
2023年の動画をそのままコピーするのではなく、現在のFrigateのインストールモデルを使用してください。
コンテナ外に/configを永続化する
FrigateのYAML設定は、/configにマッピングしたホストフォルダーに置きます。コンテナを再作成してもカメラ、検出器、録画、ゾーン、スナップショットの設定が消えないよう、CasaOSの永続ストレージに保存してください。
録画とクリップを実ストレージにマッピングする
NVRの映像は通常のAppDataよりはるかに速く容量を消費することがあります。録画、クリップ、エクスポートは、小容量のOSディスクではなく、十分な容量のあるストレージボリュームに保存してください。
共有メモリはカメラの負荷に合わせる必要がある
Frigateは映像処理に共有メモリを使用します。現在のCompose例には明示的なshm_sizeが含まれており、適切な値はカメラの解像度と台数によって異なります。
Google Coralは任意であり、必須ではない
2023年の情報源ではGoogle Coralが強調されていました。現在のFrigateでもUSBおよびPCIe Coralのマッピングが説明されていますが、最新のデプロイでは、ハードウェアに応じてIntel/AMDの映像アクセラレーション、Intel NPU、その他の対応検出器パスを使用することもできます。
ハードウェアアクセラレーションには正しいデバイスマッピングが必要
現在の例には、USB Coral用の/dev/bus/usb、PCIe Coral用の/dev/apex_0、Intel/AMDグラフィックス用の/dev/dri/renderD128、対応するIntel NPUパス用の/dev/accelが含まれています。Frigateが実際に必要とするハードウェアだけを許可してください。
特権モードは必ずしも必要ではない
Frigateの現在のCompose例では、すべての構成でprivileged: trueが必要とは限らないと説明されています。明示的なデバイスマッピングと権限で十分な場合は、最小権限にするのが望ましいです。
カメラの認証情報とRTSPエンドポイントを非公開にする
Frigateの設定には、カメラのユーザー名、パスワード、RTSP URLが含まれることがよくあります。完全な設定ファイルやスクリーンショットを公開する場合は、秘密情報を必ず隠してください。また、RTSPをインターネットに直接公開しないでください。
CasaOSはコンテナホストであり、Frigateの設定レイヤーではない
CasaOSはコンテナの起動、ストレージやデバイスのマッピングを行えますが、NVRの動作を制御するのはFrigateのYAMLです。アプリは開くのにカメラが動作しない場合は、CasaOSを繰り返し再インストールするのではなく、Frigateのログと設定を確認してください。
物体検出と映像デコードは異なるアクセラレーション処理
Coralアクセラレーターは、対応する物体検出推論に使用されます。Intel/AMD/NVIDIAの映像ハードウェアは、デコードやエンコードを高速化できます。一方が自動的に他方の代わりになるわけではありません。
「ハードウェアアクセラレーション」を1つのチェックボックスとして扱うのではなく、検出器の負荷とカメラのコーデック・トランスコードの負荷の両方を考慮してFrigateスタックを設計してください。
複数のカメラを有効にする前に保存期間を設定する
連続録画はディスクをすぐにいっぱいにする可能性があります。ビットレート × カメラ台数 × 保存日数で容量を見積もり、ファイルシステムの余裕を残したうえで、長期保存が必要なイベントとローリング録画を分けて決めてください。
初回起動後にFrigateのログとヘルス状態を確認する
すべてのカメラを追加する前に、1つのストリームを検証し、検出器やデバイスが認識されていることを確認して、共有メモリ、FFmpeg、権限に関するエラーがないかコンテナログを確認してください。5台のカメラで同時に問題を調査するより、正常に動作する1台から拡張するほうが簡単です。
CasaOS上のFrigateに関するFAQ
元のコミュニティ投稿には、完全なFrigate Composeファイルが含まれていますか？
いいえ。主に外部の2023年チュートリアルを紹介しているだけです。
現在のFrigateでGoogle Coralは必須ですか？
いいえ。Coralは対応している選択肢の一つですが、現在のFrigateはホストに応じて他のハードウェアパスにも対応しています。
常に永続化すべきものは何ですか？
最低限、Frigateの設定と、保持したいメディア・録画ストレージを永続化してください。
