保姆级教程：在Ubuntu 20.04上搞定PX4 SITL仿真与QGroundControl连接（含国内网络避坑）
国内开发者实战指南：Ubuntu 20.04搭建PX4仿真环境全流程解析
在无人机开发领域，PX4作为开源飞控系统的代表，其仿真环境搭建是每位开发者必须掌握的技能。然而对于国内用户而言，网络环境差异导致的依赖安装失败、配置错误等问题常常让入门过程充满挫折。本文将彻底解决这些痛点，从系统配置到最终连接QGroundControl，提供一份真正适合国内网络环境的完整解决方案。
1. 环境准备与国内网络适配
1.1 系统基础配置
在开始PX4环境搭建前，Ubuntu系统需要做好以下基础准备：
# 更新系统包列表 sudo apt update && sudo apt upgrade -y # 安装基础编译工具 sudo apt install -y build-essential cmake git国内用户首先需要配置APT软件源。编辑源列表文件：
sudo nano /etc/apt/sources.list替换内容为阿里云镜像源（示例片段）：
deb http://mirrors.aliyun.com/ubuntu/ focal main restricted deb http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted deb http://mirrors.aliyun.com/ubuntu/ focal universe1.2 Python环境专项优化
PX4依赖的Python包在国内下载常遇到问题，需要修改pip源：
# 创建pip配置文件 mkdir -p ~/.pip echo "[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn" > ~/.pip/pip.conf常见问题排查表：
| 错误现象 | 解决方案 | 验证命令 |
|---|---|---|
| SSL证书错误 | 添加--trusted-host参数 | pip install --trusted-host pypi.tuna.tsinghua.edu.cn package |
| 下载超时 | 增加超时时间 | pip --default-timeout=100 install package |
| 版本冲突 | 使用虚拟环境 | python3 -m venv px4_env |
2. PX4源码获取与编译
2.1 克隆代码仓库
使用Git获取PX4源码时，推荐使用国内镜像加速：
git clone https://gitee.com/mirrors/PX4-Autopilot.git --recursive cd PX4-Autopilot若子模块更新失败，可手动修改.gitmodules中的URL为国内镜像地址。
2.2 依赖安装与编译
执行官方安装脚本前，建议先安装这些易缺失的依赖：
sudo apt install -y ant openjdk-11-jdk libeigen3-dev然后运行安装脚本：
bash ./Tools/setup/ubuntu.sh编译jMAVSim仿真器：
make px4_sitl jmavsim注意：若GUI界面未显示，通常是缺少Java环境或ant工具导致，检查
ant -version输出是否正常。
3. 仿真环境深度配置
3.1 jMAVSim高级用法
成功启动仿真后，可以通过PX4 shell执行多种命令：
pxh> commander takeoff # 起飞指令 pxh> param show SYS_AUTOSTART # 查看参数 pxh> listener sensor_accel # 查看传感器数据常用调试命令速查表：
| 命令类别 | 示例命令 | 功能说明 |
|---|---|---|
| 飞行控制 | commander arm | 解锁电机 |
| 参数管理 | param set MPC_XY_VEL_MAX 5 | 设置最大水平速度 |
| 数据监控 | uorb top | 查看主题发布频率 |
3.2 多飞行器仿真
通过指定世界和模型参数，可以模拟不同飞行器：
make px4_sitl jmavsim_iris # 或 make px4_sitl jmavsim_rover4. QGroundControl连接实战
4.1 地面站安装与配置
在Ubuntu上安装QGroundControl：
sudo usermod -a -G dialout $USER sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-libav wget https://d176tv9ibo4jno.cloudfront.net/latest/QGroundControl.AppImage chmod +x QGroundControl.AppImage连接仿真器的关键配置步骤：
- 启动QGroundControl后选择"UDP"连接方式
- 端口设置为18570
- 点击Connect按钮建立连接
4.2 遥控器模拟方案
在没有物理遥控器时，可以通过以下方式模拟：
键盘控制方案：
make px4_sitl jmavsim___keyboard虚拟摇杆方案：
- 安装QJoyPad工具
- 配置键盘到虚拟摇杆的映射
- 在QGroundControl中校准虚拟遥控
5. 进阶技巧与性能优化
5.1 仿真加速技巧
通过调整时间因子加速仿真：
make px4_sitl jmavsim SPEED_FACTOR=25.2 多机协同仿真
启动多个实例实现多机仿真：
# 终端1 make px4_sitl jmavsim instance0 # 终端2 make px4_sitl jmavsim instance1每个实例会自动分配不同的端口，可在QGroundControl中分别连接。
5.3 可视化调试工具
安装Flight Review进行日志分析：
pip install flightreview --user典型问题分析流程：
- 复现问题并记录ulog
- 使用Flight Review加载日志
- 检查关键参数曲线
- 对比正常飞行数据
在Ubuntu上搭建PX4仿真环境时，网络问题导致的失败往往令人沮丧。经过多次实践验证，最稳定的方案是预先配置好所有国内镜像源，并在编译前手动检查关键依赖是否完整。对于企业级开发，建议搭建本地缓存代理服务器来进一步提升依赖下载速度。