如何在ubuntu24中,使用docker 运行ros2 humble版本

在 Ubuntu 24.04 中使用 Docker 运行 ROS 2 Humble 是最稳妥的方案,能完美绕过系统版本不兼容的问题。这里为你整理了一份"开箱即用"的配置流程。

  1. 安装并配置 Docker

如果你的系统尚未安装 Docker,执行以下命令:

bash

复制

安装 Docker

sudo apt update

sudo apt install docker.io

将当前用户加入 docker 组(避免每次输 sudo)

sudo usermod -aG docker $USER

重新登录或重启终端生效

newgrp docker

验证安装:docker --version

  1. 拉取 ROS 2 Humble 镜像

直接拉取官方预构建的桌面版镜像(内含 RViz、Gazebo 等 GUI 工具):

bash

复制

docker pull osrf/ros:humble-desktop

若需极简版(仅命令行),可改用 humble-ros-base。

  1. 启动容器(完整开发配置)

为了在容器内进行开发并显示图形界面(如 Rviz),使用以下命令启动:

bash

复制

允许 Docker 访问 X11 图形服务

xhost +local:docker

启动 Humble 容器(推荐配置)

docker run -it --rm

--name ros2_humble

--network=host \ # 使用主机网络,方便与宿主机通信

--env="DISPLAY=KaTeX parse error: Expected 'EOF', got '#' at position 17: ...ISPLAY" \ #̲ 传递显示变量 --env...HOME/ros2_ws:/root/ros2_ws" \ # 挂载工作空间(宿主机:容器)

osrf/ros:humble-desktop

bash

  1. 容器内验证环境

进入容器后,执行以下命令测试环境:

bash

复制

加载环境(官方镜像通常已自动加载,手动执行更保险)

source /opt/ros/humble/setup.bash

验证版本

ros2 --version # 应输出: ros2 version humble

测试小乌龟(需图形支持)

ros2 run turtlesim turtlesim_node

如果能看到小乌龟窗口,说明 GUI 和 ROS 环境均配置成功 。

  1. 开发工作流建议

代码编辑:在宿主机(Ubuntu 24.04)上用 VSCode 编辑 ~/ros2_ws下的代码。

编译运行:在 Docker 容器内执行 colcon build和 ros2 run。

多终端:如需新开终端进入正在运行的容器,使用:

bash

复制

docker exec -it ros2_humble bash

⚠️ 常见问题排查

GUI 无法显示:确保宿主机已安装 X11,并正确执行了 xhost +local:docker。

网络不通:上述命令使用了 --network=host,容器与宿主机网络互通。若使用 bridge 模式,需注意端口映射。

性能优化:如需 GPU 加速(如运行 Gazebo),需额外添加 --gpus all参数(需提前安装 NVIDIA Container Toolkit)。

此方案将 Humble 环境完全隔离在容器中,既利用了 Ubuntu 24.04 的新特性,又保证了 ROS 2 项目的稳定运行

相关推荐
乘云数字DATABUFF2 天前
5分钟部署开源APM Databuff:OpenTelemetry全链路追踪入门实战
运维·后端
Patrick_Wilson2 天前
从「改个端口」到 502:Next.js on k8s 的容器端口、Service 映射与 env 覆盖
docker·kubernetes·next.js
Suroy3 天前
DockerView-Go:用 Go 写一个终端 Docker 监控工具,顺便做了个 Web 仪表盘
docker
云恒要逆袭3 天前
运行你的第一个Docker容器
后端·docker·容器
荣--4 天前
一键部署不是为了省时间 —— 它是把"买来的 PaaS"变成"自己的平台"的拐点
运维·zabbix·工程化·一键部署·平台化·边界设计
江华森4 天前
动手实战学 Docker — 从零到集群编排完全指南
运维
宋均浩4 天前
# Docker 镜像瘦身实战:从 1.2G 到 80MB 的五个优化步骤
ci/cd·docker
Avan_菜菜4 天前
FRP 内网穿透完整实战:从 HTTP 映射到 HTTPS 自签代理
运维·nginx·https
程序员老赵4 天前
10 分钟部署 OpenCode:Docker 一键安装,浏览器打开就能用 AI 写代码(附完整命令与排错)
docker·容器·ai编程
WangMingHua1115 天前
LM Studio Docker 部署——本地大模型一键启动
docker