摄像头接入

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 相机在界面上没有区别。