系統架構
Home Assistant NVR:攝影機、錄影、Frigate 與 Scrypted
使用 ONVIF 攝影機、即時串流、片段錄影、Frigate 或 Scrypted 建立 Home Assistant NVR,並明確規劃儲存、編解碼器與安全選項。

簡短答案:將自動化協調與錄影保留分開
Home Assistant 的 Camera 整合是由其他裝置整合提供的基礎元件。它可以把攝影機實體提供給儀表板和自動化、播放相容串流、拍攝快照,並使用 camera.record 建立即時畫面的錄影。這項錄影動作需要 Stream 整合,其輸出路徑必須可以寫入,並且獲 Home Assistant 檔案設定允許。Stream 整合透過 HLS 或低延遲 HLS,在 Home Assistant 內代理相容的即時視訊。
這些文件記載的動作相當實用,但其運作模式與擁有連續錄影、儲存保留和可搜尋錄影時間軸的專用錄影機不同。將 Home Assistant 作為自動化與儀表板層;需要連續錄影或長期檢視時,再選擇 NVR。
三種 Home Assistant 攝影機架構
| 架構 | 攝影機路徑 | 錄影與檢視 | 設定需求 | 最適合 |
|---|---|---|---|---|
| Home Assistant Camera + Stream | Camera 整合提供實體;Stream 將相容的 H.264 或 H.265 代理為 HLS/LL-HLS | 快照、即時檢視及由動作建立的錄影 | Stream 整合、供 camera.record 使用的可寫入且獲允許輸出路徑、瀏覽器相容的編解碼器與音訊 | 儀表板與攝影機自動化 |
| Frigate + Home Assistant | Frigate 錄製及分析攝影機;其官方整合將實體發布至 Home Assistant | 依月份、日期、攝影機與時間整理錄影;Media Browser 中提供物件錄影與快照 | 使用同一訊息代理程式的 MQTT、HACS 整合、Frigate URL,以及供 Media Browser 使用的 media_source | 本機 AI 與專用 NVR 保留 |
| Scrypted + Home Assistant | Scrypted 接收攝影機串流,並將介面整合至 Home Assistant | Scrypted NVR Camera 與 Event Reel 卡片提供其錄影介面 | 即使使用 Home Assistant add-on,也需要透過 HACS 安裝 Scrypted 自訂元件 | 低延遲智慧家庭攝影機檢視與 Scrypted NVR |
編解碼器支援最終仍會影響檢視用戶端。Home Assistant 指出,許多瀏覽器不支援 H.265,Stream 整合也不支援 PCM 音訊,因此 H.265 攝影機或不支援的音軌在不同儀表板和裝置上的表現可能不同。如果廣泛的用戶端播放很重要,請優先使用搭配相容音訊的 H.264 設定檔。
正確連接 ONVIF 攝影機
Home Assistant 官方 ONVIF 整合支援符合 ONVIF Profile S 的裝置,並且需要 FFmpeg 整合。Home Assistant 可以自動探索裝置,也可以接受手動新增的整合項目。文件建議在攝影機上建立專用標準使用者,而不是重複使用管理員帳號。
該整合會新增視訊編碼為 H.264 的相容設定檔。如果 Home Assistant 顯示「No usable cameras were found」,請至少設定一路 H.264 串流;一種實用做法是讓主串流保留 H.265,再將子串流設為 H.264。視裝置支援而定,ONVIF 還能提供動作和其他事件感測器、裝置開關、可選擇的 RTSP 傳輸方式,以及 PTZ 動作。
依照實際需求部署 Frigate
Frigate Home Assistant 整合需要安裝 Home Assistant MQTT 並手動設定。要讓許多整合實體正常運作,Frigate 必須啟用 MQTT 並連接至同一個訊息代理程式。該整合透過 HACS 安裝,而 Media Browser 需要啟用 media_source。
對攝影機而言,Frigate 目前的硬體指南建議使用 H.264 視訊和 AAC 音訊,以最大程度相容 Frigate 與 Home Assistant。多路子串流很實用,因為偵測、即時檢視和錄影可以採用不同解析度,不需要重新編碼。正式環境的工作負載建議使用專用偵測器,但不一定必須是 Google Coral:目前文件支援多種偵測器系列,而且不再建議大多數新安裝使用 Coral。
Home Assistant 還需要一個可以連線的 Frigate URL。對於在另一台本機電腦執行的 Frigate,官方整合指南建議使用經過身分驗證的連接埠 8971。請遵循其 TLS 與憑證指南,不要將未經身分驗證的內部連接埠暴露給不受信任的網路。
儲存、安全與驗證檢查表
將錄影保留交由錄影機層管理,讓刪除、磁碟上限、分段健康狀態和故障復原都有明確的負責方。使用 Home Assistant 執行自動化和顯示狀態,但除了儀表板卡片之外,也要從 NVR 時間軸或 Media Browser 驗證錄影。
- 建立專用的標準 ONVIF 攝影機使用者。
- 確認 Home Assistant 可使用一路 H.264 設定檔。
- 測試即時視訊和
camera.record動作。 - 使用 Frigate 時,確認 MQTT 實體和 Media Browser 錄影。
- 分別重新啟動 Home Assistant、錄影機與一部攝影機。
- 確認保留政策會在儲存空間用盡前刪除舊錄影。
- 在 Home Assistant 與錄影機之間使用經過身分驗證或私人的連線。
如需規劃通訊協定,請閱讀 RTSP 與 ONVIF 比較。如需產品層面的詳細資料,請繼續閱讀 OmniNVR 與 Frigate 比較或 OmniNVR 與 Scrypted NVR 比較。
常見問題
Home Assistant 不使用 Frigate 也能錄製攝影機視訊嗎?
可以。當攝影機和 Stream 整合支援時,官方 Camera 整合會提供 camera.record。請設定 Stream,使用 Home Assistant 允許的可寫入路徑,並測試輸出。若需要連續錄影、受管理的保留政策和以錄影機為核心的時間軸,請使用專用 NVR。
Frigate 一定需要 Google Coral 嗎?
不需要。Frigate 支援多種偵測器類型。其目前硬體指南指出,除了功耗需求特別低或硬體無法使用其他加速器的部署外,大多數新安裝已不再建議使用 Coral。
為什麼 Home Assistant ONVIF 顯示找不到可用攝影機?
Home Assistant 的 ONVIF 整合會尋找 H.264 視訊設定檔。至少將一路攝影機串流設為 H.264;通常可以讓主串流保留 H.265,再使用 H.264 子串流。
資料來源
- Home Assistant — Camera integration
- Home Assistant — record camera feed action
- Home Assistant — Stream integration
- Home Assistant — ONVIF integration
- Frigate — official local AI NVR documentation
- Frigate — official hardware and detector guidance
- Frigate — official Home Assistant integration
- Scrypted — official open-source platform overview
- Scrypted — official Home Assistant integration