跳到主要内容

使用手册

软件介绍​

EasyGBS 包含 GB28181 信令服务，ONVIF 客户端，RTMP 推流，RTSP/RTMP 拉流协议等等，内嵌流媒体服务，同时也支持多个流媒体独立部署负载均衡。支持分发 FLV/HLS/WebRTC/RTMP/RTSP 等协议播放。

功能特性​

  • 兼容性良好
  • 接入设备
    • 支持不鉴权注册/平台统一密码注册/设备唯一密码注册
    • 支持设备状态诊断
    • 支持 UDP/TCP 两种国标信令接入平台
    • 设备信息同步
    • 直播预览
    • 支持 UDP/TCP/TCP Active 三种国标流传输模式
    • 支持直播诊断
    • 云台控制
    • 预置位查询/跳转/设置
    • 查询 NVR/IPC 上的录像与播放，支持自定义时间播放与下载
    • 无人观看自动断流节省流量，支持自定义超时时间
    • 支持输出 RTSP/RTMP/WebRTC/HTTP-FLV/WebSocket-FLV/HLS 多种协议流地址
    • 支持 GB28181-2011/2016/2022 三种版本
    • 支持检索，通道筛选
    • 支持播放 H264/H265
    • 支持 AAC/G711A/G711U
    • 支持报警接收
    • 支持 UDP/TCP/TCP Active 三种模式语音对讲
    • 支持移动位置/报警事件/设备目录三种订阅
    • 支持国标级联
      • 注册
      • 心跳
      • 自定义共享通道，自定义通道 ID
      • 直播 (UDP/TCP/TCP Active)
      • 录像 (UDP/TCP/TCP Active)
      • 云台控制
      • 预置位
      • 目录订阅与通知
      • 录像查看与播放/倍速/下载
      • 语音对讲
      • 支持级联信息一键复制/一键粘贴，快速填入上级级联信息
    • 支持 SQLite/PostgreSQL 两种数据库
    • 支持拉流鉴权
    • 支持流播放日志
    • 支持 SIP 日志查看，检索，下载
    • 支持云端录像，支持预览和下载
    • 支持多流媒体负载均衡
    • 支持快照抓图
    • 支持设备智能分配网络类型，可内网/公网推流
    • 支持查看流信息
    • 支持查看订阅者列表
    • 支持接口日志
    • 支持开发者接入
    • 支持控制日志级别
    • 支持自定义网页名称/logo

使用准备​

端口信息​

30000-31000推流开放端口范围(tcp/udp)。
28086webrtc 拉流地址(tcp/udp)
10000后台管理页面 http 访问地址
28088后台管理页面 https 访问地址(tcp)
28080hls/flv http 拉流地址(tcp)
28081hls/flv https 拉流地址(tcp)
25544rtsp 拉流地址(tcp)
21935rtmp 拉流地址(tcp)
15060gb28181 sip 端口(tcp/udp)

安装指南​

下载安装包并解压到服务器，解压路径不要包含中文字符。

Linux 版本 (推荐)

linux_dir.png

Windows 版本

windows_dir.png

  • www 前端页面资源
  • configs 配置文件以及 https 证书等
  • start.sh/stop.sh linux 下以服务方式启动脚本
  • start.bat/stop.bat windows 下以服务方式启动脚本
  • easygbs 可执行程序

系统启动​

Linux

  • 安装: 以管理员权限执行 ./start.sh ，启动 easygbs 服务
  • **卸载:**以管理员权限执行 ./stop.sh，停止 easygbs 服务

Windows

  • 安装: 右键点击以管理员权限执行 start.bat，停止 easygbs 服务
  • 卸载: 右键点击以管理员权限执行 stop.bat ，停止 easygbs 服务

使用指南​

用户登录​

启动服务后，在浏览器中打开登录页面 http://127.0.0.1:10000，IP 和 Port 应该根据实际环境。

默认初始的账号和密码为 admin/admin，登录后会要求您修改账号和密码，以确保账号安全。

login.png

GB28181 设备接入​

1. 不鉴权接入​

根据配置文件 [sip] > password ，若是密码为空串，则所有设备不鉴权/不校验密码接入。

2. 平台密码接入​

根据配置文件 [sip] > password ，若是密码非空串，设备注册时填写正确密码，注册成功时，平台会自动入库。

3. 设备唯一密码接入​

根据配置文件 [sip] > password ，若是密码非空串，需要您先手动添加设备。

在 国标设备 > 添加 页面，填写正确的国标 ID 和 唯一密码，设备将可以通过唯一密码或平台密码注册到平台上。

device.png

GB28181 直播预览​

如果设备非您手动添加的方式注册，设备将会自动分配网络类型。

在设备编辑页面，您可以选择设备从公网推流或内网推流，如果设备和您部署的平台是同一个局域网，您应该选择局域网推流，会更节省流量。

没有公网地址，选择互联网推流，将导致视频无法播放

您可以使用三种方式取流，建议 TCP 被动最稳定，切换后下一次播放生效 (您可以主动停流再播放，来促使立即生效)

transport.png

点击 国标设备-查看通道-直播预览 进行播放，请跟下图流程走，您将看到设备推送过来的画面。

device_card.png

channel.png

player.png

您可以切换 WebRTC/HTTP_FLV/WS_FLV/HLS 四种协议，进行网页播放。其中的 RTMP/RTSP 要复制到播放器播放(例如 VLC)。

ONVIF 接入​

点击「设备列表」-「添加」-「ONVIF」 进行添加 ONVIF 设备，点击 IP 将会自动出现下拉框，显示发现的 IP，以及是否添加等信息。

如果您更换了网络 或 新的设备通电，可以点击 IP 右侧的刷新按钮，来发现最新的内容。

onvif

云台控制/预置位控制​

您可以在播放页面的右侧，进行云台控制。在播放页面的右下角切换预置位信息面板，进行跳转/设置/清除。

运营维护模块​

您在接入的过程中，可能会遇到奇奇怪怪的现场问题，我们提供以下工具协助您定位问题。

国标设备状态诊断​

如果国标设备未上线，上线异常，「设备诊断」将为您获取更多信息，协助您排除故障。

device_diagnosis.png

在诊断中可以获取最近的 心跳历史，注册历史，注册报文以及设备信息报文。

如果设备有异常情况，诊断内容中也会为您提供一些帮助信息，可以按照帮助信息进一步排查。

直播预览诊断​

查看丢包率，查看网络延迟，为什么播放黑屏? 等等问题，希望「视频诊断」能够让运维更轻松。

channel_diagnosis

explain.png

「视频诊断」第一步需要确定设备在线，包含了「设备诊断」一半内容。

第二步是检查协商的 SDP，在实际业务中应当重点关注推流地址。

第三步是诊断流信息，丢包率，收到流的时间，从设备到服务端的网络延迟，读取的字节数。

video_explain.png

video_explain2.png

SIP 日志​

在业务现场，国标通常会遇到很多奇怪的问题，通过 SIP 日志排查能够快速定位，使用 wireshark 抓包通常是最好的方案，服务端需要安装 tcpdump/wireshark。现在从网页就能查看过滤 SIP 日志，快进入 [系统设置]-[SIP日志] 体验。

sip.png

服务重启​

您可以在网页上重复服务，如果有需要。

system.png

服务升级​

您可以在网页上传升级包进行升级，在使用「服务升级」之前，请确保您的程序是以管理员权限运行，拥有可写可执行权限。

gbs 或 gbs.exe 为 linux/windows 升级包，您可以点击「服务升级」上传名为 gbs 的升级包，稍等 15 秒左右，将会提示您升级成功。

system2.png