摄像头接入

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 攝影機在介面上沒有區別。