折腾树莓派4B这件事我前前后后重装了不下十次系统从Raspberry Pi OS到Ubuntu 20.04再到各种精简版最后稳定下来在用的组合就是树莓派4B ubuntu20.04 VNC远程桌面 ROS noetic。这套方案的好处很直接——不用给树莓派配显示器键盘一台局域网里的电脑就能远程干所有活而且ROS noetic只在Ubuntu 20.04下运行最顺刚好和树莓派的arm64架构完美匹配。这篇文章把我踩过的坑和最终验证过的完整流程整理出来适合刚拿到板子、想搭建一套ROS开发环境的朋友也适合已经装了一半卡住、想找个可靠参考的人。整个流程我会按选型→烧录→VNC→ROS→联调排错的顺序走每步都把为什么这么做讲清楚方便你以后遇到类似报错能自己判断。1. 选型定版树莓派4B、Ubuntu 20.04 与 ROS Noetic 为什么能凑到一起1.1 ROS版本与Ubuntu版本的强绑定关系先说结论ROS Noetic 只支持 Ubuntu 20.04Focal Fossa这是这一整套方案里最硬的约束。ROS 1 系列里Melodic 对应 Ubuntu 18.04Noetic 对应 Ubuntu 20.04而且 Noetic 是 ROS 1 的最后一个版本官方维护到 2025 年。如果你手里的教程、开源算法代码还是 ROS 1 时代的那么 Noetic 基本就是终点站——想继续升级ROS 1的体验没有下文了要么留在 Noetic要么整体迁移到 ROS 2。这也是我现在还坚持在树莓派4B上装20.04的原因不是20.04有多新而是ROS生态把我钉在了这个版本上。反过来如果你直接装Raspberry Pi OS基于Debian想装ROS Noetic就得自己从源码编译一大堆依赖工程量大而且经常崩。Ubuntu 20.04 官方源里有 ROS Noetic 的 arm64 预编译二进制包apt 直接装省下的编译时间非常可观。1.2 树莓派4B的硬件边界与选型建议树莓派4B用的BCM2711芯片四核Cortex-A72主频1.5GHz后来固件还解锁了1.8GHz性能在一众ARM开发板里不算顶尖但赢在生态完善、资料多遇到问题一搜就有答案。内存有1GB、2GB、4GB、8GB四种版本。我的建议很直接如果你打算在上面跑桌面 VNC ROS内存至少4GB最好8GB。为什么这么强调内存实测在20.04 Xfce桌面环境里空载内存占用大概300~400MB这看着不多但一旦启动 roscore 再跑上几个节点加上开着浏览器查文档2GB 的板子就会开始疯狂用 swapSD卡读写一多整个系统卡到鼠标都飘。8GB 版本就从容很多甚至可以在板子上直接编译 ORB-SLAM3 这类重工程4GB 版本配 2GB swap 也能硬扛。顺带说一句很多人搜树莓派4B引脚功能图是因为后面要接传感器和电机驱动这是另一条线不影响本文的系统搭建但40pin的引脚布局在Ubuntu下的操作方式和树莓派OS基本一致。1.3 Server镜像还是Desktop镜像先想清楚再动手Ubuntu 官方为树莓派发布了两个 20.04.5 镜像一个带 GNOME 桌面一个纯 Server。带桌面的镜像装上就能看图形界面听着方便但 GNOME 3 在树莓派4B上体验并不好空载内存就吃掉 900MB 往上GPU 驱动和桌面特效也会占用 CPU。而且我们最终要用 VNC 远程在 Server 版基础上自己装一个轻量桌面反而比直接用官方桌面镜像更省资源、更好控制。所以我的最终建议是用 64 位 Server 镜像 Xfce4 轻量桌面 TigerVNC。这套结构既满足 VNC 远程桌面的图形操作需求又不至于把树莓派变成一台只会发热的慢电脑。至于 arm64 和 armhf 的差别一句话ROS Noetic 官方为 arm64 提供了完整二进制包32 位 armhf 在 20.04 的软件生态里已经明显边缘化而且 8GB 内存板子只有 64 位系统才能完整利用别在 32 位上纠结。2. 镜像烧录与首次开机四步走通“能开机、能SSH、能上网”2.1 选镜像与烧录工具镜像去 Ubuntu 官方发布页或国内镜像站下载https://cdimage.ubuntu.com/releases/20.04.5/release/选ubuntu-20.04.5-preinstalled-server-arm64raspi.img.xz注意文件名里必须是 arm64 和 raspi。国内从清华、阿里云等镜像站下载更快路径大致是https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cdimage/releases/20.04.5/release/。烧录工具我用过好几个最稳的还是 balenaEtcherWindows/macOS/Linux 跨平台操作极简选镜像、选SD卡、烧录。Linux 下也可以用 dd 直接写xz -dk ubuntu-20.04.5-preinstalled-server-arm64raspi.img.xz sudo dd ifubuntu-20.04.5-preinstalled-server-arm64raspi.img of/dev/sdX bs4M statusprogress convfsync注意 of 一定是对准 SD 卡设备别写错盘符。不管用什么工具烧完的 SD 卡会被分成一个 FAT32 的 system-boot 分区和一个 EXT4 的 writable 分区FAT32 分区在 Windows、macOS 下都能直接读后面预配置全靠它。2.2 首次启动前的三个预配置烧完镜像先别急着插卡开机在 system-boot 分区里提前做好三件配置能省掉一堆折腾。第一账号密码。这个镜像默认用户是ubuntu密码是ubuntu很多人第一次 SSH 进去会被系统强制要求立刻改密码。想跳过这个环节就直接编辑 system-boot 里的user-data文件找到plain_text_passwd: ubuntu这项把 ubuntu 改成你自己想用的密码同时确认ssh_pwauth: true是开着的。保存退出即可。第二Wi-Fi。如果你不打算插网线就编辑同一个分区里的network-config文件在wifis:下面填上你的无线网络。这个文件是 cloud-init 配置格式很严格缩进错了整个网络起不来。下面是我实测可用的写法wifis: wlan0: dhcp4: true optional: true access-points: 你的SSID: password: 你的密码第三SSH。Ubuntu 的这个镜像默认装了 openssh-server 而且允许密码登录如果你改过 user-data 记得把ssh_pwauth保持为 true否则后面连不上。这三个配置做完保存、安全弹出 SD 卡插到树莓派上电。第一次启动会自动做 cloud-init 初始化给板子一两分钟时间然后用电脑 SSH 连过去ssh ubuntu树莓派IPIP 可以从路由器后台看也可以 nmap 扫一下局域网。我建议直接把树莓派在路由器里绑定一个静态 IP或者用 netplan 配置固定 IP因为后面 VNC 和 ROS 都要用这个 IP老是变会很烦。2.3 开机之后的基础检查登录进去后第一件事依次执行sudo apt update sudo apt full-upgrade -y sudo reboot为什么要先升级20.04.5 镜像是一个固定快照里面的内核、固件可能落后于仓库里的修复版尤其树莓派对 GPU、网络驱动的固件更新很敏感不升级的话后面 VNC 可能出各种莫名其妙的显示问题。重启后确认三个基础项uname -m输出 aarch64 代表 64 位系统free -h看内存ip a看网络。如果你完全不用本地 HDMI在/boot/firmware/config.txt里加一行gpu_mem16能再省点内存——但注意如果装了 Xfce 桌面并且还想用 GPU 渲染加速不要压太低。3. VNC远程桌面搭建轻量桌面的选型与配置全记录3.1 为什么我不用官方桌面镜像自带的VNC官方 Desktop 镜像其实自带屏幕共享方案但那是给 GNOME 登录会话用的远程连上去体验一般而且只支持局域网内的简单使用想做成服务自动启动特别别扭。我更推荐 Server Xfce4 TigerVNC 这套组合Xfce4 轻量、稳定TigerVNC 是纯正的开源 VNC 服务端支持多用户会话手动、自动启动都方便。3.2 安装Xfce4桌面与必要组件回到 SSH 终端执行sudo apt install -y xfce4 xfce4-goodies dbus-x11 fonts-noto-cjkdbus-x11尤其重要少了它 VNC 连上之后很容易灰屏因为很多桌面组件需要 D-Bus 会话总线fonts-noto-cjk是为了显示中文不乱码——机器人如果打印中文日志VNC 里看到的就是一排方块口装了这个字体就正常了。这步别去装ubuntu-desktop除非你内存大得没地方用否则光是后台的 GNOME 相关服务就够树莓派喝一壶。3.3 安装TigerVNC并配置用户会话接着安装 VNC 服务端sudo apt install -y tigervnc-standalone-server tigervnc-common先设置 VNC 专属密码注意这个密码不是系统登录密码是远程连接 VNC 时用的vncpasswd执行后会提示要不要再设一个 view-only 密码意思是只能看不能操作的密码按 n 跳过就行。然后创建用户级启动脚本mkdir -p ~/.vnc nano ~/.vnc/xstartup写入#!/bin/sh unset SESSION_MANAGER unset DBUS_SESSION_BUS_ADDRESS export XKL_XMODMAP_DISABLE1 [ -r $HOME/.Xresources ] xrdb $HOME/.Xresources dbus-launch startxfce4 保存后用chmod x ~/.vnc/xstartup加上执行权限。这步是最容易被忽略的坑脚本没权限VNC 起了一个空会话连上去就是灰屏。启动 VNCvncserver -geometry 1920x1080 -depth 24 :1:1代表显示编号 1对应端口是 5901。如果想在局域网内被其他设备访问可以加-localhost no避免只绑定到本机回环。3.4 客户端连接与“激活秘钥”辟谣Windows/Mac 电脑上装 VNC ViewerRealVNC 出品或者 TigerVNC Viewer 都行。很多人搜vnc viewer 下载和vnc 激活秘钥这里明确说一下VNC Viewer 个人使用是免费的不需要任何激活秘钥TigerVNC Viewer 更是完全开源连账号都不用注册。如果看到要密钥的页面多半是下到了企业版或者奇怪来源的安装包直接换官方渠道就好。打开 VNC Viewer地址栏输入树莓派IP:5901回车输刚才 vncpasswd 设的密码就能看到 Xfce 桌面了。这个桌面就是树莓派上的真实用户会话你在这个桌面上打开的终端、跑的程序全都跑在板子上。3.5 让VNC随系统自启systemd服务手动启动 VNC 适合调试但机器人项目的常态是树莓派上电就跑所以我用 systemd 把它做成自启服务。新建服务文件sudo nano /etc/systemd/system/vncserver.service内容如下[Unit] DescriptionTigerVNC Server Aftersyslog.target network.target [Service] Typeforking Userubuntu Groupubuntu WorkingDirectory/home/ubuntu ExecStartPre/bin/sh -c /usr/bin/vncserver -kill :1 /dev/null 21 || : ExecStart/usr/bin/vncserver -localhost no :1 -geometry 1920x1080 -depth 24 ExecStop/usr/bin/vncserver -kill :1 [Install] WantedBymulti-user.target注意把 User 和 Group 改成你的实际用户名。然后sudo systemctl daemon-reload sudo systemctl enable vncserver --now sudo systemctl status vncserver这样就算板子重启VNC 也会自动起来。到这里远程桌面这块就齐了。4. ROS Noetic 安装的完整链路换源、装包、初始化一条龙4.1 软件源与ROS密钥的现代配置姿势ROS Noetic 的官方 apt 源在国外国内直连速度通常不理想建议直接用清华大学 TUNA 镜像。先把 ROS 的仓库地址写进系统sudo sh -c echo deb [signed-by/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/ros/ubuntu focal main /etc/apt/sources.list.d/ros1.list这里用了signed-by指定密钥文件的方式比老的apt-key add更符合现在的安全习惯。接下来下载并转换 ROS 官方签名密钥curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo gpg --dearmor -o /usr/share/keyrings/ros-archive-keyring.gpg如果你不想用 signed-by 方式老办法也行sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654apt-key 在 20.04 上会打印一堆 deprecation 警告但功能正常。两种方式选一种就行别两个都做不然源里会重复。4.2 安装桌面完整版还是基础版先更新索引sudo apt update然后按需选包sudo apt install -y ros-noetic-desktop-fullros-noetic-desktop-full包含 ROS、rqt、rviz、Gazebo 等几乎所有常用组件是最省心的选择但体积很大在树莓派上下载加解压可能要三四十分钟。如果你的项目明确不需要 Gazebo 仿真装ros-noetic-desktop就够了。如果完全走无头模式只想让板子跑节点、通过局域网把话题数据发到电脑处理连图形库都可以不要装ros-noetic-ros-base最小集即可。我个人做 SLAM 实验时习惯在板子上装 desktop不带 Gazebo电脑上装完整版跑 rviz板子上的资源留给真正干活的节点。这个取舍在树莓派上尤其重要毕竟它总共就那几个 G 内存和 CPU。4.3 rosdep init与update最大概率翻车的环节装完 ROS 本体后官方流程是执行sudo rosdep init rosdep updaterosdep的作用是解析 ROS 包的依赖关系以后从源码编译包时必须用到。这步在不少玩家手里翻车率很高原因是rosdep init要从 raw.githubusercontent.com 拉取默认源列表而很多网络环境下这个域名直连经常超时报错信息通常是连接超时或者无法解析。解决方案是改用国内 Gitee 上的 rosdistro 镜像设置环境变量后重新走export ROSDISTRO_INDEX_URLhttps://gitee.com/ros-mirror/rosdistro/raw/master/index-v4.yaml sudo rosdep init rosdep update如果rosdep update还是慢可以把~/.ros/下的缓存删掉重试也可以多跑两次这个命令本身支持增量更新。多说一句rosdep 只在源码编译时才必须如果后面一直用 apt 装 ROS 包暂时卡在 rosdep 也可以先继续但既然要搭环境我建议还是花几分钟搞定不然以后想拉源码包编译还得回头补课。4.4 环境变量、catkin工作区与第一次验证把 ROS 环境写进 bashrc让每次新终端都能直接使用 ROS 命令echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc然后验证roscore看到started core service [/rosout]就是成功了。再开一个终端跑一下自带的小乌龟做一次端到端验证rosrun turtlesim turtlesim_node如果 VNC 桌面里弹出一个蓝色背景的小乌龟窗口说明整个链路已经全部打通Ubuntu 系统正常、VNC 会话正常、ROS 运行正常、GUI 通过 VNC 显示正常。我第一次在这套环境跑通的时候那种无头板子带着图形桌面跑起来的爽感还是很足的。之后可以创建 catkin 工作区为后续编译自己的功能包做准备source /opt/ros/noetic/setup.bash mkdir -p ~/catkin_ws/src cd ~/catkin_ws/src catkin_init_workspace cd ~/catkin_ws catkin_make编译大包之前记得给板子加 swap不然 8GB 以下的板子很容易 OOM。我用的是手动 swap 文件方案sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo /swapfile none swap sw 0 0 | sudo tee -a /etc/fstab5. 组合联调与高频翻车现场VNC掉线、灰屏、rosdep超时5.1 一套完整的联调检查清单环境搭好不是终点还要能长期稳定用。我总结了一份联调检查清单每次动过网络、改过系统服务后都会过一遍树莓派上电等 1 分钟SSH 能连上说明系统正常。VNC Viewer 连接 5901 端口能出桌面说明 VNC 自启正常。桌面里开终端跑source /opt/ros/noetic/setup.bash roscore说明 ROS 环境正常。跑rosrun turtlesim turtlesim_node窗口能出来说明 GUI 和 ROS 通道都通。拔掉 HDMI、键盘、网线只留电源重复上面步骤确认完全无头运行也稳定。这五条全部通过这个板子才算真正毕业可以丢进项目里用了。下面把最常见的几类问题集中列一下方便对照现象大概率原因处理办法VNC 连上灰屏xstartup 无执行权限 / 缺 dbus-x11chmod x安装 dbus-x11看日志连接一段时间自动退出服务端崩溃或网络链路断开vncserver -list 判断固定 IP加 swap登录界面光标点不进密码框VNC 连到了图形登录管理器systemctl set-default multi-user.targetrosdep init/update 超时默认源列表下载失败设置 ROSDISTRO_INDEX_URL 换镜像编译大包时系统卡死内存不足触发 swap 风暴添加 2G swapfile5.2 VNC灰屏与自动退出的根因和处理先说灰屏。VNC 能连上但桌面一片灰十有八九是~/.vnc/xstartup的问题要么脚本没执行权限要么里面少了dbus-launch要么startxfce4命令没找到。排错顺序是先vncserver -kill :1杀掉旧会话然后重启 VNC再去看~/.vnc/板子名:1.log日志日志会直接告诉你哪一步挂了。加dbus-launch startxfce4 这段后再重启90% 的灰屏都能解决。再说VNC 连接后过一段时间自动退出。这个问题的本质不是 VNC 服务端崩溃就是网络链路断了。先看日志确认服务端是否还活着vncserver -list如果列表里:1还在那就是网络问题重点排查 Wi-Fi 信号弱、路由器把空闲连接踢了、IP 变动。对策我一般给三条一是给树莓派固定 IP二是路由器里把 DHCP 租约时间调长三是检查有没有防火墙误杀。如果列表里:1都没了那是服务端 OOM 被杀或崩溃加 swap、升级内核、把自启动服务装上基本能压住。5.3 登录界面光标无法停留在密码框的问题这个坑非常经典你用 VNC 连接一个启动了图形登录管理器LightDM/GDM的系统VNC 显示的是登录界面这时鼠标和键盘焦点经常对不上光标根本点不进密码框。解决办法是在树莓派上关掉图形登录管理器让系统默认进入多用户命令行模式然后直接用用户级的 VNC 服务拉起 Xfce 会话绕开登录界面sudo systemctl set-default multi-user.target sudo reboot重启后系统不会跳到本地登录界面只有通过 VNC 连接时才会创建 Xfce 会话自然也就不存在光标停不进密码框的问题。这跟联调清单第 5 条完全对应无头运行、VNC 直接进桌面会话而不是进登录界面。5.4 资源优化与后续扩展思路配置都通了以后还有几个优化点值得做。内存上除了前面说的gpu_mem16还可以把 Xfce 的窗口特效关掉减少 CPU 负担VNC 分辨率别盲目上 4K1920x1080 在绝大多数场景够用太大反而拖帧率。存储上SD 卡建议至少用 A2 速度等级预算允许的话直接上 USB3.0 移动固态盘启动速度提升非常明显ROS 日志频繁写入时尤其能感受到差别。这套环境搭完之后下一步自然是往里面塞真正的算法包。我自己就是用这个环境跑视觉 SLAM照着社区里流行的做法把 ORB-SLAM3 源码拉到板子上编译配合相机做实验。你在网上搜orbslam3 部署 ubuntu20.04能搜到大量方案基本前提都是先有一套干净的 Ubuntu 20.04 ROS Noetic 环境而这篇文章正好帮你把这步走完了。整套流程如果你在某个环节卡住优先去看日志文件——SSH 看系统日志VNC 看~/.vnc下的 logROS 看~/.ros/log日志从来不会骗人比瞎猜和反复重装都靠谱。