热门搜索:
ctumrs/mrs_uav_system
ctumrs
MRS UAV System是一个集成无人机开发、仿真与部署功能的Docker镜像，包含无人机控制、导航、任务规划等核心组件，支持快速搭建标准化开发环境，适用于科研、教育及工业领域的无人机系统开发与测试。
4 次收藏下载次数: 0状态：社区镜像维护者：ctumrs仓库类型：镜像最近更新：10 天前
MRS UAV System Docker镜像文档
镜像概述与主要用途
MRS UAV System Docker镜像是一个预配置的无人机系统开发环境，旨在简化无人机（UAV）相关项目的开发、仿真与部署流程。该镜像集成了无人机控制、导航算法、任务规划、传感器数据处理等核心功能模块，以及常用的开发工具与依赖库，避免用户手动配置复杂的开发环境，可直接用于无人机系统的原型开发、算法验证、仿真测试及实际部署。
核心功能与特性
1. 预配置开发环境
- 集成ROS（Robot Operating System）、PX4自动驾驶仪、Gazebo仿真器等主流无人机开发工具链
- 包含Python/C++开发环境、编译器及调试工具，支持多语言开发
- 预装无人机系统常用依赖库（如Eigen、OpenCV、PCL等）
2. 多场景支持
- 支持软件在环（SITL）仿真与硬件在环（HITL）测试
- 兼容多种无人机模型（固定翼、多旋翼、垂直起降等）
- 提供常用传感器仿真接口（GPS、IMU、摄像头、激光雷达等）
3. 易用性与可扩展性
- 标准化环境配置，确保跨平台开发一致性
- 支持用户自定义算法模块集成
- 提供示例项目与测试脚本，快速上手开发
使用场景与适用范围
适用场景
- 科研领域：无人机导航算法、路径规划、自主控制等研究的原型验证
- 教育领域：高校无人机系统课程教学，学生无需手动配置环境即可开展实验
- 工业应用：工业级无人机项目的快速原型开发与功能测试，如巡检、测绘等场景
适用人群
- 无人机系统开发工程师
- 机器人与自动化专业科研人员
- 高校相关专业教师与学生
- 无人机技术爱好者
使用方法与配置说明
环境准备
- 安装Docker Engine（20.10+版本）
- 安装Docker Compose（可选，用于多容器部署）
- 确保主机支持图形界面（仿真可视化需显示支持）
快速启动
1. 拉取镜像
bashdocker pull mrs-uav-system:latest
2. 启动基础开发环境
bashdocker run -it --rm \ --name mrs-uav-dev \ --env DISPLAY=$DISPLAY \ --volume /tmp/.X11-unix:/tmp/.X11-unix \ --volume $(pwd)/uav-project:/workspace \ mrs-uav-system:latest
--env DISPLAY=$DISPLAY：允许容器访问主机图形界面（用于Gazebo等仿真工具可视化）--volume $(pwd)/uav-project:/workspace：挂载本地项目目录到容器内，方便代码开发与文件共享--rm：容器退出后自动删除，避免残留
3. 启动仿真环境
在容器内执行以下命令启动多旋翼无人机仿真（以PX4 + Gazebo为例）：
bashcd /opt/mrs-uav-system/scripts ./start_simulation.sh -m quadcopter -s gazebo
配置参数说明
环境变量
| 环境变量名 | 描述 | 默认值 |
|---|---|---|
UAV_MODEL | 指定无人机模型（quadcopter/fixedwing/vtol） | quadcopter |
SIMULATOR | 选择仿真器（gazebo/webots） | gazebo |
LOG_LEVEL | 日志级别（debug/info/warn/error） | info |
WORKSPACE | 项目工作目录路径 | /workspace |
启动脚本参数
start_simulation.sh支持以下参数：
-m, --model：无人机模型（同UAV_MODEL环境变量）-s, --simulator：仿真器类型（同SIMULATOR环境变量）-d, --debug：启用调试模式，输出详细日志-t, --test：运行内置测试用例，验证环境完整性
自定义开发流程
- 将本地项目代码挂载到容器
/workspace目录 - 在容器内使用预装工具（如
catkin_make、colcon build）编译项目 - 通过仿真环境测试算法功能（执行
start_simulation.sh并运行自定义节点） - 测试通过后，可基于镜像构建自定义部署镜像，用于实际无人机硬件部署
注意事项
- 图形界面支持：需确保主机已安装X Server，Linux系统直接使用
DISPLAY环境变量，Windows/macOS需配合X11转发工具（如VcXsrv、XQuartz） - 性能要求：仿真环境建议主机配置4核以上CPU、8GB以上内存及独立显卡
- 网络配置：如需多机通信或硬件连接，可通过
--network=host参数让容器共享主机网络
版本信息
- 最新版本：
latest（基于ROS Noetic、PX4 v1.14.0、Gazebo 11构建） - 历史版本：可通过指定标签拉取（如
mrs-uav-system:ros-melodic对应ROS Melodic版本）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 mrs_uav_system 镜像标签
docker pull docker.xuanyuan.run/ctumrs/mrs_uav_system:<标签>
DockerHub 原生拉取命令
docker pull ctumrs/mrs_uav_system:<标签>
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"