77 lines
2.8 KiB
Markdown
77 lines
2.8 KiB
Markdown
# 直播 SFU 分流 Demo（Cloudflare Realtime · SRS）
|
||
|
||
参考 GOSpeak 技术栈的直播 SFU 分流演示。控制面用 **protobuf / gRPC** 定义，媒体面走
|
||
**Cloudflare Realtime**（主 SFU）与 **SRS**（本地对照）的 WebRTC 扇出。
|
||
|
||
- 一路推流 → SFU 扇出 → 多路拉流。
|
||
- 同一路发布可同时落到 **Cloudflare Realtime** 与 **SRS** 两条分发链路（分流）。
|
||
- 浏览器经服务端反向代理直连 SFU，凭证不出服务端。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
app/live-sfu-demo/
|
||
api/live_sfu.proto # protobuf 控制面契约
|
||
gen/ # buf generate 产出（Go）
|
||
internal/
|
||
config/ # 运行参数（对齐 GOSpeak 的 env 布局）
|
||
sfu/cloudflare/ # Cloudflare Realtime REST 客户端 + Provider
|
||
sfu/srs/ # SRS Provider
|
||
server/ # gRPC 服务 + JSON 网关 + SRS/CF 媒体反代 + 房间扇出状态
|
||
static/ # 浏览器 UI（发布 / 观看 / 分发面板）
|
||
cmd/server/main.go
|
||
deploy/ # docker-compose.yml + srs.conf
|
||
```
|
||
|
||
## 运行（SRS 链路，开箱即跑）
|
||
|
||
```bash
|
||
# 1) 起本地 SRS（WHIP/WHEP 后端）
|
||
cd app/live-sfu-demo/deploy && SRS_CANDIDATE=127.0.0.1 docker compose up -d srs
|
||
|
||
# 2) 起 Demo 控制面
|
||
cd app/live-sfu-demo
|
||
cp .env.example .env # 可选；SRS 链路无需任何凭证
|
||
go run ./cmd/server
|
||
|
||
# 3) 打开浏览器
|
||
# 发布： http://localhost:8088/publish?room=demo
|
||
# 观看： http://localhost:8088/watch?room=demo
|
||
```
|
||
|
||
两个标签页用同一房间名即可配对。发布页勾选的分发后端会在「分发状态」中实时显示。
|
||
|
||
## 运行（Cloudflare Realtime 链路，主 SFU）
|
||
|
||
在 `.env` 填入 Cloudflare Realtime 凭证后，`go run ./cmd/server` 即启用主 SFU：
|
||
|
||
```
|
||
CF_APP_ID=xxxxxxxxxxxx
|
||
CF_APP_SECRET=xxxxxxxxxxxx
|
||
```
|
||
|
||
- 发布：服务端用 `CF_APP_SECRET` 创建 Cloudflare session，浏览器只交换 SDP（`/api/cf/...` 反代注入 Bearer）。
|
||
- 观看：服务端为观众创建 viewer session，并订阅发布者 session 的轨道（`location=remote`）。
|
||
|
||
Cloudflare 未配置时，UI 会标注「未配置」，SRS 链路不受影响。
|
||
|
||
## protobuf / gRPC
|
||
|
||
```bash
|
||
# 修改 api/live_sfu.proto 后重新生成
|
||
export PATH="$HOME/go/bin:$PATH"
|
||
buf generate api
|
||
```
|
||
|
||
契约（`LiveSFU` 服务）：`GetConfig` / `ListRooms` / `Publish` / `Subscribe` / `StopStream` /
|
||
`WatchRoom`（服务端流式推送房间分发拓扑）。gRPC 监听 `GRPC_PORT`（默认 9090），浏览器走同端口
|
||
的 JSON 网关（`protojson`）。
|
||
|
||
## 分流拓扑
|
||
|
||
```
|
||
publisher ──WHIP/tracks.new──▶ Cloudflare Realtime SFU ──▶ viewer(s)
|
||
└────WHIP────────────▶ SRS SFU (WHEP) ──▶ viewer(s)
|
||
房间分发目标由 WatchRoom 实时广播，观众任选后端拉流
|
||
```
|