ソフトウェア/Frigate NVR の変更点

更新


#author("2026-11-07T14:09:40+00:00","","")
#author("2026-11-07T14:10:09+00:00","","")
[[公開メモ]]

* 監視カメラを Frigate NVR で制御する [#l758632e]

WIFI 接続の監視カメラをオープンソースの NVR: Network Video Recorder である Frigate から使えるようにしたのだけど、2つの異なるカメラがそれぞれ癖のあるものだったため大変苦労した。

どちらも本来は標準化されたプロトコルで動くのだけれど、
- それらのプロトコルをどのポート番号で待ち受けているのか
- 2つずつあるレンズに対応するリソース名が何なのか
- カメラ制御(RTZ)がエラーになる理由

が分からなかったのが原因だったため、忘れないように書いておく。

- 動画ストリーミングプロトコル RTSP
- カメラ制御(RTZ)プロトコル ONVIF

** 目次 [#i656af60]

#contents

* カメラの特性 [#if75b9a1]

** CAM720 というソフトで動くやつ [#dfd09a9d]

&ref(Pasted image 20261107220812.png);

2つのレンズはリソース名で区別される。

- ポート番号(TCP)
-- 554: RTSP (works over TCP)
-- 8899: ONVIF (/onvif/device_service)
-- 80: HTTP
- リソース名
-- Lens 1
--- `live/ch00_0` = 2304x1296, H.264 + G.711 audio
--- `live/ch00_1` = 640x360
-- Lens 2
--- `live/ch01_0` = 2304x1296, H.264 + G.711 audio
--- `live/ch01_1` = 640x360
- ONVIF のバグ
-- SOAP リクエスト本文の要素に名前空間の接頭辞(ns0:)が付いていると、命令を認識できない(HTTP 400 ActionNotSupported が出る)
-- Frigate は接頭辞付きのリクエストを投げるため、RTZ が有効にならなかった
-- 回避策: Frigate とカメラの間にプロキシを入れて、リクエストの接頭辞を削除するようにした

** RZ380 というソフトで動くやつ [#v4e6db37]

&ref(Pasted image 20261107220738.png);

2つのレンズはポート番号で区別される。

- ポート番号(TCP)
-- 10554:RTSP(Lens1)
-- 10555:RTSP(Lens2)
-- 10080:ONVIF(`/onvif/device_service`、`media_service`、`ptz_services`)
- リソース名
-- `tcp/av0_0` = 1920×1080、H.264+audio
-- `tcp/av0_1` = 640×360
- ONVIF のバグ
-- `GetProfiles` に対する応答で、プロファイルの直下に非標準の `<tt:AnalyticsEngineConfiguration>` 要素を返してしまう。
-- Frigate はこの要素から先を読み込めず、RTZ が有効にならない
-- 回避策: Frigate とカメラの間にプロキシを入れて、プロファイルレベルの `AnalyticsEngineConfiguration` 要素を取り除くようにした。

** ONVIF プロキシ [#w316f970]

このスクリプトをサービスとして動かしておいて、

Frigate からの ONVIF の接続先を localhost:18899 や localhost:20080 にしておくと、
それぞれ 192.168.0.xxx:8899 の CAM720 カメラ、192.168.0.yy:10080 の RZ380 カメラに
転送してくれる。

RTSP は直接カメラにつなげばいいので、ONVIF のみこのプロキシを通すようにする。

 LANG:python
 #!/usr/bin/env python3
 import sys, io, threading, urllib.request, urllib.error
 import xml.etree.ElementTree as ET
 from http.server import ThreadingHTTPServer, BaseHTTPRequestHandler
 
 PUBLIC_HOST = '192.168.0.zzz'
 ROUTES = {
     18899: ('192.168.0.xxx', 8899),    # CAM720
     20080: ('192.168.0.yyy', 10080),   # RZ380
 }
 TT = '{http://www.onvif.org/ver10/schema}'
 
 def fix_request(b):
     s = b.decode('utf-8', 'replace')
     s = s.replace('xmlns:ns0="', 'xmlns="').replace('<ns0:', '<').replace('</ns0:', '</')
     return s.encode('utf-8')
 
 def fix_response(b, cam, pub):
     if b'AnalyticsEngineConfiguration' in b and b'Profile' in b:
         try:
             for _, (pfx, uri) in ET.iterparse(io.BytesIO(b), events=('start-ns',)):
                 try:
                     ET.register_namespace(pfx, uri)
                 except ValueError:
                     pass
             root = ET.fromstring(b)
             changed = False
             for prof in root.iter():
                 if prof.tag.endswith('}Profiles') or prof.tag.endswith('}Profile'):
                     for ch in list(prof):
                         if ch.tag == TT + 'AnalyticsEngineConfiguration':
                             prof.remove(ch)
                             changed = True
             if changed:
                 b = ET.tostring(root, encoding='utf-8', xml_declaration=True)
         except ET.ParseError:
             pass
     return b.replace(cam.encode(), pub.encode())
 
 class Handler(BaseHTTPRequestHandler):
     def do_POST(self):
         port = self.server.server_address[1]
         host, cport = ROUTES[port]
         n = int(self.headers.get('Content-Length', 0))
         body = fix_request(self.rfile.read(n))
         hdrs = {k: v for k, v in self.headers.items()
                 if k.lower() not in ('host', 'content-length', 'accept-encoding', 'connection')}
         url = 'http://%s:%d%s' % (host, cport, self.path)
         try:
             r = urllib.request.urlopen(urllib.request.Request(url, body, hdrs), timeout=10)
             code, data, rh = r.status, r.read(), r.headers
         except urllib.error.HTTPError as e:
             code, data, rh = e.code, e.read(), e.headers
         except Exception as e:
             self.send_error(502, str(e))
             return
         data = fix_response(data, '%s:%d' % (host, cport), '%s:%d' % (PUBLIC_HOST, port))
         self.send_response(code)
         self.send_header('Content-Type', rh.get('Content-Type', 'application/soap+xml; charset=utf-8'))
         self.send_header('Content-Length', str(len(data)))
         self.end_headers()
         self.wfile.write(data)
 
     def log_message(self, fmt, *args):
         sys.stderr.write('[%d] %s\n' % (self.server.server_address[1], fmt % args))
 
 servers = [ThreadingHTTPServer(('0.0.0.0', p), Handler) for p in ROUTES]
 for s in servers[1:]:
     threading.Thread(target=s.serve_forever, daemon=True).start()
 servers[0].serve_forever()

* Frigate の動かし方 [#gc599254]

docker で簡単に動かせる

frigate/docker-compose.yml
 services:
   frigate:
     container_name: frigate
     image: ghcr.io/blakeblackshear/frigate:stable
     restart: unless-stopped
     shm_size: "256mb"
     # Intel の内蔵 GPU を docker に見せる(デコードと検知を軽くできる)
     devices:
       - /dev/dri/renderD128:/dev/dri/renderD128
     volumes:
       - /etc/localtime:/etc/localtime:ro
       - ./config:/config
       - ./storage:/media/frigate
       - type: tmpfs
         target: /tmp/cache
         tmpfs:
           size: 1000000000
     ports:
       - "192.168.0.X:8971:8971" # LAN に向けた IP アドレス
     environment:
       FRIGATE_RTSP_PASSWORD: "カメラのRTSPパスワード"

frigate/config/config.yaml の設定は上記の情報を与えて AI に聞けば分かるはず

* GPU を使ったアクセラレーション [#a4a612ea]

Frigate を入れたのは非力な N100 のミニPCだったのだけれど、CPU 内臓の GPU を使うことによりそこそこの負荷で Frigate を動かせるようだった。

frigate/config/config.yaml に以下を入れたところ CPU 負荷が大幅に減った。

 detectors:
   ov:
       type: openvino
       device: GPU
 
 model:
   width: 300
   height: 300
   input_tensor: nhwc
   input_pixel_format: bgr
   path: /openvino-model/ssdlite_mobilenet_v2.xml
   labelmap_path: /openvino-model/coco_91cl_bkgr.txt
 
 ffmpeg:
   hwaccel_args: preset-vaapi
* コメント・質問 [#d6476a20]

#article_kcaptcha

Counter: 123 (from 2010/06/03), today: 8, yesterday: 4