跳到主要内容

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