企业官网建设流程全解析

Rpisurv快速上手：5分钟把树莓派变成摄像头监控大屏

【免费下载链接】rpisurvRaspberry Pi surveillance项目地址: https://gitcode.com/gh_mirrors/rp/rpisurv

Rpisurv 是一款免费开源的树莓派监控软件，它的使命很纯粹：把树莓派变成一台专用的摄像头监控大屏。你不需要手工计算坐标、不需要写复杂的脚本，只要把树莓派接上显示器、填好视频流地址，Rpisurv 就会自动完成画面布局、断线检测与自愈重启，让一块 24 小时无人值守的树莓派监控大屏轻松落地。本篇文章将从零开始，带你 5 分钟完成 Rpisurv 安装配置并跑通第一个监控画面。

Rpisurv是什么？免费开源的树莓派监控大屏方案

Rpisurv（Raspberry Pi surveillance）是一个把树莓派变成专用视频墙的开源应用，支持同时显示多路视频流或图片流。和普通监控软件相比，它的最大特色是**"全自动"**：

• ✅自愈式健康监测：每路视频流都有外部 watchdog 看门狗守护，进程意外被杀会自动重启，保证监控大屏长期稳定在线
• ✅自动排版布局：屏幕坐标全部自动计算，无需手动调整，摄像头断连后画面会自动重排
• ✅屏幕轮播切换：可配置多个屏幕页面，按时间自动轮播，也支持键盘或触屏手动切换
• ✅双 HDMI 输出：开机自动检测第二块屏幕，双屏监控画面独立配置、同步控制
• ✅多种流类型：支持 rtsp/rtmp/http/https 视频流，也支持自动刷新的图片流

装前准备：打造树莓派摄像头监控大屏需要哪些硬件

开始安装前，请先备齐以下"原料"：

• 🖥️一块显示器或电视（支持双屏更佳，可接两个 HDMI）
• 🍓一台树莓派（Raspberry Pi 3/4 均可，建议刷入 Raspberry Pi OSFull 版本）
• 🎥摄像头或视频源：支持 RTSP/HTTP 协议的 IP 摄像头，或本地视频文件
• 🔌 键鼠或触屏（用于运行时切换屏幕，非必需）

小贴士：如果打算同时显示多路摄像头，建议在/boot/config.txt中把gpu_mem调整为 512，避免 GPU 内存不足导致画面起不来。

一键安装：Rpisurv安装配置教程（5分钟完成）

克隆仓库并执行安装脚本，这是最快的 Rpisurv 安装方法：

git clone https://gitcode.com/gh_mirrors/rp/rpisurv cd rpisurv sudo ./install.sh

install.sh 脚本会自动完成以下工作：安装 vlc、pygame 等依赖 → 关闭图形登录以节省资源 → 把程序部署到/usr/local/bin/rpisurv→ 注册 systemd 服务（rpisurv.service）→ 把配置目录软链接到/etc/rpisurv。安装完成后，主程序入口在 surveillance.py，随系统开机自启，无需任何人工干预。

配置摄像头流：认识核心配置文件display1.yml

安装完成后，Rpisurv 的配置集中在/etc/rpisurv目录下，主要关注两个文件：

配置逻辑很简单：显示器（display）包含多个屏幕（screen），每个屏幕由若干路视频流（camera_streams）组成。一个最小可用的流配置长这样：

- camera_streams: - url: "rtsp://用户:密码@摄像头IP:端口/videoMain" probe_timeout: 3 - url: "file:///usr/local/bin/rpisurv/demo/resources/demo.png" imageurl: true duration: 30

URL 支持rtsp://、rtmp://、http(s)://视频流，以及带imageurl: true标记的图片流；duration控制该屏幕每次轮播的停留秒数。编辑完配置后执行sudo systemctl restart rpisurv即可生效。

自动布局与自愈：Rpisurv监控大屏如何保持在线

这是 Rpisurv 最值得称道的特性。系统默认每 19 秒检查一次当前屏幕所有视频流的连通性（对应 general.yml 中的interval_check_status）：

• 某路摄像头断流时，Rpisurv 会自动把它从布局中移除，并重新计算剩余画面的位置
• 某路摄像头恢复后，Rpisurv 也会自动把它重新加入布局，全程无需人工操作
• 即使视频流进程被意外杀死，外部 watchdog 看门狗也会立刻尝试重启

配合enable_opportunistic_caching_next_screen的预缓存机制，屏幕切换几乎无感，非常适合长时间无人值守的监控场景。

进阶玩法：双屏监控、屏幕轮播与画中画

当你的监控需求升级时，Rpisurv 还提供了不少进阶能力：

• 🔁多屏幕轮播：定义多个 screen，按设定的duration自动循环展示；按住n或空格可强制切换到下一屏，按p暂停轮播、r恢复
• 🖥️双屏独立监控：两块 HDMI 屏幕可配置完全不同的画面组，同时受控
• 🪟画中画效果：通过force_coordinates手动指定坐标，配合showontop: true可实现子画面叠加显示
• 🖼️数字标牌玩法：把图片流指向远程图片地址，图片更新时画面自动刷新，可当作品牌信息发布墙

常见问题排查与占位图说明

初次使用时遇到黑屏或提示画面，多半和占位图有关。Rpisurv 内置了三张状态图片，位于 surveillance/images 目录：

• connecting.png：摄像头正在连接启动时的提示画面
• placeholder.png：布局中空位（无流填充）时的占位画面
• noconnectable.png：当前屏幕所有视频流都不可连接时全屏显示的提示

排查小技巧：先把视频流地址放到 VLC 里验证能否播放；如果画面出现"拖影"效果，可在对应流上添加rtsp_over_tcp: true；日志默认写在/usr/local/bin/rpisurv/logs/，排障时记得先看日志。

总结：5分钟从零拥有你的树莓派监控大屏

从克隆仓库到画面点亮，Rpisurv 把树莓派监控大屏的搭建门槛降到了最低：一键安装、配置文件即学即用、断线自愈全自动。无论是家用看护、店铺安防，还是门店信息发布墙，它都是一套低功耗、免维护的开源好方案。现在就动手，把闲置的树莓派变成你的专属摄像头监控大屏吧！

【免费下载链接】rpisurvRaspberry Pi surveillance项目地址: https://gitcode.com/gh_mirrors/rp/rpisurv