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 + execconda 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 命令了。