把树莓派变成监控摄像头：CSI相机+FFmpeg推流到Home Assistant/萤石云完整教程
树莓派智能监控系统搭建：从硬件配置到云端集成实战指南
在智能家居和安防监控领域，树莓派凭借其小巧的体积、强大的性能和极高的可定制性，成为了DIY爱好者的首选平台。本文将带你一步步将树莓派和CSI相机打造成一个功能完备的监控系统，不仅能实现本地高清视频采集，还能通过FFmpeg推流至Home Assistant智能家居平台或萤石云等第三方服务，构建一个低成本、高灵活度的私有监控解决方案。
1. 硬件准备与环境配置
1.1 选择合适的树莓派与相机模块
对于监控系统而言，树莓派4B或更新的型号是最佳选择，其更强的处理能力能够流畅处理视频编码任务。官方CSI相机模块V2版本提供了800万像素的拍摄能力，支持1080p@30fps的视频录制，是监控应用的理想选择。
硬件清单：
- 树莓派4B/5（建议4GB内存以上版本）
- 官方CSI相机模块V2
- 优质CSI排线（长度根据安装位置选择）
- 合适的散热方案（监控系统可能长时间运行）
- 大容量存储卡（建议64GB以上，Class 10速度等级）
- 稳定的电源适配器（5V/3A）
提示：如果需要在低光环境下使用，可以考虑带有红外夜视功能的第三方CSI相机模块。
1.2 系统安装与基础配置
推荐使用Raspberry Pi OS Lite版本（64位）作为基础系统，减少不必要的资源消耗：
# 更新系统并安装必要组件 sudo apt update && sudo apt upgrade -y sudo apt install -y ffmpeg v4l-utils python3-pip启用CSI相机接口：
sudo raspi-config在界面中选择"Interface Options" → "Camera"并启用，完成后重启系统。
验证相机是否正常工作：
libcamera-hello -t 0如果能看到实时视频流，说明相机配置成功。
2. 视频采集与FFmpeg推流配置
2.1 优化视频采集参数
监控场景下，我们需要平衡视频质量、流畅度和系统负载。以下是一组经过优化的采集参数：
# 使用libcamera-vid捕获视频流 libcamera-vid -t 0 --width 1280 --height 720 --framerate 15 --codec h264 --profile high --bitrate 1500000 --output - | \ ffmpeg -i - -c copy -f rtsp rtsp://localhost:8554/mystream参数说明：
--width/--height：分辨率设置为720p，平衡清晰度和带宽--framerate 15：15fps对于监控场景足够流畅--bitrate 1500000：1.5Mbps比特率保证画质--profile high：使用H.264 High Profile提高压缩效率
2.2 FFmpeg推流进阶配置
为了实现更稳定的推流，我们可以添加缓冲和重连机制：
ffmpeg -fflags +genpts -use_wallclock_as_timestamps 1 -i - \ -c:v copy -f rtsp -rtsp_transport tcp \ -max_delay 100000 -reorder_queue_size 1000 \ -resend_headers 10 -stimeout 5000000 \ "rtsp://your_rtsp_server/mystream"关键参数解析：
-rtsp_transport tcp：使用TCP传输，提高稳定性-max_delay 100000：设置最大延迟为100ms-reorder_queue_size 1000：设置重排序缓冲区大小-resend_headers 10：每10秒重发一次头信息-stimeout 5000000：设置超时为5秒
3. 系统集成与智能功能实现
3.1 接入Home Assistant平台
在Home Assistant中，通过configuration.yaml添加摄像头：
camera: - platform: ffmpeg name: Raspberry Pi Camera input: -rtsp_transport tcp -i rtsp://your_pi_ip:8554/mystream extra_arguments: -pred 1 -q:v 2对于更高级的集成，可以使用以下配置实现运动检测和自动化：
binary_sensor: - platform: ffmpeg_motion input: -rtsp_transport tcp -i rtsp://your_pi_ip:8554/mystream name: Camera Motion changes: 10 reset: 20 automation: - alias: "Record on motion" trigger: platform: state entity_id: binary_sensor.camera_motion to: "on" action: - service: camera.record data: entity_id: camera.raspberry_pi_camera filename: '/media/motion/recording_{{ now().strftime("%Y%m%d_%H%M%S") }}.mp4' duration: 303.2 推流至萤石云等第三方平台
如果需要将视频流推送至萤石云等商业平台，可以使用FFmpeg进行转码推流：
ffmpeg -i rtsp://localhost:8554/mystream \ -c:v libx264 -preset ultrafast -tune zerolatency \ -b:v 1000k -maxrate 1000k -bufsize 2000k \ -f flv "rtmp://publish.ys7.com:2935/your_stream_key"推流参数优化建议：
- 使用
-preset ultrafast降低编码延迟 -tune zerolatency启用零延迟模式- 根据网络状况调整比特率（
-b:v） - 设置适当的缓冲区大小（
-bufsize）
4. 系统优化与高级功能
4.1 存储管理与循环录制
监控系统通常需要长时间运行，合理的存储管理至关重要。以下是使用logrotate管理录像文件的配置示例：
# /etc/logrotate.d/pi_camera /media/motion/*.mp4 { daily rotate 7 compress delaycompress missingok notifempty create 640 pi pi }对于更精细的存储控制，可以使用以下Python脚本实现基于运动检测的智能录制：
import subprocess import time import os REC_DIR = "/media/motion" MAX_SIZE_GB = 32 MIN_FREE_SPACE_GB = 5 def get_free_space(): stat = os.statvfs(REC_DIR) return stat.f_bavail * stat.f_frsize / 1024 / 1024 / 1024 def cleanup_oldest(): files = sorted([os.path.join(REC_DIR, f) for f in os.listdir(REC_DIR)], key=os.path.getmtime) while get_free_space() < MIN_FREE_SPACE_GB and files: os.remove(files[0]) files = files[1:] while True: if get_free_space() < MIN_FREE_SPACE_GB: cleanup_oldest() time.sleep(3600) # 每小时检查一次4.2 低功耗与稳定性优化
对于7×24运行的监控系统，稳定性至关重要。以下是一些优化建议：
温度控制：
# 安装温度监控 sudo apt install -y lm-sensors sudo sensors-detect内存优化：
# 调整swappiness echo "vm.swappiness=10" | sudo tee -a /etc/sysctl.conf sudo sysctl -p看门狗定时器：
# 启用硬件看门狗 sudo apt install -y watchdog sudo systemctl enable watchdog sudo systemctl start watchdog自动恢复服务： 创建systemd服务单元文件
/etc/systemd/system/camera_stream.service：[Unit] Description=Raspberry Pi Camera Stream After=network.target [Service] Type=simple User=pi ExecStart=/home/pi/start_stream.sh Restart=always RestartSec=10 [Install] WantedBy=multi-user.target
5. 安全防护与远程访问
5.1 基础安全加固
监控系统往往涉及隐私数据，安全防护不可忽视：
# 更改默认密码 passwd # 禁用SSH密码认证 sudo sed -i 's/#PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config sudo systemctl restart ssh # 配置防火墙 sudo apt install -y ufw sudo ufw allow 22/tcp sudo ufw allow 8554/tcp # RTSP端口 sudo ufw enable5.2 安全的远程访问方案
如果需要从外部网络访问监控流，建议使用以下安全方案：
- VPN接入：通过路由器或专用设备建立VPN通道
- 反向代理：使用Nginx进行加密代理
Nginx配置示例：
stream { server { listen 443; proxy_pass localhost:8554; ssl_certificate /etc/ssl/certs/nginx.crt; ssl_certificate_key /etc/ssl/private/nginx.key; ssl_protocols TLSv1.2 TLSv1.3; } }- 端口随机化：避免使用默认RTSP端口
- 流媒体加密：启用RTSP over SSL/TLS
5.3 视频流加密与隐私保护
对于敏感场景，可以对视频流进行加密：
# 生成自签名证书 openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes # 使用加密的RTSP流 ffmpeg -i /dev/video0 -c:v libx264 -f rtsp -rtsp_transport tcp \ -encryption_scheme cenc-aes-ctr -encryption_key 12345678901234567890123456789012 \ -encryption_kid aabbccddeeff00112233445566778899 rtsp://your_server:8554/secure_stream在客户端播放时，需要提供相应的解密密钥才能观看视频内容。