1. WebRTC-streamer 是什么WebRTC-streamer 是一个开源工具专门用于将传统流媒体协议如 RTSP、RTMP转换为 WebRTC 流。它的核心功能是充当一个桥梁把摄像头、屏幕录制、本地文件等媒体源通过 WebRTC 技术实时传输到浏览器或其他客户端。你可以把它想象成一个“翻译官”把老式的监控摄像头语言RTSP翻译成现代浏览器能听懂的 WebRTC 语言。这个工具特别适合需要低延迟视频传输的场景比如监控系统、在线教育、视频会议等。实测下来从摄像头到浏览器显示的延迟可以控制在 500 毫秒以内比传统方案快很多。我去年在一个智能家居项目中使用它成功把门口摄像头的画面实时推送到业主手机延迟几乎感觉不到。2. 快速搭建环境2.1 Docker 部署推荐对于新手来说Docker 是最简单的部署方式。你只需要一条命令就能启动服务docker run -p 8000:8000 -it mpromonet/webrtc-streamer这条命令会做三件事从 Docker Hub 拉取最新镜像启动容器将容器的 8000 端口映射到主机如果你想接入本地的 USB 摄像头可以加上--device参数docker run --device/dev/video0 -p 8000:8000 -it mpromonet/webrtc-streamer我在树莓派上测试时发现某些型号的摄像头需要额外加载驱动。如果遇到问题可以尝试先安装v4l-utils工具包检查设备是否被正确识别。2.2 直接运行二进制文件如果你不想用 Docker也可以直接下载编译好的二进制文件。从 GitHub 的 Release 页面找到对应平台的版本解压后运行./webrtc-streamer -H 0.0.0.0:8000参数说明-H指定 HTTP 服务端口-v增加日志详细程度最多三个 v-V显示版本信息3. 配置 RTSP 源3.1 基本配置方法启动服务后你需要告诉它从哪里获取视频流。对于 RTSP 摄像头常用的命令格式是./webrtc-streamer -n mycam -u rtsp://admin:password192.168.1.100:554/stream这里有几个实用技巧使用-n给摄像头起个易记的名字如果摄像头需要认证直接在 URL 中包含用户名密码公共测试源可以用这个rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov我在配置海康威视摄像头时踩过一个坑部分型号需要添加?transportmodeunicast参数才能稳定连接。如果你的流经常中断可以试试这个方案。3.2 使用配置文件当有多个视频源时推荐使用 JSON 配置文件// config.json { urls: [ { name: living_room, url: rtsp://192.168.1.101:554/Streaming/Channels/101 }, { name: backyard, url: rtsp://192.168.1.102:554/Streaming/Channels/101 } ] }然后通过-C参数加载./webrtc-streamer -C config.json4. NAT 穿透配置4.1 STUN/TURN 服务器在公网环境下你需要配置 ICE 服务器来穿透 NAT。WebRTC-streamer 支持内置 STUN/TURN./webrtc-streamer -S0.0.0.0:3478 -s$(curl -s ifconfig.me):3478参数解释-S启动内置 STUN 服务-s设置公网 STUN 地址$(curl -s ifconfig.me)自动获取公网 IP对于更复杂的网络环境建议使用外部的 TURN 服务器。我曾经在一个企业项目中用 Coturn 搭建 TURN 服务配合以下参数效果很好./webrtc-streamer -s stun.l.google.com:19302 -t username:passwordyour.turn.server:34784.2 UPnP 自动端口映射如果路由器支持 UPnP可以用这个命令自动配置端口转发upnpc -r 8000 tcp 3478 tcp 3478 udp这会把三个关键端口映射出去8000HTTP 服务端口3478STUN/TURN 服务端口UDP 3478媒体传输端口5. 前端集成方案5.1 使用内置页面最简单的测试方法是直接访问服务自带的页面http://服务器IP:8000/webrtcstreamer.html?rtsp://你的视频流地址如果想同时查看多个摄像头可以加 layout 参数http://服务器IP:8000/?layout2x25.2 自定义 HTML 页面对于正式项目你可能需要定制页面。这里有个基础模板html head script srclibs/adapter.min.js/script script srcwebrtcstreamer.js/script script var webRtcServer null; window.onload function() { webRtcServer new WebRtcStreamer( video, http://location.hostname:8000 ); webRtcServer.connect(living_room); // 使用配置文件中的名称 } window.onbeforeunload function() { if(webRtcServer) webRtcServer.disconnect(); } /script /head body video idvideo autoplay muted controls/video /body /html5.3 Web Components 方案如果你用现代前端框架可以试试官方提供的 Web Componentscript typemodule srcwebrtc-streamer-element.js/script webrtc-streamer urlrtsp://你的视频流地址/webrtc-streamer这个组件支持以下属性url: 视频流地址autoplay: 是否自动播放muted: 是否静音controls: 是否显示控制条6. 性能优化技巧6.1 硬件加速对于树莓派等嵌入式设备建议启用硬件编码./webrtc-streamer -o -u v4l2:///dev/video0-o参数会保持原始 H.264 帧不重新编码CPU 占用能降低 60% 以上。我在 Raspberry Pi 4 上测试单个 1080p 流 CPU 占用从 90% 降到 30%。6.2 带宽控制如果网络条件不好可以限制最大码率./webrtc-streamer -W WebRTC-VideoRateControl/min_bitrate300,max_bitrate1000这个设置会把视频码率控制在 300-1000kbps 之间。实际项目中我通常先测试网络带宽然后设置 max_bitrate 为实测值的 80%。6.3 多线程优化对于多路视频的场景可以增加 HTTP 服务线程数./webrtc-streamer -N 4根据我的经验4 核 CPU 设置 4-6 个线程效果最佳。超过这个数反而会因为上下文切换导致性能下降。7. 常见问题排查7.1 连接失败如果视频无法加载按这个顺序检查先用 VLC 测试 RTSP 流是否正常检查防火墙是否放行了 8000 端口查看服务端日志加-vvv参数显示详细日志尝试更换 STUN 服务器7.2 高延迟遇到延迟超过 1 秒的情况确认是否启用了-o参数检查网络是否有丢包尝试降低分辨率在摄像头端配置使用 TCP 传输添加?tcp参数7.3 内存泄漏长期运行可能出现内存增长解决方法定期重启服务用 crontab 设置每天重启编译时使用最新版 WebRTC 库限制最大连接数-m 10我在一个 24/7 运行的监控系统中用脚本监控内存占用超过阈值就自动重启效果很不错。