POSIM v1.0.1Platform for Ocean Simulation · 文档
文档菜单
POSIM / 开始使用

Windows:WSL与Docker

通过 Docker Desktop 运行 POSIM,再由 WSLg 将 Gazebo 窗口显示在 Windows 桌面上。本页的 Docker 命令均在 WSL 内的 Ubuntu 终端中执行。

1. 准备 WSL 和显卡驱动

先完成 Windows 安装指南的前两步:在 WSL2 中安装 Ubuntu 26.04,更新 WSL 和 Windows 侧的显卡驱动。NVIDIA 显卡也需要这样设置。不要在 WSL 中安装 Linux 显示驱动。

安装使用 WSL2 后端的 Docker Desktop,启用 Settings → Resources → WSL Integration → Ubuntu-26.04。使用 Docker Desktop 的引擎即可,无需在 Ubuntu 内再安装一个 Docker Engine。

检查服务端和显示套接字:

docker version --format '{{.Server.Version}}'
test -S /mnt/wslg/.X11-unix/X0
printf '%s\n' "$DISPLAY"

如果套接字不存在,请先完成 WSLg 配置。

2. 下载 POSIM

docker pull ioeslab/posim:latest

镜像版本和源码构建方法见 Docker 环境。以下配置使用软件渲染。如需使用受支持的 NVIDIA GPU,请先确认 GPU 访问要求。

3. 创建容器

docker run -d --name posim --init --shm-size=1g \
  -e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
  --mount type=bind,source=/mnt/wslg/.X11-unix,target=/tmp/.X11-unix,readonly \
  --mount type=volume,source=posim-data,target=/work \
  --entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'

将自己的文件保存在 /work 中,该目录对应 posim-data 数据卷。使用 docker stop posim 停止容器,使用 docker start posim 重新启动。

运行后续示例时,打开两个 Ubuntu 终端,并将两者连接到同一个容器。Gazebo 会直接显示为 Windows 窗口。

4. 启动演示世界

进入容器:

docker exec -it posim bash

运行以下命令验证安装:

source /opt/ros/lyrical/setup.bash
source /opt/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false

Gazebo 应显示海洋场景。仿真运行期间保持终端打开,按 Ctrl+C 停止。接下来可以启动第一个机器人。

请在同一个 POSIM 容器内启动 Linux 版 QGC,不要在 Windows 主机或容器外的 WSL 中启动 QGC。请参阅 QGC 设置。