树莓派跑YOLOv5？先搞定远程桌面！用VNC Viewer实时查看检测结果的完整配置流程

张

张建站

2026/5/27 11:34:00

10分钟阅读

树莓派跑YOLOv5先搞定远程桌面用VNC Viewer实时查看检测结果的完整配置流程在AI模型部署的实践中树莓派因其小巧便携和低功耗特性成为边缘计算的热门选择。但当你尝试在树莓派上运行YOLOv5这类计算机视觉模型时一个现实问题立刻浮现如何实时查看检测结果外接显示器固然直接但多数开发者更希望用现有电脑远程操作——这正是VNC技术的用武之地。本文将带你从零搭建树莓派远程桌面环境特别针对YOLOv5运行场景优化显示性能。不同于通用教程我们会深入解决OpenCV窗口显示异常、Matplotlib绘图卡顿等实际问题让你在远程桌面上获得接近本地的调试体验。无论你是想观察实时摄像头检测画面还是分析模型输出的检测框这套方案都能让开发流程更加高效。1. 系统准备与基础配置1.1 树莓派系统烧录开始前需要准备树莓派主板推荐4B型号2GB内存起步16GB以上容量的Micro SD卡官方Raspberry Pi Imager工具关键烧录设置使用Imager工具时点击齿轮图标主机名raspberrypi.local可自定义启用SSH密码认证设置用户名和密码建议避免默认的pi/raspberry 配置Wi-Fi填写SSID和密码区域设置时区选择Asia/Shanghai提示建议勾选预装VNC Server选项可省去后续手动安装步骤。如果使用Raspberry Pi OS Lite系统需额外安装桌面环境。1.2 首次启动与网络配置插入SD卡通电启动后通过路由器后台或手机热点客户端列表查找树莓派IP地址。更专业的方法是使用nmap扫描nmap -sn 192.168.1.0/24 | grep -B 2 Raspberry Pi找到设备后用SSH登录进行基础配置ssh usernameraspberrypi.local sudo raspi-config在配置界面中依次启用VNC服务Interface Options VNCGPU内存分配Performance Options GPU Memory设为128MB桌面自动启动Boot Options Desktop Autologin2. VNC服务深度配置2.1 服务端安装与优化树莓派官方系统通常预装RealVNC但性能更好的TightVNC值得考虑sudo apt update sudo apt install tightvncserver -y创建自定义启动脚本~/.vnc/xstartup#!/bin/sh unset SESSION_MANAGER exec /etc/X11/xinit/xinitrc [ -x /etc/vnc/xstartup ] exec /etc/vnc/xstartup [ -r $HOME/.Xresources ] xrdb $HOME/.Xresources xsetroot -solid grey vncconfig -iconic export XKL_XMODMAP_DISABLE1 startxfce4 赋予执行权限后启动服务chmod x ~/.vnc/xstartup vncserver :1 -geometry 1280x720 -depth 242.2 客户端连接技巧推荐使用RealVNC Viewer或TigerVNC客户端。连接时注意地址格式树莓派IP:1端口5901色彩质量选择Medium平衡性能与画质启用Adaptive Quality自动调整画质针对YOLOv5的特殊优化# 在树莓派上执行减少桌面特效提升性能 xfconf-query -c xfwm4 -p /general/use_compositing -s false3. YOLOv5运行环境搭建3.1 Python环境配置建议使用conda管理环境以避免依赖冲突wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-armv7l.sh bash Miniconda3-latest-Linux-armv7l.sh conda create -n yolov5 python3.8 conda activate yolov5安装依赖时特别注意OpenCV的兼容性pip install torch1.8.0 torchvision0.9.0 -f https://torch.kmtea.eu/whl/stable.html pip install opencv-python-headless4.5.3.563.2 显示问题专项解决YOLOv5默认使用OpenCV的imshow()显示检测结果这在VNC中可能失效。两种解决方案方案A改用Matplotlib显示import matplotlib.pyplot as plt def cv2_imshow(title, image): image cv2.cvtColor(image, cv2.COLOR_BGR2RGB) plt.imshow(image) plt.title(title) plt.axis(off) plt.show()方案B通过SSH转发X11显示ssh -X usernameraspberrypi.local python detect.py --source 0 # 窗口将显示在本地性能对比表显示方式帧率(FPS)CPU占用内存占用原生VNC8-1045%120MBX11转发5-760%150MBMatplotlib3-570%200MB4. 高级调试技巧4.1 双屏工作流配置高效开发者可以同时使用VNC窗口运行Python脚本和查看日志SSH终端执行命令和监控系统状态使用tmux创建持久会话tmux new -s yolo # 在tmux中启动检测脚本 python detect.py --weights yolov5s.pt --source 0 # 按CtrlB然后按D脱离会话 # 重新连接tmux attach -t yolo4.2 性能监控仪表盘安装glances实现远程监控pip install glances glances --webserver浏览器访问http://树莓派IP:61208即可查看实时资源占用。4.3 自动化启动脚本创建/etc/systemd/system/yolo.service实现开机自启[Unit] DescriptionYOLOv5 Detection Service Afternetwork.target [Service] Userpi WorkingDirectory/home/pi/yolov5 ExecStart/home/pi/miniconda3/envs/yolov5/bin/python detect.py --weights yolov5s.pt --source 0 --view-img Restartalways [Install] WantedBymulti-user.target启用服务sudo systemctl daemon-reload sudo systemctl enable yolo.service sudo systemctl start yolo.service5. 常见问题排查VNC连接黑屏检查/etc/X11/xorg.conf是否正确配置尝试更换桌面环境sudo apt install xfce4OpenCV无法显示窗口安装必要的依赖sudo apt install libgtk-3-dev或在代码中添加cv2.namedWindow(output, cv2.WINDOW_NORMAL)检测延迟严重降低分辨率python detect.py --imgsz 320使用更小模型--weights yolov5n.pt关闭桌面特效xfconf-query -c xfwm4 -p /general/use_compositing -s false内存不足崩溃添加交换空间sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile在/etc/sysctl.conf添加vm.swappiness10