Docker系列（五）：ROS容器化三叉戟 --- 从X11、Wayland到DockerFile实战全解析

已于 2025-05-28 14:26:09 修改
阅读量1.4k 收藏 26
点赞数 40
分类专栏： # 1.2 Docker系列 文章标签： docker linux ROS1/ROS2 dockerfile X11 Wayland
于 2025-05-28 09:20:18 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_43731521/article/details/148261060
版权
#『技术文档』写作方法征文挑战赛#

引言

随着机器人操作系统（ROS）在机器人领域的广泛应用，容器化技术成为提高开发效率和简化部署的关键。在多种容器化方案中，基于X11、Wayland和标准Dockerfile的ROS容器化方式各有特点，它们在容器内安装ROS1和ROS2的实现方式和适用场景上存在显著差异。

方案一通过X11协议实现ROS容器的图形界面支持。X11在容器中工作时，通过挂载宿主机的X11套接字并设置环境变量，使容器内的ROS应用能够访问宿主机的图形界面。ROS1的X11容器化实现相对成熟，但ROS2在X11环境下的性能可能受到网络传输开销的影响。

方案二采用Wayland协议代替传统X11，Wayland以其更简洁的架构和更高的图形传输效率著称，减少了中间环节，降低了CPU和内存开销。但Wayland在容器中的使用还处于发展阶段，ROS的Wayland适配需要额外的步骤和工具支持，且跨平台兼容性较差。

方案三则推荐使用标准Dockerfile构建ROS容器。通过Dockerfile，开发者能够在容器内精确配置ROS1和ROS2的运行环境，实现高效的资源管理和安全性控制。Dockerfile的灵活性允许开发者根据需求定制镜像，且Docker的跨平台支持使得容器能够在不同操作系统上无缝运行。

因此，这三种方案分别在图形界面支持、性能、跨平台兼容性、安全性和开发部署便利性上各有优劣。开发者应根据具体的项目需求和技术背景，选择最适合的容器化方案来安装和运行ROS1及ROS2。

最后，如果大家喜欢我的创作风格，请大家多多关注up主，你们的支持就是我创作最大的动力！如果各位观众老爷觉得我哪些地方需要改进，请一定在评论区告诉我，马上改！在此感谢大家了。

各位观众老爷，本文通俗易懂，快速熟悉Docker，收藏本文，关注up不迷路，后续将持续分享Docker纯干货（请观众老爷放心，绝对又干又通俗易懂）。请多多关注、收藏、评论，评论区等你～～～


文章目录


正 文

总的来是，创建基于X11容器比较适合在虚拟机中，不推荐双系统使用X11的容器。我写第一章和第二章只是为了让大家能对创建容器的方式有一个更加清晰的认识，还是推荐各位观众老爷使用dockerfile创建容器。

方案一：基于X11的ROS容器化


（一）X11在容器中的工作原理


X11工作原理

  • X11（X Window System，也叫 X）在容器中的工作原理主要涉及容器对 X11 协议的处理以及与宿主机或其他 X 服务器的通信等方面，以下是详细解释：
    基本概念
  • X11 协议 ：是一种用于在计算机之间进行图形用户界面交互的网络协议。它允许运行在一台计算机上的图形应用程序在另一台计算机上显示图形界面，并接收用户的输入，如键盘和鼠标操作。

X11在容器中的工作原理主要依赖于以下几种方式：

  1. 网络通信

    • 端口映射 ：容器通过端口映射与宿主机的X服务器通信。在宿主机上，X服务器监听特定端口（如6000号），运行容器时，通过在容器和宿主机之间建立端口映射，把容器内的X11应用程序请求转发到宿主机上的X服务器。

    • 共享网络命名空间 ：让容器与宿主机共享网络命名空间，容器就能直接访问宿主机网络接口和端口，包括X服务器监听端口，实现通信。

  2. 文件系统挂载

    • 挂载宿主机X权限文件目录 ：X11协议用权限文件控制X服务器访问，通常在宿主机/tmp/.X11-unix目录。容器运行时挂载该目录，使容器内X11应用程序能访问权限文件，获得访问权限，同时容器内还需设置正确环境变量，如DISPLAY变量，告诉X11应用程序图形界面输出位置。

    • 设置环境变量 ：除了挂载目录，需在容器内设置正确环境变量，像DISPLAY变量，其值为宿主机地址和相应显示编号，让X11应用程序知道将图形界面输出到哪。

  3. X服务器转发与代理

    • X11转发 ：部分容器运行环境或远程连接工具支持X11转发功能，容器内X11应用程序图形界面数据经加密通道（如SSH隧道）转发到本地或远程X服务器上显示，适用于远程访问容器中图形应用程序，确保数据安全传输。

    • 代理服务器 ：在容器和X服务器间设代理服务器，代理服务器可处理和转发X11协议数据，如数据压缩、加密或访问控制等，容器内X11应用程序请求先发给代理服务器，再由代理服务器转发到实际X服务器，把服务器响应返回容器内应用程序。

（二）ROS1的X11容器化实现

进入Ubuntu系统后，可以使用X11构建和运行容器。以下是具体的步骤：

  1. 检查是否安装X11服务器

Ubuntu系统通常已经安装了X11服务器，可以通过以下命令检查是否安装：

echo $DISPLAY

如果输出类似于 :0 或 :1 ，则表示X11服务器已运行。

  1. 安装Docker

这一部分在这里就不再过多赘述， 之前的文章已经讲过。请参照 Docker系列（一）：从依赖冲突到标准化交付！容器原理解析×SLAM跨平台实战×10分钟极速部署指南 。

  1. 拉取ROS1镜像

运行以下命令拉取 ROS1 镜像，此处以 ROS1 Noetic 为例：

docker pull osrf/ros:noetic-desktop-full

如下图所示，出现这样的结果，表示拉取成功！

在这里插入图片描述

注释： 这里很多观众老爷经常反映无法拉取，原因无外乎以下几点。

  1. 验证ROS1镜像（可选）

查看TAG标签是否存在“noetic-desktop-full”，若存在，则证明已拉取成功！

docker images
  1. 创建基于X11的容器（直接创建方式）

使用以下命令创建容器：

docker run -it --name ros1 \
--env="DISPLAY" --env="QT_X11_NO_MITSHM=1" \
--volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" \
--volume="$HOME/.Xauthority:/root/.Xauthority:rw" \
--env="XAUTHORITY=/root/.Xauthority" \
osrf/ros:noetic-desktop-full \
bash -c "apt-get update && apt-get install -y libxcb* && rqt"

使用下面代码可以进行验证，存在 ros1_container 容器。

docker ps -a

也可以使用如下办法进行创建，虽然不会进行报错，但只能进入到容器中重新进行下载安装ros1。

docker run -it --name ros1_container ubuntu:24.04
  1. 启动并进入容器
# 启动容器
docker start ros1_container

# 进入容器
docker exec -it ros1 /bin/bash
  1. 配置ROS1环境

在容器中运行以下命令，配置ROS1环境变量：

echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc
source ~/.bashrc
  1. 运行ROS1程序
# 进入容器后
roscore

（三）ROS2的X11容器化实现

  1. 前面安装方式相同

  2. 拉取ROS2镜像

docker pull osrf/ros:humble-desktop-full
  1. 创建容器
docker run -it  \
	--name ros2-humble   \
	--env="DISPLAY"   \
	--env="QT_X11_NO_MITSHM=1"    \
	--volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" \
	--volume="/home/zys/SLAM/algo/nav:/home/zys/SLAM/algo/nav"  \
	osrf/ros:humble-desktop-full  \
	rqt
  1. 后面操作均一致，记得修改配置环境变量中的ROS版本



方案二：基于Wayland的ROS容器化


（一）Wayland与X11的架构差异

  1. 架构设计

  • X11 ：经典客户端 - 服务器架构，显示服务器管理输入设备和屏幕输出，客户端应用通过网络与显示服务器通信，支持网络透明显示。

  • Wayland ：显示服务器直接与硬件通信，客户端应用通过 Wayland 协议与显示服务器交互，中间无 X 服务器。

  1. 通信机制

  • X11 ：应用与 X 服务器通过 X 协议通信，消息传递复杂。

  • Wayland ：客户端与显示服务器直接交互，通信基于简洁的 Wayland 协议。

  1. 性能和效率

  • X11 ：复杂架构和历史遗留问题，高分辨率和复杂图形场景下性能不佳。

  • Wayland ：简洁架构和硬件优化，性能出色，图形显示流畅。

  1. 兼容性

  • X11 ：应用生态庞大，兼容性好。

  • Wayland ：兼容性仍在逐步推广，在主流桌面环境已支持，但覆盖范围不及 X11。

  1. 组件构成

  • X11 ：由 X 服务器、X 客户端、窗口管理器等组成。

  • Wayland ：由 Wayland 协议、合成器、客户端组成，合成器管理窗口和输入事件。

（二）ROS的Wayland适配步骤

  1. 拉取镜像

这里以ROS2为例

sudo docker pull osrf/ros:humble-desktop-full
  1. 创建容器
docker run -it --name ros2 \
           -v SLAM-vol:/root/SLAM \
           -e XDG_RUNTIME_DIR=/tmp \
           -e WAYLAND_DISPLAY=$WAYLAND_DISPLAY \
           -v $XDG_RUNTIME_DIR/$WAYLAND_DISPLAY:/tmp/$WAYLAND_DISPLAY \
           -e QT_QPA_PLATFORM=wayland \
           osrf/ros:humble-desktop-full
  1. 启动并进入容器
# 启动容器
docker start ros2

# 进入容器
docker exec -it ros2 /bin/bash
  1. 配置环境
echo "source /ros_entrypoint.sh" >> ~/.bashrc
source ~/.bashrc
  1. 验证ROS2
ros2
  1. 启动小乌龟
apt install qtwayland5

ros2 run turtlesim turtlesim_node


方案三：标准Dockerfile构建ROS容器（强烈推荐）


（一）准备DockerFile（以ROS1为例）

之前我们已经在前文讲解过DockerFile了，请参考 Docker系列（三）：深度剖析Dockerfile与图形化容器实战 — 3种容器构建方法对比与性能调优 。

  1. 建立DockerFile

DockerFile可选择建立在任意位置，我选择建在主目录

mkdir ros_docker
cd ~/ros_docker
nano DockerFile

注释： 对这部分内容不熟悉的友友们，可以翻阅我之前的文章。

  1. 编写文档
# 使用Ubuntu 20.04作为基础镜像
FROM ubuntu:20.04

# 防止在非交互模式下的TZ数据错误
ARG DEBIAN_FRONTEND=noninteractive

# 更新并安装基本工具
RUN apt-get update && apt-get install -y \
    lsb-release \
    gnupg2 \
    curl \
    && rm -rf /var/lib/apt/lists/*

# 添加ROS Noetic的源
RUN sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-noetic.list'

# 添加ROS key
RUN curl -sSL 'http://packages.ros.org/ros.key' | apt-key add -

# 安装ROS Noetic Desktop-Full
RUN apt-get update && apt-get install -y \
    ros-noetic-desktop-full \
    && rm -rf /var/lib/apt/lists/*

# 初始化rosdep
RUN apt-get update && apt-get install -y \
    python3-rosdep \
    && rm -rf /var/lib/apt/lists/* \
    && rosdep init && rosdep update

# 设置环境变量
RUN echo "source /opt/ros/noetic/setup.bash" >> /etc/bash.bashrc

# 安装其他常用工具
RUN apt-get update && apt-get install -y \
    python3-rosinstall \
    python3-rosinstall-generator \
    python3-wstool \
    build-essential \
    && rm -rf /var/lib/apt/lists/*

# 设置默认工作目录
WORKDIR /root

# 运行bash
CMD ["bash"]

完成后，保存退出。

（二）镜像并运行容器

  1. 构建DockerFile镜像

注释： 一定要在DockerFile文档的路径下进行这一步操作！并且这一步要等好长时间，耐心等待即可。

docker build -t ros_noetic .
  1. 运行容器
docker run -it --name ros1_container ros_noetic
  1. 验证
source /opt/ros/noetic/setup.bash
roscore


三种方案对比分析


（一）性能开销（CPU/GPU/内存）


方案性能开销分析
X11X11 协议会增加一定的网络传输开销，图形界面数据需要在宿主机和容器之间传输，可能导致较高的 CPU 和带宽占用。GPU 直通或共享可改善图形性能，但配置复杂。
WaylandWayland 协议可减少中间环节，提高图形传输效率，降低 CPU 和内存开销。但在容器技术中使用 Wayland 的经验和工具支持较少，性能表现受应用支持程度影响。
DockerfileDockerfile 本身不直接影响性能开销，但通过优化镜像和合理配置资源限制，可以控制容器的 CPU、GPU 和内存使用。在不涉及图形界面时，性能开销主要来自容器的业务负载。

（二）跨平台兼容性（Linux/Windows）


方案跨平台兼容性分析
X11原生支持 Linux ，在 Windows 上需额外软件支持（如 Xming 或 VcXsrv），跨平台使用时兼容性和配置复杂度较高，部分 Linux 特定功能在 Windows 上可能受限。
Wayland目前主要用于 Linux 系统，Windows 上的 Wayland 支持处于实验阶段，缺乏成熟工具和广泛的软件支持，跨平台兼容性较差。
DockerfileDocker Desktop 支持 Windows 和 Linux，使得 Dockerfile 定义的容器在这两个系统上都可运行。但需注意架构差异和文件路径等系统特定配置。

（三）安全性与权限管理差异


方案安全性与权限管理分析
X11直接挂载 X11 套接字存在安全风险，可能导致权限提升和访问控制绕过。xhost 命令管理访问权限的方式较为粗糙，不够灵活。
WaylandWayland 设计提升了安全性，减少了攻击面，但在容器场景中，Wayland socket 的挂载和访问控制仍需谨慎处理，相关安全机制仍在发展中。
Dockerfile可通过定制化镜像和安装安全工具增强安全性，利用 Docker 的权限控制机制（如用户命名空间）实现更细粒度的权限管理，降低容器与宿主机的耦合度。

（四）开发与部署的便利性


方案开发与部署便利性分析
X11图形界面应用程序开发便利，但容器启动时需要额外参数配置，且在不同系统上的配置复杂度高，可能影响部署效率。
Wayland开发便利性取决于应用支持程度，容器中使用 Wayland 的文档和工具匮乏，部署时需处理协议兼容性和权限问题。
Dockerfile开发阶段可定制环境，通过构建参数和多阶段构建优化流程；部署时，Docker 的镜像分发机制简化了跨环境部署，且容器可作为独立单元进行编排和扩展。


结 束 语

能够看到这里的观众老爷，无疑是对up的最大肯定和支持，在此恳求各位观众老爷能够多多点赞、收藏和关注。在这个合集中，未来将持续给大家分享关于Docker的多种常见开发实用操作。未来也将继续分享Docker、conda、ROS等等各种实用干货。感谢大家支持！


往期回顾 — 往期专栏 和 系列博文


往期专栏： Ubuntu系列

本期专栏： Docker系列

Docker系列（一）：从依赖冲突到标准化交付！容器原理解析×SLAM跨平台实战×10分钟极速部署指南

Docker系列（二）：从零构建容器环境｜服务自启配置×镜像源加速×免sudo提权×避坑手册

Docker系列（三）：深度剖析Dockerfile与图形化容器实战 — 3种容器构建方法对比与性能调优

Docker系列（四）：容器操作全栈技术指南 — 从入门到生产级管控
ROS从入门到精通4-2：Docker安装ROS、可视化仿真与终端复用
FRIGIDWINTER的博客
03-07 5516
本文详细介绍如何在Docker中安装ROS，并进行Rviz、Gazebo等可视化仿真。为了更好地与Docker配合，本文还介绍了终端复用工具Tmux，并总结了其常用命令
Docker（十五）：Docker-compose 实现服务弹性伸缩
✨ 欢迎来到【Seal ^_^ 的CSDN博客】！✨
03-24 4万+
🟢 Docker（十五）：Docker-compose 实现服务弹性伸缩
【Docker系列】跨平台 Docker 镜像构建：深入理解`--platform`参数
CSDN站内信: https://i.csdn.net/#/msg/chat/qyj19920704
06-09 3万+
Docker 从 18.09 版本开始支持多平台镜像构建。--platform参数允许用户指定构建过程应该生成的目标操作系统和架构。例如，指定生成一个在 64 位 Linux 操作系统上运行的镜像。
在 Docker容器中安装 ROS2-Humble 并使用 rviz 进行图形化显示
qq_39779233的博客
10-13 2823
在 Docker容器中安装 ROS-Humble 并使用 rviz 进行图形化显示
使用Docker安装ROS2 (ros-humble) 并开启对Wayland的支持
sinat_21946723的博客
10-21 3668
本教程介绍如何在Docker中安装ros-humble并开启对wayland的支持
【容器化】Docker-compose教程（安装，使用， 快速入门）
热门推荐
康师傅没有眼泪
06-26 9万+
目录 一、Docker-Compose概述二、安装docker-compose1.从github上下载docker-compose二进制文件安装2.pip安装三、Docker-compose实战1.MySQL示例1.1 MySQL run1.2 mysql-compose.yml2.CDH单机2.1系统镜像DockerFile2.2CDH镜像DockerFile 2.3镜像构建2.4桥接网络创建2.5CDH-yml2.6CDH 启动Compose有2个重要的概念： docker compos
Dockerfile和Docker-compose
志当存高远
03-26 3575
Dockerfile和Docker Compose是用于构建和管理 Docker 容器的两个工具，但它们的作用和使用方式不同。
【容器化】docker和docker-compose/dockerfile和docker-compose.yml
在这里你大概率会有所收获，欢迎指错||纠正||建议||水评+点赞&&评论&&关注&&转发
06-26 2202
【容器化】docker和docker-compose/dockerfile和docker-compose.yml
Docker（七）：Docker基础总结篇--超详细
✨ 欢迎来到【Seal ^_^ 的CSDN博客】！✨
09-07 5万+
🟢 Docker（七）：Docker基础总结篇[docker3要素、docker安装配置、容器使用、镜像管理发布]
Docker：容器化运行xxl-job-admin
東辰的博客
10-25 5790
一、背景 今天想把xxl-job-admin跑在容器中，然后在部署的过程中踩了一些坑，特此记录 因为xxl-job-admin需要连接数据库，而我本机的mysql是部署在docker容器中，我以为只要将xxl-job-admin按正常容器化部署就可以访问了，结果在实施过程中遇到了一些坑，如果你在其中一个容器访问另一个容器中的mysql遇到一些报错的情况，你可以参考我这篇文章，看有没有参考性 如果对mysql容器化部署还不熟的同学请先看我这篇文章 我部署在容器中的mysql访问地址为：localhost:33
jetson容器：适用于NVIDIA Jetson和JetPack-L4T的机器学习容器
02-03
Jetson和JetPack的机器学习容器 ...要在docker build操作期间启用对CUDA编译器（nvcc）的访问，请在尝试构建容器之前，将"default-runtime": "nvidia"到/etc/docker/daemon.json配置文件中： { " runtimes
Docker 挂载卷并保存为容器
ZPC8210的博客
05-27 646
docker commit 是一个非常方便的工具，可以快速将运行中的容器保存为一个新的镜像。如果你只是需要快速保存当前容器的状态，docker commit 是一个不错的选择。docker commit 创建的镜像仅包含当前容器的状态，不包含构建过程中的上下文信息（如 Dockerfile 中的指令）。在 Docker 中，你可以将运行中的容器保存为一个新的镜像，以便后续可以基于这个镜像快速创建新的容器。使用 docker commit 创建的镜像会包含容器的所有更改，包括文件系统的变化和运行时的状态。
SpringCloud——Docker
最新发布
l_tian_tian_的博客
05-30 357
设置镜像名称，Docker会根据这个名字搜索并下载镜像，REPOSITORY:TAG，例如mysql:8.0，其中REPOSITORY可以理解为镜像名，TAG是版本号。2、容器内端口往往是由容器内的进程决定，例如MySQL进程默认端口是3306，因此容器内端口一定是3306；而宿主机端口则可以任意指定，一般与容器内保持一致。但是可以将宿主机端口映射容器内到端口，当访问宿主机指定端口时，就是在访问容器内的端口了。配置容器内进程运行时的一些参数，-e KEY=VALUE，KEY和VALUE都由容器内进程决定。
Docker基础 -- Ubuntu 22.04 AArch64 交叉编译 Docker 镜像构建指南
sz66cm 学习随笔
05-26 477
本文档详细介绍了在企业内网环境下构建Ubuntu 22.04 AArch64交叉编译Docker镜像的全过程。主要内容包括：1）使用清华TUNA镜像源配置；2）分阶段构建Dockerfile的详细步骤（包含HTTPS/HTTP两种方案）；3）镜像构建与使用方法；4）常见错误排查表；5）最佳实践建议（如使用BuildKit缓存、镜像瘦身等）。该方案解决了ARM64固件和内核构建的环境需求，特别适用于需要代理的企业开发场景。文档提供了完整的配置文件和命令示例，便于团队快速复现实践。
Docker 本地化部署FireCrawl
总结复盘，才能不迷失自己！
05-29 276
（1）Step1：已经安装Docker 和 Docker Compose。（3）Step3：复制.env.example 文件并重命名为 .env。（2）Step2：克隆 FireCrawl 项目到本地指定目录下。（4）Step4：docker 运行 firecrawl。将图中标注红的改为false保存。
docker docker-ce docker.io
wanghan0526的博客
05-28 288
【代码】Ubuntu安装卸载老的版本$ sudo apt-get remove docker docker-engine docker.io containerd runc 11更新。
长安链起链调用合约时docker ps没有容器的原因
这里面的代码全是错的
05-29 239
在调用这个命令的时候，发现并没有出现官方预期的合约容器，这是因为我们在起链的时候没有选择用docker的虚拟环境，实际上这不影响后续的调用，如果想要达到官方的效果那么你只需要在起链的时候输入yes即可，如图三所示。
docker环境搭建与常用指令
m0_74186706的博客
05-27 1011
根据官方的定义，Docker是以Docker容器为资源分割和调度的基本单位，封装整个软件运行时环境，为 开发者和系统管理员设计的，用于构建、发布和运行分布式应用的平台。​。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值