:loudspeaker: 由于 github 访问不稳定, 自 2021-03-04 起, 该仓库迁移至 https://gitee.com/livegbs/GB28181-Server

#  下载地址
[**https://www.liveqing.com/docs/download/LiveGBS.html**](https://www.liveqing.com/docs/download/LiveGBS.html)

# LiveGBS GB28181 国标方案安装使用说明

## 服务资源

  [试用安装包下载](https://www.liveqing.com/docs/download/LiveGBS.html) | [在线演示](http://gbs.liveqing.com) | [在线API](http://gbs.liveqing.com/apidoc) | QQ交流群：[605916552](https://jq.qq.com/?_wv=1027&k=cEUIvaNw)

## 服务说明

### 安装包
- Windows平台使用的安装包：

        LiveCMS-windows-***.zip
        LiveSMS-windows-***.zip

- Linux平台使用的安装包：

        LiveCMS-linux-***.tar.gz
        LiveSMS-linux-***.tar.gz

### 信令服务

- LiveCMS

    SIP 中心信令服务, 单节点, 自带一个 Redis Server, 随 LiveCMS 自启动, 不需要手动运行

- LiveCMS端口使用

	TCP 端口 : 15060(SIP), 10000(HTTP), 26379(Redis)

	UDP 端口 : 15060(SIP), 10000(HTTP)

### 流媒体服务

- LiveSMS

 	SIP 流媒体服务, 根据需要可部署多套

- LiveSMS端口使用

	TCP 端口 : 15070(SIP), 10001(HTTP), 11935(RTMP Live), 30000-30500(RTP over TCP)

	UDP 端口 : 15070(SIP), 10001(HTTP), 30000-30500(RTP/RTCP over UDP)


	*端口区间说明*
   - 如果不走TCP 传输, TCP区间端口可以不开放
   - 如果不走UDP 传输, UDP区间端口可以不开放
   - TCP 区间大小 = 最大并发数(包括直播和回放) ，可以手动修改端口区间
   - UDP 区间大小 = 最大并发数(包括直播和回放)*2 ，可以手动修改端口区间


### 配置信令服务(LiveCMS)

  	服务名称：LiveCMS

  	配置文件：livecms.ini

  	所在位置：LiveCMS-windows-***.zip, LiveCMS-linux-***.tar.gz

- [sip] -> host

    SIP 中心信令服务器 IP

- [sip] -> serial

    SIP 中心信令服务器 ID

- [sip] -> realm

    SIP 中心信令服务器 Realm

- [sip] -> device_password

    设备接入统一密码


### 配置流媒体服务(LiveSMS)

 	 服务名称：LiveSMS

 	 配置文件：livesms.ini

 	 所在位置：LiveSMS-windows-***.zip, LiveSMS-linux-***.tar.gz

- [sip] -> host

    SIP 流媒体服务器 IP

- [sip] -> serial

    SIP 流媒体服务器 ID

- [sip] -> realm

    SIP 流媒体服务器 Realm

- [sip] -> wan_ip (可选配置)

    SIP 流媒体服务器公网 IP

- [sip] -> use_wan_ip_recv_stream (可选配置)

    可选配置0/1, 指示流媒体服务器使用公网 IP 接收国标下级流数据

- [rtp] -> udp_port_range

    RTP over UDP 端口

- [rtp] -> tcp_port_range

    RTP over TCP 端口

## 服务运行


### Warning 注意

> 安装包所在路径不要包含 **中文**, 先运行 LiveCMS, 再运行 LiveSMS


### Windows

直接运行

信令服务（LiveCMS）

- 启动: 解压目录中，直接双击 LiveCMS.exe

- 停止：以 `Ctrl + C` 停止服务, 不可以直接叉控制台窗口, 否则服务停不干净

流媒体服务（LiveSMS）

- 启动: 解压目录中，直接双击 LiveSMS.exe

- 停止：以 `Ctrl + C` 停止服务, 不可以直接叉控制台窗口, 否则服务停不干净

以服务启动

信令服务（LiveCMS）

- 安装: 解压目录中，直接双击 ServiceInstall-LiveCMS.exe

- 卸载: 以 ServiceUninstall-LiveCMS.exe 卸载 CMS 服务

流媒体服务（LiveSMS）

- 安装: 解压目录中，直接双击 ServiceInstall-LiveSMS.exe

- 卸载: 以 ServiceUninstall-LiveSMS.exe 卸载 SMS 服务

### Linux

直接运行

信令服务（LiveCMS）

```
cd LiveCMS
# 启动：./livecms
# 停止： Ctrl + C
```

流媒体服务（LiveSMS）

```
cd LiveSMS
# 启动：./livesms
# 停止：Ctrl + C
```

以服务启动

信令服务（LiveCMS）

```
cd LiveCMS
# 启动：./start.sh
# 停止：./stop.sh
```

流媒体服务（LiveSMS）

```
cd LiveSMS
# 启动：./start.sh
# 停止：./stop.sh
```


## 配置设备接入

https://www.liveqing.com/docs/manuals/LiveGBS.html#配置设备接入

## 平台使用

### 管理平台

http://localhost:10000

初始登录 admin admin

### 接口文档
http://localhost:10000/apidoc

### 使用分享页

为方便客户在网页中集成播放功能, 我们单独提供了可供 HTML iframe 集成的分享页, 形如:

`http://ip:10000/play.html?serial=34020000001110000001&code=34020000001320000001`

其中 URL 参数:

- serial 设备国标编号

- code 通道国标编号

- share 是否显示分享, 可选, yes/no, 默认值为 yes

- ptz 是否显示云台控制, 可选, yes/no, 默认值为 yes

- iframe 是否仅显示视频播放区域, 可选, yes/no, 默认值为 no

- aspect 视频播放区域的宽高比, 可选, wxh, 默认为 640x360, 即16:9, 当 aspect=fullscreen 时整页显示播放器

- fluent 是否以流畅模式播放, 可选, yes/no, 默认值为 yes

- autoplay 是否自动播放, 可选, yes/no, 默认值为 yes

- stretch 是否拉伸显示, 可选, yes/no, 默认值为 no

- protocol 播放流格式, 可选, rtmp/hls/flv, 默认 auto check

### 网页播放器

除了 iframe 方式集成播放器, 也可以使用 LivePlayer 网页播放器来二次开发

LivePlayer 网页播放器下载和使用文档, 参阅链接:

https://www.npmjs.com/package/@liveqing/liveplayer


## 常见问题

https://www.liveqing.com/docs/faq/LiveGBS.html


## 获取更多信息

安防流媒体互联直播-QQ交流群：[592704822](https://jq.qq.com/?_wv=1027&k=MXQXPpWG)

LiveGBS-QQ交流群：[605916552](https://jq.qq.com/?_wv=1027&k=cEUIvaNw)

联系方式：151-5689-6292（同微信）

WEB：[www.liveqing.com](http://www.liveqing.com/)

Copyright © LiveQing.com 2016-2019