直播 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 链路，开箱即跑）

# 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

# 修改 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 实时广播，观众任选后端拉流