外观
第 2 章 部署场景
2.1 形态选择
现场具备商业宽带或专线，且客户不限制画面离开场站时，采用远程形态。接入盒成本最低，安装最简单，故障时整机更换。合同约定画面不得离开场站，或现场仅有家庭宽带时，采用本地形态：30 路以内为本地轻，超过 30 路为本地重。条件不明确时，先按勘查单确认宽带与相机情况再做选择。
三种形态共用的部分：相机均按第三码流 H.264、1280×720、8 帧配置；客户管理员均在接入页操作；告警、视频墙与统计功能无差别。
判定能力的位置随形态变化：云托管由处理中心的智悟统一判定，现场不承担判定算力；本地形态需要在本机运行蓝精灵，或在合同允许候选数据（蒙太奇、姿态，不含连续画面）出场站时送云端智悟判定。本地轻的内存要求（64 GB 起）即来自在本机运行蓝精灵。
2.2 宽带要求
上行带宽按每路约 1 Mbps 计算（第三码流定码率 768 Kbps 加传输开销），30 路需要 40 Mbps 以上，并且需要持续可用。家庭宽带的上行通常为 20 至 30 Mbps，可接 15 路以内；更多路数需要商业宽带。
控制面能够判断两项网络条件：盒子自检上报的公网出口类型（锥形 NAT 可直连，对称 NAT 需依赖节点宣告的固定端口），以及同一现场两台盒子是否共用同一出口（出口相同时不构成冗余）。电源条件无法远程判断，依赖勘查登记。
| 自检项 | 检测方法 | 判定 |
|---|---|---|
| 时钟偏差 | 与 HTTPS 响应头的 Date 比较 | 超过 300 秒时签名被拒；安装 chrony 后不会出现 |
| HTTPS 连通 | 连接 link.uanhon.cn | 不通则无法入网 |
| UDP 与 NAT 类型 | 同一 socket 向两个 STUN 服务器各探测一次，映射端口一致记为 eim（锥形） | 锥形可直连；对称 NAT 依赖节点的固定端口宣告 |
| IPv6 | 是否有全球单播地址、能否连接 2400:3200::1 的 53 端口 | 具备 IPv6 的现场直连成功率最高 |
| 相机网段 | 黄口是否有链路、能否发现设备 | 未接相机时记"尚未配置相机" |
运营商级 NAT 的现场需要注意：地址池中每条映射可能分到不同的公网 IP。盒子连续两次读到同一个新地址才判定为出口变更，避免每个心跳周期误判一次。
2.3 硬件配置
接入盒：x86 小型主机（N100 级别），两个千兆网口，8 GB 内存，64 GB 以上硬盘（盒子不存储视频），Debian 12，功耗约 10 W。arm64 主机同样支持（安装包提供 aarch64 版本），出厂预装仅提供 x86。安装位置为弱电箱或机柜，环境温度 0 至 40 ℃，防雨。
本地轻：NVIDIA 桌面显卡，显存 8 GB 起；内存 64 GB 起（判定模型与摘要模型各 20 GB 以上，专家权重放内存、注意力层放显卡）；2 TB NVMe；Ubuntu 24.04；20 至 30 路；安装于值班室或机房。
本地重：DGX Spark 64 GB 或 128 GB，2 TB 以上存储，出厂 DGX OS，50 路以上。
本地两种形态均为桌面级设备，不是宽温工控机。户外机柜或高温车间需要另选工控整机。
2.4 相机要求
支持海康、大华等主流品牌，相机需提供 H.264 的第三码流或子码流。配置要点如下，详细步骤见附录 D。
- 地址固定为 192.168.88.11 至 .99，网关与对时地址 192.168.88.1，一台一个地址。
- 预览账号单独创建，仅授予"远程预览"权限，口令全站统一并交给客户管理员。管理员口令不交给沅虹。
- 第三码流 H.264、1280×720、定码率 768 Kbps、8 帧、I 帧间隔 16、关闭 H.264+ 与 SVC。没有第三码流的型号改用子码流，主码流保持不变。
- 相机接入同一台相机交换机，不接在录像机的供电口上；使用录像机时，录像机同样接入该交换机。
接入盒的码流核对规则：ffprobe 抽取 4 秒，判定 H.264、是否含 B 帧（按帧类型判定，不依赖 has_b_frames 标志）、分辨率 640×360 至 1280×720、帧率 6 至 15。选流规则：有第三码流（通道 103）用第三码流，否则用子码流（通道 102），不自动选择主码流；NVR 通道默认取 x02。不合格的路不推送，原因上报并在接入页显示。
2.5 多盒现场
多盒现场指同一现场两台接入盒接入同一台相机交换机，分别使用两条宽带，电源为两个独立回路或配备 UPS。
- 相机登记在首选盒子，实际由哪台盒子推送由控制面决定。盒子失联达到在线判定时限后，其名下相机交给同现场中能够发现该相机（发现清单含该 IP）且已持有其口令密文的在线盒子，名下路数少的优先。首选盒子恢复并稳定 10 分钟后，相机交还首选盒子；现场可关闭自动回切。
- 两台盒子的黄口分别为 192.168.88.2 与 .3，仅 1 号盒子给相机分配地址；192.168.88.1 由 keepalived 在两台之间浮动，相机的网关与对时地址仍为 .1，相机侧无需改动。
- 管理员保存口令时，同一台相机的口令为现场内每台盒子各封一份密文。后加入的盒子需要再保存一次口令；控制面在盒子取得密文之前不会向其分配相机。
- 接入页提供"演练切换"：将一台盒子按离线对待 10 分钟，相机当场交给另一台，演练结束当场切回。验收时建议当着客户执行一次。
- 单台盒子承担全部相机时上行可能不足，节点侧的卸路逻辑会自动生效。双盒现场勘查时要求单条宽带至少能承载一半以上的路数。
切换时间指标：失联判定 90 秒加巡检周期 30 秒以内完成接管；接管后约 5 秒恢复推送；首选盒子恢复后 10 分钟稳定期结束回切；演练切换与结束均即时生效。
处理节点级互备（双处理节点，租户在两个节点各开实例）属后续阶段，前提是处理中心的电源与出网独立。