ROS 2 Jazzy 官方只给 Ubuntu 24.04 发二进制包,而黑豹 X2 上跑的是 Armbian(Debian 系)。apt 这条官方大路从起点就是断的。 但断路不等于没路——这篇记录两条实测可行的路线:容器和 RoboStack, 以及最后在容器里把串口雷达节点编译上车的那一段。
01为什么 apt 装不了
ROS 2 的 apt 仓库按「发行版代号」发包:Jazzy 对应 noble(Ubuntu 24.04),
Humble 对应 jammy。Armbian 26.x 是 trixie(Debian 13)、
旧镜像下是 bookworm(Debian 12),都进不了 Jazzy 的源列表——
硬加源只会在 apt update 时报 404。
这是官方支持矩阵的边界,不是玄学。绕开它的思路只有两种:
要么把 Ubuntu 环境整个搬进来(容器),要么用不依赖系统发行版的包管理器(conda)。
02路线 A:Podman 容器(推荐,当前主力)
把 Ubuntu 24.04 塞进容器,宿主系统是什么发行版就无所谓了。 完整复现命令:
podman run -dit --name ros2 --network host --privileged \
docker.io/library/ubuntu:24.04 sleep infinity
# 进入后装 ROS 2 Jazzy(官方 noble 源流程),并写进 /root/.bashrc:
echo "source /opt/ros/jazzy/setup.bash" >> /root/.bashrc
podman start ros2 # 容器设了 sleep infinity,start 后保持后台 podman exec -it ros2 bash # 进入,.bashrc 自动 source
两个参数不是可选项:--network host 让容器直接用宿主机网络栈,
DDS 才能绑定宿主的真实 IP(bridge 下的 10.88.x.x 会导致
does not match an available interface);
--privileged 是为了串口和 USB 设备能透传进来。
容器里编译自己的包,和原生环境没有任何区别:
cd ~/ros2_ws
source /opt/ros/jazzy/setup.bash
colcon build --packages-select robot_host
source install/local_setup.bash
ros2 run robot_host x1_radar_node --ros-args -p port:=/dev/ttyUSB0
[INFO] [x1_radar_node]: x1_radar_node 启动:port=/dev/ttyUSB0 baud=115200 mirror=True → /robot/scan
[INFO] [x1_radar_node]: [diag] 帧 260/s 圈 4/s 重同步 13 | 队列 0 scan_time 0.190s
[INFO] [x1_radar_node]: [diag] 帧 259/s 圈 5/s 重同步 0 | 队列 0 scan_time 0.192s
diag 行是这个节点健康度的仪表盘:帧 260/s 稳定、重同步归零、队列不积压,
说明串口读取线程和扫描组包都工作正常。scan_time 0.190s 折合约 5 Hz 的
发布频率,对室内建图够用。
03路线 B:RoboStack(conda)
不想用容器、或者想让 ROS 2 和其他 Python 项目共存时,RoboStack 是唯一解—— 它把 ROS 2 打成了 conda 包,跨发行版安装:
wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-aarch64.sh
bash Miniforge3-Linux-aarch64.sh
source ~/.bashrc
conda create -n ros2-jazzy -c robostack-jazzy -c conda-forge ros-jazzy-ros-base
conda activate ros2-jazzy
装完的验证方式有讲究。别用 ros2 --version 下结论——
它在某些环境下的输出和预期不符,容易误判。可靠的验证组合是:
echo $ROS_DISTRO # 应输出 jazzy
ros2 --help # 命令存在且输出帮助
ros2 topic list # 应输出空列表(不报错)
ros2 doctor # 系统级体检,逐项核对警告
RoboStack 的代价也要心里有数:环境激活制(忘了 conda activate 就是一堆
command not found)、包完整度不如 apt、GUI 工具(RViz)在 aarch64 上偶尔缺依赖。
我的用法是——容器当主力跑实车节点,conda 当备胎留给轻量实验。
04两条路怎么选
| 路线 A:Podman 容器 | 路线 B:RoboStack conda | |
|---|---|---|
| 与官方环境一致性 | 高(就是 Ubuntu 24.04) | 中(conda 重打包) |
| 网络/串口透传 | 需 --network host + --privileged | 天然使用宿主设备,无隔离层 |
| 与宿主 Python 共存 | 完全隔离,互不影响 | 按环境隔离,激活制 |
| 启动方式 | podman start + exec | conda activate |
| 适合 | 实车节点、DDS 跨机通信、上线 | 轻量实验、与数据科学栈混用 |
05顺带:给 Armbian 装上 fastfetch
排查设备状态时有个顺手的系统信息工具很重要。fastfetch 不在 Debian 官方源里, 可以走 openSUSE 社区仓库:
echo 'deb http://download.opensuse.org/repositories/home:/tangerine:/deb12-xfce4.18/Debian_12/ /' | tee /etc/apt/sources.list.d/home:tangerine:deb12-xfce4.18.list
curl -fsSL https://download.opensuse.org/repositories/home:tangerine:deb12-xfce4.18/Debian_12/Release.key | gpg --dearmor | tee /etc/apt/trusted.gpg.d/home_tangerine_deb12-xfce4.18.gpg > /dev/null
apt update && apt install -y fastfetch
装完 fastfetch 一屏拿到 OS / 内核 / CPU / 内存 / IP。
它替 neofetch 的原因很简单:后者已经停止维护,
而且在这种小内存设备上 fastfetch 快得多。
- 关于本文
- 整理自 2026 年 10 月在黑豹 X2(Armbian trixie)上的环境搭建记录。 RoboStack 的 channel 名与 ROS 2 版本号绑定(robostack-jazzy), 换发行版时 channel 也要跟着换。
- 2026.10.10 整理
- 两条路线先后都走过,最终稳定在「容器为主」。 决定性因素其实是第三篇里那个 DDS 问题:跨机通信要求容器用 host 网络, 而这一步做完之后,容器路线和原生环境的差距就只剩下两条 start 命令了。
留言
正在载入留言…