开发者

依赖:

• cargo
• nodejs
• pnpm

可选依赖:

• ffmpeg
• just
• cross-rs
  • docker / containerd / podman
• nfpm

二进制包和源码对应关系

Binary	Package	Comment
live777	liveion	核心服务 SFU Server
liveman	liveman	Live777 集群控制器
whipinto	livetwo	rtp, rtsp to whip
whepfrom	livetwo	whep ro rtp, rtsp
livenil	livenil	集群启动器，主要用在开发和测试环境

Release build

# Build Web UI
pnpm install
pnpm -r build

# Live777 Core (SFU Server)
cargo build --release

# Live777 Manager
cargo build --release --bin=liveman

# whipinto / whepfrom
cargo build --release --bin=whipinto
cargo build --release --bin=whepfrom

特性标记

Live777 支持以下 Cargo feature 来定制构建：

特性	所属包	说明
webui	liveion	启用 Web UI（嵌入前端资源）
cascade	liveion	启用服务间级联推拉流
recorder	liveion	启用录制功能（H264/H265）
source	liveion	启用源拉取（RTSP, WHEP, SDP）
source-sdp	liveion	通过 SDP 拉取源
source-rtsp	liveion	通过 RTSP 拉取源
source-whep	liveion	通过 WHEP 拉取源（静态 cascade-pull）
target-whip	liveion	通过 WHIP 推送目标（静态 cascade-push）
target-rtp	liveion	以纯 RTP/UDP 发送目标（组播发送端）
target-rtsp	liveion	通过 RTSP 推送目标（ANNOUNCE/RECORD 客户端）
net4mqtt	liveion	启用 MQTT 隧道代理

构建时启用特性：

cargo build --release --features "cascade,recorder"

默认构建不包含任何可选特性。使用 --all-features 启用全部：

cargo build --release --all-features

如果你需要配置，使用配置文件

cp conf/live777.toml live777.toml
cp conf/liveman.toml liveman.toml

自定义日志

可以使用 RUST_LOG 环境变量来设置日志分模块输出

比如 live777, 目前模块日志输出为：

RUST_LOG=live777=<cfg.log.level>,net4mqtt=<cfg.log.level>,http_log=<cfg.log.level>,webrtc=error",

我们可以用这个变量覆盖默认的日志输出方案

RUST_LOG=live777=error,net4mqtt=debug,webrtc=error",

以开发模式运行

WebUI

pnpm install

# live777 debugger
pnpm --filter debugger dev

# live777 webui
pnpm --filter liveion dev

# liveman webui
pnpm --filter liveman dev

Live777

cargo run -- -c conf/live777.toml

LiveMan

cargo run --bin=liveman -- -c conf/liveman.toml

LiveNil

如果你想开发或测试集群的一些功能，很明显手动依次启动不是一个明智的选择

可以使用这个工具批量启动一个 liveman 和 N 个 live777 实例

cargo run --bin=livenil -- -c conf/livenil

边缘-云端级联演示

conf/livenil/edge-cloud/ 是一个预制拓扑：两个边缘节点模拟摄像头 （各预置一路流，通过 liveman 的 [[node_rules]] glob 规则—— pattern = "edge*"、sub_max = 1——限制只允许一个直连观众）， 一个云端节点作为中心 SFU，全部由一个 liveman 管理：

just run-edge-cloud

摄像头推流时钉到各自的边缘节点，观众都连接 liveman （http://127.0.0.1:8890/whep/cam0）。每路流的第一个观众会被直接代理到 边缘节点；第二个观众到来时边缘已满，liveman 会把流级联到云端节点 （pull 模式：云端主动向边缘 WHEP 拉流），并踢掉边缘上的直连观众 （close_other_sub = true），其播放器重连后落到云端。边缘始终只向外 发送一路流，节省边缘上行带宽。完整流程见 conf/livenil/edge-cloud/ 里的注释。

whipinto && whepfrom

cargo run --bin=whipinto
cargo run --bin=whepfrom

因此，我们支持参数 command, 你可以这样使用：

cargo run --bin=whipinto -- -i input.sdp -w http://localhost:7777/whip/777 --command \
"ffmpeg -re -f lavfi -i testsrc=size=640x480:rate=30 -vcodec libvpx -f rtp 'rtp://127.0.0.1:5002' -sdp_file input.sdp"

cargo run --bin=whepfrom -- -o output.sdp -w http://localhost:7777/whep/777 --command \
'ffplay -protocol_whitelist rtp,file,udp -i output.sdp'

浏览器 WebRTC 调试工具

大部份浏览器内置了 WebRTC 调试工具

Firefox	Chrome	Edge
about:webrtc	chrome://webrtc-internals/	edge://webrtc-internals/
	chrome://webrtc-logs/	edge://webrtc-logs/