【Frigate 實作】本地影像辨識完整架設：docker-compose、config.yml、硬體加速與 HA 整合

charles

這篇的內容（21 段）

1. 做完這篇你會有什麼
2. 步驟 2：把攝影機實體接起來
3. A：PoE 攝影機（建議走這條）
4. B：12V DC 供電的攝影機
5. C：戶外安裝的兩件事
6. 驗證的方法：用 VLC 打開
7. 現在該選什麼
8. 實務上的建議
9. 步驟 5：docker-compose.yml
10. 幾個說明
11. 你會看到什麼（正常的樣子）
12. ⚠ 硬碟的選擇
13. 步驟 11：接進 Home Assistant
14. 再裝 HA 這邊的整合
15. 步驟 12：通知自動化
16. 步驟 13：加第二台攝影機
17. 常見問題
18. 一、畫面卡、CPU 很高
19. 二、誤報很多
20. 四、硬碟一直滿
21. 五、要從舊版升級

這篇從「你有一台攝影機、一台主機」開始，做到 Frigate 分得出人、車、貓，只在有事的時候錄影，而且完整接進 Home Assistant。

每一步都有「你會看到什麼」。做完第三步能自己確認第三步成功了，才走第四步。



做完這篇你會有什麼

• 一份可以直接複製的 docker-compose.yml 和 config.yml
  
• 用子碼流做偵測、主碼流做錄影的正確設定（效能差好幾倍）
  
• 開了硬體加速的偵測，CPU 不會被吃光
  
• HA 裡每台攝影機的畫面、偵測到人/車的二元感測器、以及通知自動化
  

目前的穩定版是 Frigate 0.18.0（2026 年 9 月 12 日發布）。下面的設定全部以這一版為準，舊教學的設定格式有好幾處已經不能用，後面會逐一指出。

---

為什麼要本地，以及代價是什麼

• 影像不出家門、沒有月費、網路斷了還是會錄、廠商倒了設備不會變磚
  
• 代價：要自己架、要一台跑得動的主機、硬碟會被塞滿
  

0.18 新增了完整的網頁設定介面，幾乎每個選項都可以在瀏覽器裡點。但手動編輯 YAML 仍然是完全支援的，而且用檔案比較好備份、好在文章裡交代清楚，所以這篇走 YAML。學會了之後你在 UI 裡也知道每個欄位對應什麼。

---

步驟 1：確認你的攝影機能用（買之前就要確認）

只有一個硬條件：支援 RTSP 或 ONVIF。

• 有 RTSP = Frigate 接得到
  
• 沒有 = 只能用廠商的 App，這篇對你沒用
  

怎麼確認：

• 規格表寫「支援 RTSP / ONVIF」
  
• 或搜尋「型號 + RTSP」看有沒有人成功過
  
• 很多消費級攝影機預設把 RTSP 關掉，要在它的 App 裡找到「RTSP」或「本地串流」的開關打開，有些還要另外設一組帳號密碼
  

除了 RTSP 之外要看的：

• 有沒有子碼流（substream / 第二串流） —— 這是效能的關鍵，步驟 8 詳細說
  
• PoE 還是 Wi-Fi —— PoE 穩定太多，一條網路線給電又給資料，而且不會受 Wi-Fi 干擾影響
  
• 夜視 —— 紅外線（黑白）還是彩色夜視（需要補光）
  
• 戶外要看防水等級（IP66 以上）
  

---

步驟 2：把攝影機實體接起來

先確認你的攝影機是哪一種供電，兩種的接法完全不同。

A：PoE 攝影機（建議走這條）

PoE 的意思是「透過網路線同時送電和資料」，所以攝影機那一端只有一條線。

需要的東西：

• PoE 交換器（搜「PoE 交換器 4埠」，約 800-2000 元）—— 或者用 PoE 注入器（搜「PoE injector」，約 300-500 元，只供一台）
  
• 網路線 Cat5e 或 Cat6 —— 室外要買室外級（含防水外披），搜「Cat6 室外網路線」
  

接法：

• PoE 交換器的 PoE 埠 → 網路線 → 攝影機的網路孔
  
• PoE 交換器的上行埠（Uplink） → 網路線 → 你家的路由器
  

⚠ PoE 交換器上的埠不一定每個都供電。 很多型號是「4 個 PoE 埠 + 1 個普通上行埠」，把攝影機接到上行埠的話，攝影機不會開機，而交換器不會有任何提示。買的時候看清楚標示，接的時候看埠位旁邊有沒有印 PoE。

供電瓦數要對得上：

1. PoE 標準        供電端輸出      裝置端可用      夠不夠
2. 802.3af (PoE)   15.4 W         12.95 W        一般定焦攝影機夠
3. 802.3at (PoE+)  30 W           25.5 W         有雲台、加熱器、
4.                                                強力紅外燈的要這個

複製代碼

一般固定式攝影機大約 5 到 12 瓦，802.3af 就夠。有旋轉雲台或戶外加熱功能的要看規格，瓦數不夠的症狀是「開機一下就重啟」或「紅外燈一亮就斷線」 —— 那看起來很像網路問題，其實是電不夠。

網路線長度上限是 100 公尺（Cat5e 和 Cat6 都一樣），含兩端的跳線。超過的話要在中間加一台交換器。

B：12V DC 供電的攝影機

這種要拉兩條線：一條網路線給資料、一條電源線給電。

• 變壓器的輸出 → 攝影機的 DC 電源孔
  
• 攝影機的網路孔 → 網路線 → 你家的路由器或交換器
  

⚠ 極性不要接反。 多數監視器用的 DC 插頭是中心正極（center positive） —— 中間那根針是正極、外殼是負極。變壓器上通常會印一個小圖示標明。接反的話多數攝影機有防呆會直接不動作，但有些會燒掉。

用端子台自己接線的話，紅色是正極、黑色是負極，這是慣例但不是保證 —— 第一次接之前用三用電表量一下（轉到直流電壓檔，紅棒碰紅線、黑棒碰黑線，讀到 +12V 左右就是對的；讀到 -12V 代表反了）。

電壓要對：標 12V 的攝影機不能接 5V（不會動）也不能接 24V（會燒）。安培數則是「大於等於」就好 —— 攝影機標 1A，你用 2A 的變壓器完全沒問題，它只會取它需要的。

C：戶外安裝的兩件事

• 接頭要防水 —— 網路線的 RJ45 接頭泡到水就會出問題。買防水接頭盒（搜「網路線 防水接頭」），或用自融膠帶（搜「自融膠帶 防水」）把接頭整個纏起來。一般電火布會老化脫落，撐不過一個雨季
  
• 線要做一個「滴水彎」 —— 在接頭前面讓線垂下一個 U 形，雨水順著線流到最低點就滴掉，不會沿著線流進接頭。這個動作不用花錢，但沒做的話遲早會進水
  

D：M.2 加速卡的安裝（用 Hailo 或 Coral M.2 才需要）

• 先關機拔電源，不要熱插拔
  
• 確認插槽的 Key 型式對得上 —— M.2 卡的金手指上有缺口，位置不同叫做不同的 Key（常見的是 A+E Key 和 M Key）。Hailo-8L 和 Coral 的 M.2 版本通常是 A+E Key，而主機板上的 M Key 插槽是給 SSD 用的，插不進去也不該硬插
  
• 斜約 30 度插入到底，再壓平，鎖上固定螺絲
  
• 樹莓派 5 要用 PCIe HAT 或 AI Kit 轉接
  

你會看到什麼：接好電之後

• PoE 攝影機 —— 交換器上對應埠位的 PoE 指示燈亮起，攝影機大約 30 秒後啟動（有些會聽到鏡頭對焦的馬達聲）
  
• 在路由器的管理介面看「連線裝置清單」，應該多出一台，那就是攝影機的 IP。把它設成固定 IP 或在路由器做 DHCP 保留 —— 不然哪天 IP 變了，Frigate 就連不到了，而且症狀跟攝影機壞掉一樣
  
• M.2 加速卡 —— 在主機上執行 `lspci` 應該看得到那張卡
  

攝影機完全沒有出現在裝置清單裡：

• PoE 指示燈沒亮 → 接到非 PoE 埠了，或瓦數不夠
  
• 燈亮但沒有 IP → 網路線做壞了（自己壓的接頭最常見），換一條測試過的成品線試試
  

---

步驟 3：找出 RTSP 網址，並且先確認它真的通

這一步一定要先做完再往下走。 後面所有問題有一半其實是網址錯，但症狀看起來像 Frigate 壞掉。

網址長什麼樣：格式是 `rtsp://帳號:密碼@攝影機IP:554/路徑`，路徑每家都不一樣。常見的幾種：

以下還有約 81% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入