DimOS Docker Deployment Guide: Building a Reproducible Robot Development Container Environment【免费下载链接】dimosDimensional is the agentic operating system for physical space. Command humanoids, quadrupeds, drones, and other hardware platforms in natural language and build multi-agent systems that work seamlessly with physical input (cameras, lidar, actuators).项目地址: https://gitcode.com/GitHub_Trending/dimo/dimosDimOSDimensional是面向物理空间的智能体操作系统支持用自然语言指挥人形机器人、四足机器人、无人机等硬件平台。DimOS Docker 部署让你跳过繁琐的系统依赖安装用一条命令即可获得完整、可复现的机器人开发容器环境——Python 依赖、LCM 通信、ROS 2、仿真与工具链全部预装完毕。本指南覆盖镜像选型、容器启动、Docker Compose 编排与本地构建帮你快速搭建属于自己的机器人开发沙盒。为什么机器人开发需要 Docker 容器机器人软件栈的依赖向来令人头疼Python 版本、CUDA、OpenCV、LCM 中间件、ROS 2 发行版……在一台新机器上从零配齐往往要折腾半天。DimOS 官方为此提供了平行的 Docker 镜像体系把整个开发环境固化成镜像做到拉镜像即可开发可复现团队成员、CI 流水线使用完全一致的环境避免在我机器上能跑的问题⚡零配置无需手动安装系统依赖官方文档docs/requirements.md隔离实验性修改不影响宿主机随时丢弃重建完整的 Docker 官方文档见 docs/development/docker.md。DimOS 镜像层级结构5 个镜像怎么选DimOS 维护着ROS与非 ROS两条镜像构建轨道定义在 docker/ 目录下全部基于 Ubuntu镜像基础用途dimensional/pythonubuntu核心 dimos Python 依赖不含 ROSdimensional/devpython完整开发环境编辑器、git、pre-commit、tmuxdimensional/rosubuntuROS 2Jazzy 导航、SLAM、RViz 等导航包dimensional/ros-pythonrosROS dimos Python 依赖dimensional/ros-devros-python完整 ROS 开发环境非 ROS 轨道 ROS 轨道 ubuntu:22.04 ubuntu:22.04 └── python └── ros └── dev └── ros-python └── ros-dev快速选择指南只想写 Python 代码、跑仿真与回放→dimensional/dev推荐新手从这里开始需要 ROS 2 话题、导航栈集成、ROS 消息互通→dimensional/ros-dev仅部署运行时依赖→dimensional/python或dimensional/ros-python一键启动步骤3 行命令进入开发容器非 ROS 开发环境docker run -it dimensional/dev:latest bash容器内的工作目录是/appdimos命令行工具、uv包管理器都已就绪直接进入项目开始开发即可。ROS 2 开发环境docker run -it dimensional/ros-dev:latest bash该镜像的入口脚本 docker/dev/entrypoint.sh 会自动sourceROS 2 的setup.bash进容器后ros2命令立即可用无需手动配置环境变量。镜像标签怎么选镜像按 Git 分支打标签方便锁定版本或尝鲜分支标签适用场景mainlatest生产与日常开发最稳定devdev尝鲜最新特性特性分支分支名如feature_foo_bar配合特定开发分支调试Docker Compose 编排把代码挂载进容器官方在 docker/dev/ 下提供了现成的 Compose 编排文件比裸docker run更适合日常开发——它会把你的本地代码挂载到容器的/app实现本地改代码、容器里运行文件特点docker/dev/docker-compose.yaml标准版host 网络 X11 转发 端口 5555/3000docker/dev/docker-compose-cuda.yamlGPU 版额外启用nvidiaruntime感知、SLAM 等任务可跑 CUDA 加速关键配置解析代码挂载../../:/app—— 宿主机仓库目录映射进容器改动实时生效host 网络模式机器人与传感器通常依赖本机网络通信network_mode: host免去端口映射烦恼X11 转发挂载/tmp/.X11-unix与.Xauthority可在容器内运行 GUI如可视化窗口GPU 支持CUDA 版通过NVIDIA_VISIBLE_DEVICESall直通全部显卡启动方式在docker/dev/目录下# 普通开发环境 docker compose up # 带 NVIDIA GPU 的感知/仿真环境 docker compose -f docker-compose-cuda.yaml updev 镜像内置了哪些开发工具dev镜像构建定义见 docker/dev/Dockerfile不只是装了 dimos而是一个开箱即用的开发者工作站uv高速 Python 包管理器UV_SYSTEM_PYTHON1装依赖快一个量级Rust 工具链供dimos bake编译原生模块宿主Native ModulesNode.js 24经 nvm 安装支撑前端与 Web 交互组件开发️git / git-lfs / pre-commit版本控制与提交钩子全齐tmux 定制配置docker/dev/tmux.conf、htop、vim/nano定制 bash 环境docker/dev/bash.sh彩色提示符、常用别名gsgit status、psg等、自动导出项目.env变量motd 版本横幅登录时显示镜像对应的分支与提交号方便确认环境版本python基础镜像docker/python/Dockerfile则预装了 LCMliblcm-dev、CycloneDDSUnitree SDK 所需、turbojpeg、Qt/XCB 图形库等系统级依赖ros镜像docker/ros/Dockerfile在此基础上叠加 ROS 2 Jazzy 桌面版、Navigation2、SLAM Toolbox、RViz2、Foxglove Bridge 等导航与调试全家桶。本地构建与自定义镜像所有 Dockerfile 都接受FROM_IMAGE构建参数同一份 Dockerfile 可以构建在不同基础之上例如把python层叠加到ros基础上这是两条轨道能复用 Dockerfile 的关键设计。仓库提供bin/dockerbuild辅助脚本一条命令构建指定镜像./bin/dockerbuild python # 构建 python 镜像 ./bin/dockerbuild dev # 构建 dev 镜像 ./bin/dockerbuild ros # 构建 ros 镜像CI/CD 自动构建机制官方镜像由持续集成流水线自动构建并推送合并到main/dev且对应docker/*目录有变更时触发构建每周定时重建基础镜像自动获得安全补丁测试与类型检查流水线直接使用预构建镜像保证CI 环境与交付环境完全一致这正是可复现承诺的底层保障——你拉到的latest与官方 CI 跑测试用的是同一份镜像。常见问题与实用提示Q1容器内找不到 ROS 命令确认你用的是ros系列镜像且通过 entrypoint 进入docker run -it ... bash会先执行 entrypoint.sh 自动 source 环境。手动docker exec进入时执行source /opt/ros/jazzy/setup.bash即可。Q2可视化窗口出不来ComposE 文件已挂载 X11但宿主机需要允许本地连接xhost local:并确保DISPLAY环境变量有值。Q3想用特定版本而不是 latest用分支标签如dimensional/dev:dev锁定行为配合 docs/development/testing.md 中的测试指南可在容器内跑完整测试套件。Q4无 GPU 能开发吗完全可以。非 ROS 轨道 仿真/回放dimos --replay、dimos --simulation都不需要 GPUGPU 仅在你跑 CUDA 加速感知时才需要 docker-compose-cuda.yaml。相关文件与延伸阅读资源路径Docker 官方文档docs/development/docker.mddev 开发镜像定义docker/dev/DockerfilePython 基础镜像docker/python/DockerfileROS 2 基础镜像docker/ros/DockerfileCompose 编排标准 / CUDAdocker/dev/docker-compose.yaml、docker/dev/docker-compose-cuda.yaml系统依赖说明docs/requirements.md测试指南docs/development/testing.md只需docker run -it dimensional/dev:latest bash一条命令你便拥有了与官方 CI 完全一致的 DimOS 机器人开发容器——把环境配置的时间省下来专注写你的机器人智能体吧。【免费下载链接】dimosDimensional is the agentic operating system for physical space. Command humanoids, quadrupeds, drones, and other hardware platforms in natural language and build multi-agent systems that work seamlessly with physical input (cameras, lidar, actuators).项目地址: https://gitcode.com/GitHub_Trending/dimo/dimos创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考