GBHub 国标视频平台 · 功能

一站式国标视频接入、转发、录像、对讲与多端监控平台
支持 GB/T 28181、GB 35114（A 级原生，B/C 级规划）、ONVIF、RTSP/RTMP/HLS 多协议
管理端 + 移动端 + 电视墙全终端覆盖，国密安全合规持续演进

一、平台简介

GBHub 是一款面向安防监控、智慧城市、交通、园区等场景的国标视频综合管理平台。
平台以 GB/T 28181 为核心，原生支持 GB 35114 A 级安全能力，B 级和 C 级为未来扩展方向，同时兼容 ONVIF、RTSP、RTMP、HLS 等主流协议，提供设备接入、实时预览、录像回放、云台控制、语音对讲、流媒体代理、级联推送、多用户权限、定时任务等完整能力。

一套平台，覆盖 Web 管理端、手机移动端、PC 多路电视墙，满足从单路查看 to 大规模集中监控的全部需求，并满足公安、政务、能源等场景的强制安全合规要求。

二、核心优势

三、功能全景

1. 设备接入与国标级联

• GB/T 28181 设备接入：SIP 注册、心跳保活、目录订阅、设备状态管理
• 设备预录入：支持手动添加设备，上线后自动填充 IP/端口
• 设备状态历史：记录在线/离线变化，支持分页查询
• 通道管理：设备通道分页、通道搜索、通道自定义名称
• 级联上级平台：支持 UDP/TCP、2016/2022 版本，可添加多个上级
• 目录推送：扁平列表、行政目录、业务目录三种推送方式
• 行政区域 / 业务分组：自定义区划名称、215/216 虚拟组织，构建清晰目录树

2. 实时视频与多路播放

• 实时直播：start-live / stop-live，支持国标设备与代理流
• 多协议播放：
  • WebRTC（超低延迟）
  • WS-TS（兼容性好）
  • WS-FLV（Jessibuca 软解，支持 H.265）
  • HTTP-FLV、HLS、RTMP、RTSP、fMP4
• PC 多路电视墙：
  • 1/4/9/16/25 分屏自由切换
  • 侧边栏流列表筛选、分页、占用标记
  • 单击/双击分配通道，一键关闭单路
  • WS-TS / WebRTC 协议切换
  • 断线自动重连（WS-TS 最多 5 次，WebRTC 3 秒重建）
  • 快捷键：F 全屏、H 侧边栏、T 协议、1~9 选中
  • 配置自动保存到本地，刷新不丢失
• 移动端单通道播放：
  • 通道卡片列表、搜索、分页
  • 缩略图实时刷新
  • 上/下一个通道快速切换
  • 三协议一键切换
  • Jessibuca 自定义控制条（播放/暂停、静音、音量）

3. 录像与回放

• 设备录像查询：按时间范围检索设备本地录像
• 录像回放：start-playback，支持 WS-TS / WebRTC / MP4 播放
• 云端录像管理：
  • 按通道、App、时间范围查询
  • 分页展示、播放、下载
  • 批量删除（建议使用定时清理任务）
• 录像转录：将历史录像片段异步转录为 MP4，支持启动、停止、查询
• 录制控制：手动开始/停止录制，查询录制状态
• 主动录像任务：start-record-task，支持前后缓冲与事件回调

4. 截图与云台控制

• 截图方式：
  • 国标抓拍：SIP 命令设备抓拍
  • ZLM 截图：支持国标 + 代理，流不在线自动拉流
  • 批量截图：遍历所有在线设备通道
  • 移动端截图：播放时后台自动截图
• 截图缓存查询：按设备查询最新截图
• 云台控制：方向、变焦、停止，支持长按连续移动
• 预置位管理：查询、调用预置位

5. 语音对讲与广播

• 单向语音广播：向指定设备通道喊话
• 双向语音对讲：与设备端实时对讲
• 停止接口：随时结束广播/对讲

6. 流媒体代理与分发

• 拉流代理：
  • 支持 RTSP、RTMP、HLS、HTTP 等源
  • 常驻 / 按需模式
  • RTP 类型（TCP/UDP/组播）
  • 超时设置、MP4 录制、指定节点
• FFmpeg 代理：
  • 任意协议拉流
  • 自定义目标地址
  • HLS/MP4 录制
  • 命令模板 key 自定义
• 推流代理：
  • 将平台流推送到外部 RTMP/RTSP 服务器
  • 支持多节点、RTP 类型、超时
• 流管理：
  • 查看节点实时流
  • 获取所有协议播放地址（一键复制）
• 多 ZLM 节点管理：
  • 节点列表、详情、更新、删除
  • 轮询在线节点，自动负载均衡

7. ONVIF 与第三方设备

• ONVIF 设备发现：扫描局域网内 ONVIF 摄像头
• 获取 RTSP 地址：自动解析带认证的 RTSP 流地址
• 一键添加代理：自动创建拉流代理，快速接入非国标设备
• 指定节点：必须显式指定 ZLM 节点，确保同网段发现

8. 用户权限与移动端

• 多用户管理：创建、删除、重置密码
• 精细化权限：
  • 设备、录像、告警、代理、ZLM、系统、用户
  • 截图、录制、PTZ、音频
• 通道级授权：
  • 国标通道：{device_id}:{channel_id}
  • 代理通道：proxy:{app}:{stream}
  • 支持批量 add / remove / replace
  • 支持清理失效权限
• 移动端接口：
  • 登录、通道列表、播放、截图、修改密码
• 代理通道 ID 列表：方便批量分配选择

9. 定时任务与自动化

• 任务类型：
  • snapshot：定时截图
  • record：定时录制
  • cleanup_sessions：清理残留会话
  • sync_device_status：同步设备在线状态
  • cleanup_media：清理过期录像
  • cleanup_snapshot：清理过期截图
• Cron 表达式：UTC 时间，支持通配符 "*"
• 内部执行接口：X-Internal-Token 鉴权，支持通配展开设备
• 任务管理：创建、查询、更新、删除、启用/禁用、分页

10. 系统管理与运维

• 系统备份与恢复：一键导出/导入全部配置（代理、目录、通道绑定等）
• 平台信息：查看 SIP 服务器配置，方便设备注册
• 设备与通道统计：设备总数、通道总数
• 通用错误码：401、403、422、500、业务码 -1/0
• ZLM Webhook 回调：
  • 录像完成、流变化、播放/推流鉴权
  • 无人观看自动关闭、自动拉流
  • RTP 超时清理、服务启动恢复

11. GB 35114 信息安全合规支持

GB 35114-2017《公共安全视频监控联网信息安全技术要求》是我国视频监控领域首个强制性国家标准，2018 年 11 月 1 日正式实施。GBHub 原生支持 GB 35114 A 级安全能力，B 级和 C 级为未来扩展方向，从设备接入、信令交互到视频传输逐步实现全链路安全防护。

与 GB/T 28181 的关系

两者是配套关系：

GB 35114 在级联、互联方式上仍然沿用 GB/T 28181，只是在组网过程中叠加了国密安全机制。

三级安全防护体系

当前平台原生支持 A 级，B 级和 C 级为未来扩展方向。

GBHub 的 GB 35114 支持能力

已支持（A 级）

• 基于 SM2 数字证书的设备身份认证，只有通过合法认证的设备才能接入平台
• 彻底杜绝仿冒设备、非法摄像头接入，从源头防范入侵风险
• 兼容原有 GB/T 28181 设备，新旧系统平滑过渡，无需改造前端设备即可完成 A 级合规升级
• 控制信令采用基于数字摘要的认证机制，防止摄像头被非法控制
• 设备与平台之间的注册、心跳、目录、云台控制等信令全部走国密认证流程
• 操作留痕、行为审计，防止合法用户对视频资源的非法使用

规划中（B 级 / C 级）

• B 级：视频数据数字签名与验签，确保视频来源真实、内容未被篡改
• C 级：视频流国密加密传输，满足涉密与合规要求；录像文件加密存储与防篡改验证
• 集成证书管理、密钥管理、设备管理三大基础安全服务，支持 A/B/C 三级安全能力统一配置

典型适用场景

合规价值

在 GB 35114 全面强制实施的背景下，平台是否支持国密协议已成为安防项目招投标、验收、合规运营的硬性门槛。GBHub 原生嵌入 GB 35114 A 级协议，无需改造前端监控设备、无需重构现有系统，即可实现低成本合规、快速达标，同时兼容原有 GB/T 28181 体系，并持续向 B 级、C 级演进，让视频监控从“联网可用”升级为“安全可信”。

四、技术架构亮点

• 后端：统一端口 3002，JWT Bearer 认证，REST API + Webhook
• 信令：SIP 服务器处理 GB/T 28181 注册、心跳、目录、级联
• 安全：集成 GB 35114 A 级国密协议，支持 SM2/SM3/SM4 算法；B/C 级规划中
• 流媒体：ZLM 节点集群，支持多节点轮询与手动指定
• 存储：
  • Redis：通道绑定、Token、全局索引
  • GreptimeDB：设备状态历史、录像元数据
• 前端：
  • PC 管理端：原生 HTML/CSS/JS，13 个功能 Tab
  • 移动端：响应式设计，支持自动登录
  • 多路播放器：mpegts.js + ZLMRTCClient，支持自动重连
• 扩展性：全功能 API 开放，方便对接第三方平台或开发定制界面

五、典型应用场景

六、快速开始

1. 部署后端：启动服务，默认端口 3002
2. 登录管理端：浏览器访问 http://<服务器IP>:3002
   • 默认账号：root / admin123（请及时修改）
3. 添加设备：
   • 国标设备：在摄像头端配置 SIP 参数，自动注册
   • ONVIF 设备：使用 ONVIF 发现功能，一键添加代理
   • GB 35114 设备：加载国密证书，平台自动完成 A 级安全认证（B/C 级后续版本支持）
4. 分配权限：
   • 在“用户管理”中创建用户，分配通道
5. 开始监控：
   • PC 管理端：设备 → 通道 → 播放
   • 移动端：访问 /mobile.html，登录查看授权通道
   • 多路电视墙：访问 /mosaic.html，自由分屏

七、总结

GBHub 国标视频平台以 国标接入为核心，多协议兼容为特色，多端覆盖为优势，国密安全为保障（A 级原生支持，B/C 级持续演进），提供从设备接入、实时预览、录像回放、云台对讲、流媒体代理、级联推送到用户权限、定时任务、系统运维的一站式解决方案。

无论是小型园区还是大型平安城市项目，GBHub 都能以灵活的架构、丰富的功能、开放的 API、强制的合规能力满足您的视频监控需求。

GBHub · 让国标视频管理更简单、更高效、更安全、更智能。