攝影機接入

ONVIF 自動探索（首選）

如果攝影機和 雲瞰 在同一區域網路，且攝影機開啟了 ONVIF（出廠預設開啟）：

1. 1

   掃描

   網頁後台 → 攝影機 → 新增 → 選「ONVIF 自動探索」，幾秒後列出區域網路內所有 ONVIF 裝置

2. 2

   選擇目標

   找到 IP / MAC / 廠牌和自己攝影機相符的項目，點選

3. 3

   填寫憑證

   ONVIF 使用者名稱與密碼（不一定和 RTSP 密碼相同！海康 / 大華出廠常見是 admin/12345 之類）

4. 4

   儲存

   雲瞰 自動協商主串流 / 子串流位址，並把 PTZ / 對講連接埠探測出來一併存好

手動 RTSP

ONVIF 不支援或拿到錯誤位址時，用手動方式新增。需要從廠商手冊或 IPC App 裡找出 RTSP URL，常見格式：

Tapo / 小米 / Wyze 等私有協定 → go2rtc 橋接

TP-Link Tapo C100/C200/C220、小米米家、Wyze 這類消費級攝影機不開放標準 RTSP，但社群專案 go2rtc 能把它們橋接成 RTSP，讓 雲瞰 接入。

1. 1

   啟動一個 go2rtc 容器

   和 雲瞰 同一台機器即可，連接埠 1984 是 go2rtc 的網頁介面、8554 是它對外提供的 RTSP。

   bash複製

   docker run -d --name go2rtc \
     --restart=always \
     --network host \
     -v $(pwd)/go2rtc.yaml:/config/go2rtc.yaml \
     alexxit/go2rtc

2. 2

   在 go2rtc.yaml 裡設定攝影機

   Tapo 範例：用 Tapo App 的訪客帳號即可。

   yaml複製

   streams:
     livingroom: tapo://訪客密碼@攝影機IP:554/stream1
     kitchen: tapo://訪客密碼@另一台IP:554/stream1

3. 3

   在 雲瞰 裡新增攝影機

   用 RTSP 手動方式，URL 填 rtsp://<go2rtc 主機IP>:8554/livingroom，憑證留空。

子串流的意義

ONVIF / 主流 IPC 都提供兩路：主串流（高畫質，看 Live 用）和子串流（低畫質，AI 偵測用）。雲瞰 會自動透過 ONVIF 取得子串流位址。手動 RTSP 時建議在第二個欄位填子串流 URL，可以讓偵測節省 70%+ 的頻寬和 CPU。

視訊編碼：盡量選 H.264，不要 H.265

H.265（HEVC）在同畫質下位元速率比 H.264 低 40~50%，看起來很省，但瀏覽器播放支援很差——大多數使用者進 Web 後台看 Live 或回放會黑畫面 / 一直轉圈。啟用攝影機前請先把編碼格式改成 H.264。

PTZ 控制（雲台）

透過 ONVIF 接入的攝影機如果支援 PTZ，Live 頁面右下角會自動出現方向 / 縮放按鈕。手動 RTSP 接入的不會自動啟用，需要在攝影機詳情裡手動填入 ONVIF 連接埠（通常是 80 / 8000）和 PTZ 憑證。

對講（Talkback）

支援 ONVIF 對講通道的攝影機可以雙向對講（按住 App 上的麥克風按鈕說話，對方聽得到）。網頁後台暫不支援發起對講，行動端（iOS / Android）才有按住 talk 按鈕。

修改 / 刪除攝影機注意事項

• 修改 RTSP URL 後，偵測可能不會自動重新啟動：因為該攝影機有「偵測失敗」的狀態記錄，需要在攝影機詳情裡點「清除偵測錯誤」才能重新運作
• 刪除攝影機會同步刪除資料庫記錄和串流路徑，但錄影檔案不會刪除——避免誤刪遺失證據。要刪除請手動到 data/recordings/<id>/ 裡刪
• 改名 / 改分組都不會影響錄影和事件歷史

海康 / 大華 / TP-Link Vigi（專業 IPC）

這三家是市面上主流的商用 IPC 品牌，全系列都標準支援 ONVIF + RTSP，與 雲瞰 的相容性最好。出廠預設憑證：

GB28181 國標接入（海康 / 大華 / 宇視 NVR·IPC·DVR）

國標（GB/T 28181）設備會主動註冊進 雲瞰——不用逐台填 RTSP 位址，一台 NVR 底下的多個通道也能批次匯入。海康 / 大華 / 宇視的國標 IPC、NVR、DVR 絕大多數內建「國標上級平台接入」。需要 雲瞰 0.9.13 以上。

第一步：在 雲瞰 裡開啟國標

1. 1

   打開開關

   Web Admin → 設定 → 國標（GB/T 28181） → 打開「啟用」。

2. 2

   設註冊密碼

   頁面會顯示要填進設備的平台參數，並讓你設一個註冊密碼（所有設備共用）。預設平台參數通常可直接使用。

3. 3

   公網部署填 extern_host

   設備和 雲瞰 不在同一區域網路時，把設備能回連到的我方位址（公網 IP 或路由器對應後的位址）填進「extern_host」；同網段裸直連可留空。

4. 4

   儲存

   儲存後國標服務開始在 25060 監聽，等待設備註冊。

第二步：在設備 / NVR 裡設定「國標上級平台」

進設備 Web 後台，找「平台接入 / 國標 28181 / 上級平台」（各家叫法略不同），按下表填。儲存後設備會主動註冊——NVR 會一併回報它底下的所有通道：

第三步：匯入通道，當一般攝影機用

回 Web Admin → 國標 頁 → 「待匯入設備 / 通道」：註冊成功的設備 / NVR 通道會出現在這裡。勾選要用的通道點「匯入」（可批次，一台 NVR 多通道一次搞定）。匯入後這些通道就是一般攝影機——即時影像、錄影、AI 偵測、快照、在線狀態、雲台 + 預置點、語音對講、設備端歷史回放全部可用，和 RTSP / ONVIF 攝影機在介面上沒有區別。