跳到主要内容

Docker 环境配置

xrobot-org/Docker-Image 当前发布的 Docker 镜像和使用方式如下。

当前仓库维护以下 5 种镜像：

  • docker-image-stm32
  • docker-image-esp32
  • docker-image-ch32-riscv
  • docker-image-linux
  • docker-image-webots

当前镜像内容（按当前 Dockerfile 手动核对）​

docker-image-stm32​

  • 基于 ubuntu:24.04
  • 包含 arm-gnu-toolchain-14.2.rel1
  • 包含 starm-clang
  • 当前镜像专门把 stm32cube-ide-core 固定在 1.1.0，因为更新后的包线已经不再提供 Linux 侧 cube downloader，直接跟随更新会使当前 STM32 镜像失去这部分能力

docker-image-ch32-riscv​

  • 基于 ubuntu:24.04
  • 当前已切换到 WCH GCC15 v240
  • 编译器前缀为 riscv32-wch-elf-
  • 同时带有对应 OpenOCD

docker-image-esp32​

  • 基于 ubuntu:24.04
  • 预装 ESP-IDF v5.4.1
  • 目录位于 ~/esp/esp-idf
  • 适合直接跑官方 idf.py 工作流

docker-image-linux​

  • 基于 ubuntu:24.04
  • 预装 clang / cmake / ninja / gcc / g++ / gdb
  • 预装 libwpa-client-dev / libnm-dev / libudev-dev / libgpiod-dev
  • 适合直接作为 Linux 原生驱动和工具链环境

docker-image-webots​

  • 面向 Webots 仿真环境
  • 同时包含图形 / 仿真相关依赖

GHCR 拉取​

当前以 GHCR 为准：

  • docker pull ghcr.io/xrobot-org/docker-image-stm32:main
  • docker pull ghcr.io/xrobot-org/docker-image-esp32:main
  • docker pull ghcr.io/xrobot-org/docker-image-ch32-riscv:main
  • docker pull ghcr.io/xrobot-org/docker-image-linux:main
  • docker pull ghcr.io/xrobot-org/docker-image-webots:main

Docker Hub 镜像源​

如果你使用 Docker Hub 镜像源，也可以直接拉这些名字：

  • docker pull xrimage/xrimage-stm32
  • docker pull xrimage/xrimage-esp32
  • docker pull xrimage/xrimage-ch32-riscv
  • docker pull xrimage/xrimage-linux
  • docker pull xrimage/xrimage-webots

运行 Docker 镜像​

docker run -it --rm 镜像名

如果要把本地工程挂进去，直接显式挂载工作目录，例如：

docker run -it --rm -v "$PWD":/work -w /work ghcr.io/xrobot-org/docker-image-linux:main