フリゲート艦のトラブルシューティングとカメラ設定

最終更新日: 2026年09月15日
著者： アルベルト・ナバロ

  • Frigateの設定を変更する前に、VLCまたはffplayでRTSPアドレスを確認してください。それでも動作しない場合は、カメラ、認証情報、またはネットワークに問題があります。
  • 検出にはセカンダリストリームを使用し、高解像度ストリームは録画用に確保してください。
  • フレーム欠落エラーは通常、URLの誤り、ネットワーク障害、接続制限、または互換性のないビデオアクセラレーションが原因で発生します。
  • 動画を保存するには、録画権限を持つストリームを用意し、録画を有効にして、保持ポリシーを定義する必要があります。
フリゲート艦でカメラ接続エラーが発生

Frigate を使用したビデオ監視システムの設定により、録画をクラウドに送信することなく、人、車両、その他の物体を検出できます。ただし、インストール中に、 画像が表示されないカメラライブストリームが途切れたり、FFmpegがフレームを受信できないことを示すメッセージが表示されたりします。

これらの失敗は通常、人工知能とは関係ありません。ほとんどの場合、原因は RTSP URLが正しくありません無効な認証情報、互換性のないストリーム、ネットワークの問題、またはFrigateの設定エラーが原因の可能性があります。最も迅速なトラブルシューティング方法は、各コンポーネントを個別に確認することです。まずカメラ、次にストリーム、次にFrigate、最後にgo2rtc、MQTT、Home Assistantなどの追加サービスを確認してください。

まず、カメラの接続を確認してください。

IPカメラの接続を確認する

設定ファイルを変更する前に、カメラが単独で動作していることを確認してください。Frigate は、通常、互換性のあるストリームにアクセスする必要があります。 RTSPただし、一部のモデルではHTTP-FLVなどの他のフォーマットを使用しています。

カメラのアプリまたは管理パネルに移動して、ローカルアクセス、RTSP、またはONVIFが有効になっていることを確認します。一部のメーカーでは、 外部アプリケーション専用のアカウントクラウドサービスへのアクセスに使用するものとは異なる。

ルーターからカメラに固定IPアドレスを割り当てることをお勧めします。再起動後にIPアドレスが変更されると、Frigateは古いIPアドレスへの接続を試み続け、ビデオが動作しなくなります。

流れの方向は通常、次のような構造をしています。

rtsp://usuario:contraseñ[email protected]:554/ruta_del_stream

正確なパスはメーカーとモデルによって異なります。正しいかどうかを確認するには、次のURLを開いてください。 VLCまたはffplayこれらのプレイヤーでも動作しない場合は、現時点ではFrigateをいじる価値はありません。カメラから提供されるIPアドレス、ポート、認証情報、およびパスを確認する必要があります。

パスワードに次のような文字が含まれている場合 @, #, : o /これらはURLを破損させる可能性があります。その場合は、Frigateと互換性のある環境変数を使用するか、特殊文字を適切にエンコードしてください。

PCセキュリティカメラソフトウェア
関連記事：
PC向けセキュリティカメラ用おすすめプログラム

フリゲートウィザードを使用してカメラを追加します

現在のバージョンでは、カメラを追加する推奨方法は、インターフェースに含まれているウィザードを使用することです。 設定 > グローバル設定 > カメラ管理 選択して カメラを追加.

限定コンテンツ - ここをクリックしてください  Voice.AIでライブで声を変えるための完全ガイド

ウィザードを使用すると、IPアドレスと認証情報を入力したり、ONVIFを使用してプロファイルを検索したり、RTSP URLを手動で入力したりできます。その後、各ストリームをテストし、スクリーンショットを表示し、その機能を割り当てることができます。

  • 検出する： 動きや物体を検出するために使用されるストリーム。
  • 記録： そのセグメントが録画として保存されるストリーム。
  • オーディオ： 音の検出に使用されるストリーム。

通常は、 低解像度サブストリームを検出 そして、メインストリームは録画用です。このようにして、Frigateはより明るい画像を解析しますが、録画データは元の品質を維持します。

アシスタントは、検出の解像度が高すぎる、役割を持つストリームがないなどの一般的な問題も検出します。 detect または、互換性のないオーディオコーデック。

YAML設定と各ストリームの役割を確認してください。

YAML を使用してカメラを手動で設定することもできます。このフォーマットはインデントを使用して構造を表すため、 タブは使用しないでください また、異なる量のスペースを混ぜ合わせることも避けてください。

2つのストリームを使用した基本的な設定は次のようになります。

mqtt:
  enabled: false

record:
  enabled: true
  continuous:
    days: 3

cameras:
  entrada:
    ffmpeg:
      inputs:
        - path: rtsp://usuario:{FRIGATE_RTSP_PASSWORD}@192.168.1.50:554/substream
          roles:
            - detect
        - path: rtsp://usuario:{FRIGATE_RTSP_PASSWORD}@192.168.1.50:554/mainstream
          roles:
            - record
    detect:
      width: 1280
      height: 720
      fps: 5

パスは単なる例であり、お使いのカメラに対応するパスに置き換える必要があります。パスワードは、名前がで始まる変数に保存できます。 FRIGATE_ファイル内に直接公開しないようにする。

汎用的な YAML バリデーターだけに頼るのではなく、 フリゲート艦構成エディタ外部バリデーターはインデントエラーを検出できますが、特定のキーが存在するかどうか、またはインストールされているバージョンと互換性があるかどうかはわかりません。

「フレームがありません」というエラーが表示された場合の対処法

フリゲート艦でフレーム受信エラーが発生しました

次のようなメッセージ 「ffmpegプロセスからフレームを読み取ることができません」 o 「フレームは届いていません」 それらの情報によると、動画を撮影するプロセスがフリゲート艦に画像を送信していないとのことだ。

システムセクションからログを開き、影響を受けたカメラに対応する行を探します。最も一般的な原因は次のとおりです。

  • カメラのIPアドレスが変更されました。
  • ユーザー名またはパスワードが間違っています。
  • そのRTSPルートは別のカメラモデルに属しています。
  • ファームウェアは同時接続数を制限します。
  • カメラがWi-Fi接続を失うか、ストリームを再開します。
  • 互換性のないビデオアクセラレーションが設定されています。
  • カメラから出力されるコーデックまたはパラメータが無効です。

go2rtc を使用する場合は、ストリームの状態も確認してください。 /api/go2rtc/streamsこれにより、go2rtcがカメラに接続できるかどうか、またカメラがどのようなコーデックを受信して​​いるかを確認できます。

カメラが複数のトランスポートプロトコルに対応している場合、パケット損失が発生するネットワークでは、TCP上でRTSPをテストすることで安定性を向上させることができます。ただし、映像を連続的に送信するカメラの場合は、Wi-Fiよりもイーサネット接続の方が依然として望ましいです。

限定コンテンツ - ここをクリックしてください  携帯電話やパソコンから無料でオンラインファックスを送信する方法

動画は再生できるが、Frigateは録画を保存しない。

映像がライブで表示されているからといって、録画が正しく設定されているとは限りません。ビデオを保存するには、次の3つの条件を満たす必要があります。役割を持つストリームが存在すること。 record録画機能を有効にする必要があり、かつ保存ポリシーが定義されている必要があります。

古代の鍵 retain_days これは現在の構成では使用しないでください。3日間の動画全体を保存するには、正しい構造は次のとおりです。

record:
  enabled: true
  continuous:
    days: 3

ディスク使用量を減らし、データ移動があった期間のデータのみを保持したい場合は、以下の方法を使用できます。

record:
  enabled: true
  motion:
    days: 3
  alerts:
    retain:
      days: 10
      mode: motion
  detections:
    retain:
      days: 10
      mode: motion

録音データは以下に保存されます /media/frigate/recordingsボリュームが正しい場所にマウントされていること、書き込み権限があること、そして十分な空き容量があることを確認してください。マウントが正しくないと、Frigateが誤ってシステムディスクに書き込みを行い、ディスクがすぐにいっぱいになってしまう可能性があります。

コーデックについても考慮する必要があります。H.265で録画した動画はすべてのブラウザで再生できるとは限りませんが、H.264ははるかに高い互換性を提供します。ファイルが存在するにもかかわらずインターフェースから再生できない場合は、カメラではなくブラウザに問題がある可能性があります。

Home AssistantおよびMQTTとの統合

FrigateをHome Assistantと統合するには、Frigate統合をインストールし、事前にMQTT統合を設定する必要があります。さらに、両方のシステムが接続されている必要があります。 同じMQTTブローカー これにより、多くの機器、センサー、カウンターが正しく機能するようになります。

基本的な構成は以下のようになります。

mqtt:
  enabled: true
  host: 192.168.1.20
  user: frigate
  password: "{FRIGATE_MQTT_PASSWORD}"

Home Assistantとの連携を追加する際には、内部Frigate URLも指定する必要があります。ポートを使用できます。 5000認証を組み込んでいない、または 8971認証アクセスを提供するポートです。ポート5000は、信頼できるネットワーク内でのみ公開してください。

Home AssistantでFrigateを使用する方法
関連記事：
FrigateをHome Assistantに統合するための完全ガイド

ライブビデオの場合、2つのポートを区別すると便利です。

  • 8554: go2rtcによって提供されるRTSPリストリーム。
  • 8555 TCPとUDP: WebRTC接続。

リストリームは次のようなアドレスで開くことができます。 rtsp://IP_DEL_SERVIDOR:8554/nombre_streamHome Assistantが別のネットワーク、別のVLAN上にある場合、または特定のプロキシの背後にある場合は、WebRTCを候補として設定する必要がある場合があります。 フリゲートサーバーの実際のアドレス クライアントデバイスからアクセス可能なもの。

TraefikのようなHTTPリバースプロキシを使用してWebインターフェースにアクセスすることはできますが、RTSPやWebRTCが直接使用するポートの公開を置き換えるものではありません。

CPU使用率を正しく削減する

Frigateにおけるビデオアクセラレーションと物体検出を担うサーバーラック。

フリゲート艦は複数の異なる任務を遂行し、それぞれの任務には異なる部品が使用される場合がある。 ビデオデコード これはFFmpegに対応しており、内蔵GPUまたは専用GPUで高速化できます。 物体検出代わりに、Coral、Hailo、OpenVINO、ONNX、TensorRTなどの検出器を使用します。

限定コンテンツ - ここをクリックしてください  人工知能を用いた契約書レビュー完全ガイド

Coral USB を使用すると、検出モデルの実行に必要な作業を大幅に削減できますが、ストリーム デコードを本質的に高速化するわけではありません。そのためには、プリセットを構成する必要があります。 hwaccel_args サーバーハードウェアと互換性があります。

例えば、多くの互換性のあるIntelおよびAMDシステムでは以下を使用できます。

ffmpeg:
  hwaccel_args: preset-vaapi

お使いの機器との互換性を確認せずにこの値をコピーしないでください。誤った設定を行うと、選択したアクセラレーションが失敗した場合にソフトウェアが自動的に置き換えられるとは限らないため、FFmpegが繰り返しクラッシュする可能性があります。

さらに、FrigateのCPU使用率の数値をプロセッサ全体の使用状況を表すものとして解釈しないようにしてください。Frigateの統計情報では、通常、100%の使用率はプロセッサ全体を使用していることを意味します。 シングルコア総消費量を調べるには、データを以下と比較してください。 docker stats または、ホストシステムのモニターを使用します。

録音に影響を与えずに負荷を軽減するには：

  • サブストリームを使用して detect.
  • 検出速度を約5FPSに設定してください。
  • 高解像度ストリームを予約する record.
  • 互換性のあるハードウェアデコードを有効にします。
  • テスト用CPU検出器の代わりに、適切な検出器を使用してください。
  • 同じカメラに対して、複数の不要な接続を開くことは避けてください。

カメラがまだ動作しない場合のチェックリスト

壁に取り付けられた最新の防犯カメラ。RTSPを介したビデオ監視接続を示している。

  1. カメラがそのIPアドレスで応答していることを確認してください。
  2. VLCまたはffplayを使用して、正確なURLを確認してください。
  3. カメラでRTSPまたはONVIFが有効になっていることを確認してください。
  4. ユーザー名、パスワード、ポート番号、および特殊文字を確認してください。
  5. フリゲート艦のカメラ追加ウィザードからストリーミングを試してみてください。
  6. 役割を確認してください detect y record.
  7. FFmpegとキャプチャログを確認してください。
  8. 一時的に無効にする hwaccel_args FFmpegが再起動した場合。
  9. go2rtcストリームと、再ストリームで使用されている名前を確認してください。
  10. スペース、セットアップ、許可を確認してください /media/frigate.
  11. FrigateとHome Assistantが同じMQTTブローカーを使用していることを確認してください。
  12. RTSPまたはWebRTCが必要な場合は、ポート8554と8555を適切に公開してください。

この手順に従うことで、複数のオプションを一度に変更することを避け、ストリームが中断されている箇所を特定できます。カメラがVLCで正常に動作し、ストリームがgo2rtcで正しく表示され、FFmpegでエラーが表示されない場合、問題は通常、役割、録画保持、またはビデオの表示に使用される統合に関連しています。

安定した構成を実現するには、各機能を適切に分離することが重要です。具体的には、画像解析用の軽量ストリーム、記録用の高品質ストリーム、デコード用の専用アクセラレーション、そして人工知能に適した検出器を用意します。この構造により、Frigateは中断や過剰なリソース消費なしに長期間運用できます。