news 2026/3/22 6:30:13

新手教程:树莓派5安装ROS2前的镜像刷写准备

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
新手教程:树莓派5安装ROS2前的镜像刷写准备

树莓派5跑ROS2,从刷系统开始:新手避坑全指南

你是不是也想用树莓派5搭一个机器人控制器?手头有板子、电源、SD卡,跃跃欲试准备安装ROS2——结果刚起步就卡在了“怎么装系统”这一步?

别急。很多初学者以为“树莓派5安装ROS2”的第一步是敲命令sudo apt install ros-humble-desktop,但实际上,真正关键的第一步,是从选对系统镜像和正确刷写开始的

如果你跳过这个环节直接上手,轻则启动不了,重则反复折腾几天才发现系统架构不对、驱动不兼容、SSH连不上……白白浪费时间。

今天我们就来把这件事讲透:如何为树莓派5选择合适的操作系统、用什么工具安全刷入,并提前配置好无显示器也能远程控制的开发环境。这套流程走完,你的树莓派5就能稳稳当当接入网络, ready for ROS2。


为什么不能随便找个Linux镜像刷?

先泼一盆冷水:不是所有叫“Ubuntu”的镜像都能在树莓派5上跑,更别说运行ROS2了。

树莓派5使用的是ARM64 架构的 Broadcom BCM2712 芯片,它和你电脑上的 Intel 或 AMD 处理器完全不同。这意味着你必须使用专门为aarch64编译的操作系统镜像,否则根本启动不了。

再者,ROS2(尤其是Humble Hawksbill及以后版本)官方明确要求运行在Ubuntu 22.04 LTS环境下。如果你用了 Ubuntu 20.04、Debian、Alpine 或其他发行版,会遇到软件源不匹配、依赖缺失、编译失败等一系列问题。

✅ 正确答案只有一个:Ubuntu Server 22.04 LTS for Raspberry Pi (ARM64)
❌ 错误选择包括:x86_64 镜像、非LTS版本、带桌面但资源占用高的系统、第三方魔改版

所以第一步,别图省事,一定要选对镜像。


刷系统用什么工具?官方推荐这款神器

推荐工具:Raspberry Pi Imager(必须用!)

这是树莓派基金会出的官方烧录工具,支持 Windows、macOS 和 Linux,界面简洁,最关键的是——它能自动过滤出适配你设备的镜像

比如你在树莓派5项目里选择了“Ubuntu Server”,Imager只会列出那些已经验证过能在RPi4/5上正常工作的ARM64版本,避免你误选了PC服务器专用的镜像。

它到底强在哪?
功能实际价值
一键下载官方镜像不用手动找链接,杜绝下载到假或损坏文件
自动识别设备兼容性只显示支持树莓派5的镜像,新手零容错
支持高级预配置可提前设置Wi-Fi、SSH、用户名密码
写入后自动校验确保数据完整,避免因SD卡问题导致启动失败

而且它的操作逻辑非常友好:

  1. 打开软件 → 选操作系统 → 选存储卡 → 点击“写入”
  2. 写入前点齿轮图标,进入“高级选项”做初始化配置

就这么简单。

⚠️ 提醒一句:千万不要用 Etcher 或手动dd命令去刷,除非你清楚自己在做什么。一旦选错设备路径(比如/dev/sdb其实是你硬盘),后果可能是整个主机系统崩溃。


如何提前配置“无显示器可用”的远程访问环境?

大多数人在做机器人开发时,并不会给树莓派接屏幕、键盘、鼠标。我们希望插上电、连上网,就能通过笔记本 SSH 登进去干活——这就是所谓的Headless Mode(无头模式)

好消息是:Raspberry Pi Imager 可以在刷卡阶段就帮你完成这些配置

在“高级选项”里设置以下几项:

  • Set hostname:比如设成ros-pi5,方便后期识别
  • Enable SSH:必开!否则无法远程登录
  • 推荐选择“Use password authentication”(便于初期调试)
  • 进阶用户可以用公钥方式更安全
  • Configure Wi-Fi
  • 输入你的路由器 SSID 和密码
  • 选择国家代码(如 CN),避免射频合规问题
  • Set username and password
  • 创建非 root 用户,例如robot
  • 设置强密码,不要用默认账户
  • Set locale settings
  • 时区选Asia/Shanghai
  • 键盘布局按需选择(一般美式即可)

这些信息会被写入 SD 卡的 boot 分区,在首次启动时由系统读取并应用。完成后相关文件会自动删除,安全性也有保障。

这样一来,你完全不需要外接任何外设,只要通电,树莓派就会自己连上Wi-Fi,拿到IP地址,等着你SSH上去。


如果不用图形工具,还能手动配置吗?

当然可以。虽然不推荐新手这么做,但了解底层原理有助于排错。

假设你已经将镜像写入SD卡,并将其插入电脑。通常你会看到一个名为boot的FAT32分区(挂载路径如/media/user/boot),在这个分区根目录下创建两个文件即可实现无头启动:

1. 启用SSH

touch /media/user/boot/ssh

只要存在这个空文件,系统启动时就会自动启用SSH服务。

2. 配置Wi-Fi

创建wpa_supplicant.conf文件:

cat > /media/user/boot/wpa_supplicant.conf << EOF ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 country=CN network={ ssid="你的Wi-Fi名称" psk="你的Wi-Fi密码" key_mgmt=WPA-PSK } EOF

保存后弹出SD卡,插入树莓派,通电等待几十秒到两分钟,就可以尝试连接了。

怎么找到它的IP地址?

方法有几种:

  • 查看路由器后台的DHCP客户端列表,找主机名为ros-pi5或类似名字的设备
  • 使用ARP扫描命令:
arp-scan --local | grep -i raspberry
  • 或者直接暴力ping(假设你是192.168.1.x网段):
for i in {1..254}; do ping -c1 192.168.1.$i & done

然后查活跃IP。

拿到IP后就可以SSH登录了:

ssh robot@192.168.1.xxx

首次登录可能提示确认指纹,输入yes继续。


常见翻车现场 & 解决方案

别以为刷个系统就没问题了,下面这几个坑我见过太多人踩过:

🔴 问题1:通电后绿灯都不亮,像是没启动

原因:SD卡质量差或接触不良
解决:换一张品牌卡(推荐三星EVO+、闪迪High Endurance),重新刷写。注意刷完后要“安全弹出”,别直接拔。

🟡 问题2:灯在闪,但SSH连不上

检查步骤
1. 是否启用了SSH?看看boot分区有没有ssh文件
2. Wi-Fi名称或密码是否输错了?特别注意大小写和特殊字符
3. 路由器是否开启了MAC地址过滤?临时关闭试试
4. 尝试改用网线直连,排除无线干扰

🟢 问题3:能连上,但系统频繁卡死或重启

典型症状:终端突然断开,ping不通
可能原因
- 供电不足:务必使用5V/5A的原装或PD协议电源
- 散热不够:加装散热片+风扇,否则CPU会降频甚至热关机

建议买一套官方散热套件,别省这点钱。


为什么推荐 Ubuntu Server 而不是桌面版?

你可能会想:“既然要开发,为什么不装个带桌面的Ubuntu Desktop?看得见多直观。”

但现实是:对于运行ROS2来说,图形界面是个累赘

对比一下两种系统:

项目Ubuntu ServerUbuntu Desktop
内存占用~300MB~1GB+
启动速度快(纯命令行)慢(加载GUI)
CPU开销极低持续消耗资源
ROS2支持完全一致完全一致
图形需求可通过VNC远程投屏本地显示为主

结论很清晰:先用Server打好基础,需要看界面时再通过VNC、NoMachine或Web桌面扩展,这才是专业做法。

你要记住:树莓派5是作为机器人边缘计算节点存在的,不是用来当迷你PC看电影的。


刷完系统之后该干什么?

恭喜你,现在已经成功迈出第一步。接下来就可以正式进入ROS2安装环节了。

但在此之前,请先执行几个必要操作:

# 更新包索引 sudo apt update # 升级现有软件(可选,但建议做) sudo apt upgrade -y # 安装基础工具(强烈建议) sudo apt install vim git curl wget net-tools htop -y

然后就可以添加ROS2官方源,准备安装Humble了:

# 添加GPG密钥 sudo apt install curl gnupg2 lsb-release curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /tmp/ros.asc sudo apt-key add /tmp/ros.asc # 添加软件源 echo "deb http://packages.ros.org/ros2/ubuntu $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/ros2.list # 更新并安装ROS2 Desktop sudo apt update sudo apt install ros-humble-desktop -y

后续还可以配置环境变量、安装colcon构建工具、初始化rosdep等,这些我们留到下一篇详细讲。


写在最后:基础打得牢,后面才不翻车

很多人急着想看到小车动起来、激光雷达转起来,于是跳过系统准备直接抄命令,结果越往后越难调,各种莫名其妙的问题冒出来。

其实归根结底,80%的“ROS2装不上”问题,都出在最开始的系统环境上

而这一切的起点,就是一张正确刷写的SD卡。

所以请记住:

  • Raspberry Pi Imager刷卡
  • Ubuntu Server 22.04 LTS ARM64
  • 提前配置SSH + Wi-Fi + 用户名密码
  • 使用高质量SD卡 + 强电源 + 散热方案

做到这几点,你的树莓派5就已经准备好迎接ROS2了。

下一步,我们可以聊聊如何在树莓派上交叉编译ROS2包、优化实时性能、对接传感器驱动……但那都是后话。

现在,先把这张卡刷好,让机器“活”起来再说。

如果你在刷卡或连接过程中遇到了其他问题,欢迎留言交流,我们一起排查。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/3/16 3:16:55

基于python的爬虫的贵州菜价可视化系统(源码+文档)

项目简介爬虫的贵州菜价可视化系统实现了以下功能&#xff1a;此次的系统模块设计中&#xff0c;首先需要设计的是登录的模块。该系统需要进行登录才能够实现数据的爬取和分析&#xff0c;所以系统的第一个模块设计为登录模块&#xff0c;在登录模块中&#xff0c;需要用到pyth…

作者头像 李华
网站建设 2026/3/19 14:37:10

PaddlePaddle镜像如何实现多阶段流水线训练?Stage-Wise优化

PaddlePaddle镜像如何实现多阶段流水线训练&#xff1f;Stage-Wise优化 在大模型时代&#xff0c;一个1750亿参数的模型动辄需要数百张GPU才能完成一次训练。单卡显存早已无法容纳完整模型&#xff0c;而传统数据并行又受限于通信开销和扩展性瓶颈。面对这一挑战&#xff0c;流…

作者头像 李华
网站建设 2026/3/21 6:05:55

WPS-Zotero插件实战指南:打造高效学术写作工作流

想要在Linux平台上实现专业级的文献管理体验吗&#xff1f;WPS-Zotero插件正是你需要的解决方案。这款强大的工具能够将WPS Writer与Zotero文献管理软件无缝集成&#xff0c;为科研工作者提供跨平台的完整学术写作支持。通过创新的本地连接架构&#xff0c;它完美解决了跨平台访…

作者头像 李华
网站建设 2026/3/21 10:27:48

DouyinLiveRecorder终极指南:多平台直播录制解决方案

还在为错过精彩直播内容而烦恼吗&#xff1f;DouyinLiveRecorder作为一款开源多平台直播录制工具&#xff0c;能够帮助您轻松实现抖音、快手、B站等60平台的自动化录制功能&#xff0c;让您不再错过任何重要时刻。 【免费下载链接】DouyinLiveRecorder 项目地址: https://gi…

作者头像 李华
网站建设 2026/3/20 3:29:22

PaddlePaddle镜像中的模型交付标准与验收规范

PaddlePaddle镜像中的模型交付标准与验收规范 在AI项目从实验室走向生产线的过程中&#xff0c;一个常被忽视但极其关键的环节是&#xff1a;如何让训练好的模型真正“跑起来”&#xff1f; 这听起来简单&#xff0c;但在实际落地中却充满挑战。我们经常遇到这样的场景——算法…

作者头像 李华
网站建设 2026/3/21 19:15:23

5步完美安装OpenWrt Argon主题:新手也能轻松搞定路由器美化

5步完美安装OpenWrt Argon主题&#xff1a;新手也能轻松搞定路由器美化 【免费下载链接】luci-theme-argon Argon is a clean and tidy OpenWrt LuCI theme that allows users to customize their login interface with images or videos. It also supports automatic and manu…

作者头像 李华