摄像头接入

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（中国国家標準 — Hikvision / Dahua / Uniview の NVR·IPC·DVR）

GB/T 28181 対応機器は SkyView に自動登録されます——カメラごとに RTSP アドレスを入力する必要はなく、1 台の NVR 配下の複数チャンネルも一括取り込みできます。Hikvision / Dahua / Uniview の国標 IPC・NVR・DVR の多くは「上位プラットフォーム接続（GB28181）」を内蔵しています。SkyView 0.9.13 以降が必要です。

ステップ 1 — SkyView で GB28181 を有効化

1. 1

   スイッチをオン

   Web Admin → 設定 → GB28181 →「有効化」をオン。

2. 2

   登録パスワードを設定

   機器に入力するプラットフォームパラメータが表示され、登録パスワード（全機器共通）を設定します。既定のパラメータはそのまま使えることがほとんどです。

3. 3

   リモート接続は extern_host を設定

   機器と SkyView が別ネットワークの場合、機器から折り返し到達できる自分側のアドレス（グローバル IP やルーターでマッピングしたアドレス）を「extern_host」に入力します。同一サブネットの直結なら空欄で構いません。

4. 4

   保存

   保存すると GB28181 サービスが 25060 で待ち受けを開始し、機器の登録を待ちます。

ステップ 2 — 機器 / NVR 側で「上位プラットフォーム」を設定

機器の Web 管理画面で「プラットフォーム接続 / GB28181 / 上位プラットフォーム」（呼称はベンダーで異なる）を開き、下表のとおり入力します。保存すると機器が自動登録され、NVR は配下の全チャンネルをまとめて報告します：

ステップ 3 — チャンネルを取り込み、通常のカメラとして使う

Web Admin → GB28181 ページ →「取り込み待ちの機器 / チャンネル」に、登録に成功した機器・NVR チャンネルが表示されます。使うチャンネルにチェックを入れて「取り込み」（複数選択可。NVR の全チャンネルを一度に取り込み）。取り込み後は通常のカメラと同じく、ライブ・録画・AI 検知・スナップショット・オンライン状態・PTZ + プリセット・双方向通話・機器側の録画再生がすべて使え、RTSP / ONVIF カメラと UI 上の違いはありません。