如何在Windows Docker中运行frdmrobotics/playground内的ROS1/ROS2并通过VcXsrv连接

一、镜像拉取错误的排查方案 #

• 核对拉取命令：确保执行的是正确命令 docker pull frdmrobotics/playground，检查是否存在拼写错误（比如镜像名大小写、单词拼写）。
• 网络与镜像加速配置：如果网络不稳定或访问Docker Hub受限，可配置Docker国内镜像加速。修改Windows下Docker daemon配置文件（路径一般为C:\ProgramData\Docker\config\daemon.json），添加如下内容后重启Docker服务：

  {
    "registry-mirrors": ["https://<你的镜像加速地址>"]
  }
  

• 确认镜像可用性：若命令无误仍拉取失败，需核实该镜像是否在Docker Hub上存在，或是否已被作者移除、改名。可手动搜索镜像名确认状态。
• 指定具体镜像标签：默认拉取latest标签，若该标签不存在，尝试指定已知存在的标签，比如docker pull frdmrobotics/playground:<标签名>。

二、Docker容器连接VcXsrv的步骤 #

1. 启动VcXsrv并配置权限
   打开VcXsrv，按向导选择窗口模式（单窗口或多窗口均可），最后一步必须勾选Disable access control（否则容器无法连接X服务），完成启动。

2. 获取本地IPv4地址
   在Windows命令行执行ipconfig，找到当前网络（以太网/WLAN）的IPv4地址，比如192.168.3.105。

3. 运行容器并挂载X11服务
   执行以下命令启动容器，替换<你的本地IP>为上一步获取的地址：

   docker run -it --rm -e DISPLAY=<你的本地IP>:0.0 -v /tmp/.X11-unix:/tmp/.X11-unix frdmrobotics/playground
   

   参数说明：

   • -e DISPLAY：告知容器X服务器的地址，:0.0是VcXsrv默认的显示端口。
   • -v /tmp/.X11-unix：挂载本地X11套接字目录，让容器能够访问VcXsrv服务。

4. 验证GUI连接
   进入容器后，运行一个简单的GUI程序测试（比如xeyes，若容器内置该工具），如果VcXsrv窗口中能正常显示程序界面，说明连接成功。

内容的提问来源于stack exchange，提问作者Alexander Pollek