保姆级教程：用SRS 5.0搭建WebRTC直播，避开UDP端口和域名解析这些坑
从零构建WebRTC直播系统：SRS 5.0实战避坑指南
当视频直播成为企业通讯、在线教育的标配时，WebRTC以其低延迟、点对点传输的特性成为技术首选。而SRS作为轻量级流媒体服务器，在WebRTC场景中展现出惊人的适配能力。本文将带您从零开始，用SRS 5.0搭建稳定的WebRTC直播系统，并预先规避那些让开发者彻夜难眠的典型陷阱。
1. 环境准备与基础配置
在开始前，确保您的服务器满足以下条件：
- Ubuntu 20.04 LTS或CentOS 8+
- 4核CPU及8GB内存（1080p推流最低配置）
- 开放UDP端口8000-10000范围
- 公网IP或正确配置的NAT穿透
安装依赖项：
# Ubuntu/Debian sudo apt install -y git gcc g++ make automake libtool pkg-config # CentOS/RHEL sudo yum install -y git gcc gcc-c++ make automake libtool pkgconfig编译安装SRS 5.0最新版：
git clone -b 5.0release https://gitee.com/ossrs/srs.git cd srs/trunk ./configure --with-ffmpeg --with-ssl --with-hls --with-http-api --with-http-server make -j$(nproc)提示：
--with-ffmpeg选项允许RTMP转码功能，这对混合使用传统RTMP推流的场景至关重要。
2. 关键配置解析
创建/usr/local/srs/conf/webrtc.conf配置文件，核心参数如下：
listen 1935; max_connections 1000; daemon on; pid ./objs/srs.pid; http_api { enabled on; listen 1985; } rtc_server { enabled on; listen 8000; candidate $CANDIDATE; } vhost __defaultVhost__ { rtc { enabled on; rtmp_to_rtc on; rtc_to_rtmp off; } }参数详解表：
| 参数 | 推荐值 | 作用说明 |
|---|---|---|
| candidate | $CANDIDATE | 自动获取服务器公网/内网IP |
| rtmp_to_rtc | on | 允许RTMP流转WebRTC |
| http_api.listen | 1985 | 管理接口端口 |
| rtc_server.listen | 8000 | WebRTC信令端口 |
3. 五大必知避坑点
3.1 UDP端口黑洞问题
WebRTC依赖UDP协议传输媒体数据，但云服务器默认安全组往往阻止UDP流量。执行以下检测：
# 检查本地UDP端口监听 netstat -anu | grep 8000 # 外部测试（需另开终端） nc -vzu 你的服务器IP 8000若发现不通，需在云控制台和安全防火墙中放行UDP 8000-10000端口范围。
3.2 域名推流陷阱
推流URL中使用域名会导致拉流时URL匹配失败，这是最隐蔽的黑屏原因之一：
错误示范：
rtmp://example.com/live/stream正确做法：
rtmp://服务器IP/live/stream
日志中正确的流标识应显示为：
source url=/live/stream, source_id=423.3 Candidate IP配置
candidate参数决定客户端能连接的IP地址，错误配置会导致NAT穿透失败：
危险配置：
candidate 192.168.1.100; # 仅内网可用推荐方案：
candidate $CANDIDATE; # 自动识别所有可用IP
启动后检查日志确认IP列表：
RTC: Use candidates 10.0.0.2, 203.0.113.453.4 浏览器适配性问题
不同浏览器对WebRTC的支持存在差异，建议在页面中加入特性检测：
const supportsWebRTC = () => { return !!( navigator.mediaDevices && window.RTCPeerConnection && window.RTCSessionDescription ); }; if (!supportsWebRTC()) { alert('请使用Chrome 60+或Firefox 55+浏览器'); }3.5 日志诊断技巧
遇到黑屏时，按优先级检查以下日志关键词：
DTLS handshake done- 加密握手成功RTC bridge from RTMP- 流转换正常source_id=/- 流标识异常ICE failed- 网络连接问题
使用grep快速定位问题：
tail -f objs/srs.log | grep -E 'DTLS|RTC bridge|source_id'4. 全链路测试方案
4.1 推流测试
ffmpeg -re -i test.mp4 -c copy -f flv rtmp://服务器IP/live/stream4.2 拉流验证
通过H5页面加载WebRTC流，关键JavaScript代码：
const pc = new RTCPeerConnection({ iceServers: [{ urls: 'stun:服务器IP:8000' }] }); pc.ontrack = (e) => { videoElement.srcObject = e.streams[0]; }; const offer = await pc.createOffer(); await pc.setLocalDescription(offer); // 通过HTTP API交换SDP const response = await fetch(`http://服务器IP:1985/rtc/v1/play`, { method: 'POST', body: JSON.stringify({ api: 'http://服务器IP:1985', streamurl: 'webrtc://服务器IP/live/stream', sdp: offer.sdp }) });4.3 监控指标
通过http://服务器IP:1985/api/v1/versions获取实时状态，重点关注：
{ "rtmp_connections": 1, "rtc_connections": 1, "rtc_sessions": 1 }5. 高级调优策略
5.1 抗丢包配置
在rtc_server段增加QoS参数：
rtc_server { ... # 抗30%丢包 pli_for_rtx on; nack on; twcc on; }5.2 多worker部署
对于高并发场景，启动多个进程：
./objs/srs -c conf/webrtc.conf -w 45.3 自定义转码
在RTMP推流时实时转码为适合WebRTC的格式：
ffmpeg -i input.mp4 -c:v libx264 -profile:v baseline -preset ultrafast \ -tune zerolatency -c:a aac -f flv rtmp://服务器IP/live/stream参数说明：
baselineprofile确保最大设备兼容性zerolatency减少编码延迟ultrafast降低CPU消耗