# RelayLive

**Repository Path**: ztwlla/RelayLive

## Basic Information

- **Project Name**: RelayLive
- **Description**: 视频服务中继，转换传输协议。将rtsp、gb28181转为html5可以直接播放的协议。
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 37
- **Forks**: 29
- **Created**: 2018-07-24
- **Last Updated**: 2026-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RelayLive — GB28181 视频汇聚平台

面向用户的 GB28181 视频汇聚与管理平台：**全部参数由 Web 管理台自定义**，lua 业务脚本在线管理，多数据库（sqlite/MySQL，经 ludb）支持。

## 架构

```
单进程 relaylive（uvnetplus 事件驱动：SIP + HTTP/WS + RTP 收流）
  └── avpipe_worker 子进程（ffmpeg：转封装/转码/截图/录像，崩溃隔离）
```

## 构建

```bash
# 依赖统一安装到 $HOME/install（见 doc/ops.md）
cmake -S . -B ../build/RelayLive -DCMAKE_INSTALL_PREFIX=$HOME/install \
      -DCMAKE_BUILD_TYPE=Release -DUSE_FFMPEG=ON -DDB_MYSQL=ON
cmake --build ../build/RelayLive 
```

## 运行

```bash
cd ../build/RelayLive/bin && ./relaylive
# 管理台： http://<host>:18000/     默认账号 admin / admin
```

## 目录

| 目录 | 内容 |
|---|---|
| `src/` | 主进程：SIP 信令 / 媒体会话 / RESTful API / 管理台前端 / 存储抽象 / 配置 |
| `include/` | 对外头（avpipe 媒体管线 API） |
| `conf/` | 运行时配置（config.json）、lua 脚本目录（scripts/）、systemd 单元 |
| `tests/` | 测试素材（PS 生成器 / RTP 模拟设备 / SIP 对打 / 压测） |
| `doc/` | 平台设计、运维部署、功能对照、release_v1 分析 |

## 能力

- **信令**：REGISTER(含 Digest 鉴权) / 保活 / 目录 / 状态 / 位置 / PTZ(8向+变焦组合) / 实时点播 / 历史回放 / BYE / 订阅 NOTIFY 推送 / 整机注册到上级
- **媒体**：RTP 收流 + PS 组帧 · 转封装 FLV/fMP4/HLS · 转码(x264) · 截图 / 录像 · 多客户端共享
- **播放方式**：HTTP-FLV / WS-FLV / WS-FLV 软解(NodePlayer) / fMP4 / HLS（详见 doc/ops.md §6）
- **地址转播**：任意流地址（rtsp/http/rtmp/文件）→ web 播放
- **管理台**：登录(多用户/角色) · 仪表盘 · 设备管理 · 播放器(协议切换/云台/回放/截图) · 平台配置(多下级平台) · 脚本管理(在线编辑/校验/热重载) · 会话监控 · 日志

## 文档

- 平台设计：`doc/platform_design.md`
- 部署运维：`doc/ops.md`
- 功能对照：`doc/feature_mapping.md`