树莓派变身WebRTC流媒体服务器：rpi-webrtc-streamer项目完全解析
【免费下载链接】rpi-webrtc-streamerThis repo's objective is providing something like Web Cam server on the most popular Raspberry PI hardware. By integrating [WebRTC](https://webrtc.org/native-code/) and Raspberry PI, we can stream the Raspberry camera feed to browser or native client which talks WebRTC.项目地址: https://gitcode.com/gh_mirrors/rp/rpi-webrtc-streamer
想让树莓派变身一台低延迟的 WebRTC 流媒体服务器吗？rpi-webrtc-streamer（简称 RWS）正是为此而生的开源项目：它把 WebRTC 原生能力与树莓派硬件深度融合，无需额外服务器，就能把树莓派摄像头画面实时推送到浏览器或手机。本文将从架构、功能、安装配置到实战技巧，为你完整解析这一树莓派 WebRTC 流媒体方案。
rpi-webrtc-streamer 是什么？为何值得一试？
传统"树莓派摄像头直播"方案往往需要推流到云端中转，延迟高、依赖公网服务器。而 RWS 的思路完全不同：它直接内嵌了 WebRTC 信令服务器能力，浏览器或客户端可以直接连接树莓派并建立 P2P 媒体通道，延迟低至毫秒级，画面不绕路、更私密。
简单来说，rpi-webrtc-streamer = 树莓派摄像头 + WebRTC 原生库 + 轻量信令服务，一台树莓派就能承担"摄像头 + 推流 + 信令"的全部工作，是搭建家庭监控、宠物观察、远程看护的极佳选择。
核心架构：一张图看懂 RWS 如何工作
上图展示了 RWS 的完整数据流：
- 客户端层：浏览器、手机通过 HTTPS/SRTP 与树莓派通信；
- 信令层：NGINX 等 HTTP 服务器承担信令交换，也可以让 RWS 独立运行内置的 HTTP/WebSocket 服务；
- 媒体层：摄像头采集画面 → GPU 通过 MMAL 编码为 H.264 帧 → WebRTC Streamer 核心模块打包推送给客户端；
- 接入层：WebRTC C++ Native API 负责与浏览器的 SDP/ICE 协商和媒体传输。
整套链路中，RWS 的核心逻辑集中在 streamer.cc、streamer_signaling.cc 和 websocket_server.cc，入口在 main.cc，感兴趣的同学可以直接读源码验证上面的架构描述。
三大核心功能，让树莓派不只是摄像头
1. 实时 WebRTC 视频流 📹
RWS 集成 raspivid 与 MMAL 库，直接用树莓派 GPU 完成 H.264 编码，CPU 占用极低。打开浏览器访问测试页面（默认端口 8889 的/native-peerconnection/），点击 Connect 即可观看实时画面。
2. 零 CPU 开销的运动检测 🚶
与常见的像素分析法不同，RWS 利用 H.264 编码时 GPU 自动生成的运动矢量（Motion Vector）来做运动检测，几乎不额外消耗 CPU。检测到运动后还能自动把视频片段保存为文件，相关实现见 raspi_motion.cc 和 raspi_motionblob.cc。
3. Telegram 机器人报警 🤖
运动检测事件可以联动 Telegram Bot，把报警消息和录制的视频片段直接推送到你的手机，秒变私人安防机器人。配套脚本在 tools/telegramBot.py，配置模板见 etc/template/telegramBot.conf。
硬件需求：这些设备就能跑
| 类别 | 支持型号 |
|---|---|
| 树莓派 | Raspberry Pi 2 / 3、Raspberry Pi Zero W |
| 摄像头 | RPI Camera Board V1/V2、Arducam OV5647 等 CSI 摄像头 |
| 可选 | USB 麦克风（音频采集） |
RWS 对 armv6（Zero W）和 armv7+（Pi 2/3）都做了针对性优化，相关交叉编译配置见 misc/webrtc_armv6_build_args.gn 与 misc/webrtc_arm_build_args.gn。
快速上手：从下载到看到画面
方式一：Docker 一键运行（推荐测试）
docker pull kclyu/rpi-webrtc-streamer docker container run --device=/dev/vcsm --device=/dev/vchiq \ --net=host --rm -d kclyu/rpi-webrtc-streamer方式二：源码编译部署
先获取源码：
git clone https://gitcode.com/gh_mirrors/rp/rpi-webrtc-streamer然后参考 README_building.md 完成交叉编译（需要 WebRTC 原生库和 rpi_rootfs），安装后用 systemd 管理：
sudo systemctl start rws # 启动 sudo systemctl status rws # 查看状态 sudo journalctl -u rws # 查看日志启动后在浏览器打开http://树莓派IP:8889/native-peerconnection/即可看到实时画面 🎉。
关键配置：一行参数玩转流媒体
RWS 的配置集中在etc/template/下的三个模板文件：
- webrtc_streamer.conf：主配置，端口、STUN、音视频开关等。默认 WebSocket 端口 8889、直连端口 8888；
- media_config.conf：码率、分辨率、帧率、曝光/白平衡等画质参数，还支持基于带宽估算的动态分辨率/帧率调节；
- motion_config.conf：运动检测开关、检测灵敏度、视频保存目录等，把
motion_detection_enable改为true即可开启。
Telegram 报警实战：三步收到树莓派报警
第一步，在 Telegram 中向BotFather发送/newbot创建机器人，流程如下：
第二步，把 BotFather 返回的 Token 填入telegramBot.conf的auth_token字段；第三步，启动服务：
sudo ./telegramBot.py --install-systemd-service sudo systemctl enable telegramBot && sudo systemctl start telegramBot之后每当树莓派检测到运动，你的手机就会收到带视频片段的报警消息，私人安防就这么简单。更多细节可参考 README_TelegramBot.md。
总结
rpi-webrtc-streamer 把 WebRTC 流媒体服务器、运动检测和消息推送三大能力浓缩进一台树莓派，延迟低、成本低、可玩性高。无论你是想搭家庭监控、宠物直播，还是想深入学习 WebRTC 与嵌入式结合的技术细节，这个开源项目都值得一试。快克隆源码，让你的树莓派正式上岗成为 WebRTC 流媒体服务器吧！
【免费下载链接】rpi-webrtc-streamerThis repo's objective is providing something like Web Cam server on the most popular Raspberry PI hardware. By integrating [WebRTC](https://webrtc.org/native-code/) and Raspberry PI, we can stream the Raspberry camera feed to browser or native client which talks WebRTC.项目地址: https://gitcode.com/gh_mirrors/rp/rpi-webrtc-streamer
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
