Ubuntu 20.04 系统下 QGroundControl 地面站安装指南

Ubuntu 20.04 下 QGroundControl 安装实战

在 Ubuntu 20.04 上跑通 QGroundControl (QGC) 其实不难，但有些坑得提前避开。比如串口权限和依赖库，搞不好连不上飞控或者启动报错。下面按步骤来。

环境依赖准备

先处理一下串口权限，避免后续设备被占用。顺便把缺失的 GStreamer 插件补上，这对视频流传输很重要。

sudo usermod -a -G dialout $USER
sudo apt-get remove modemmanager -y
sudo apt install gstreamer1.0-plugins-bad gstreamer1.0-libav gstreamer1.0-gl -y
sudo apt install libfuse2 -y
sudo apt install libxcb-xinerama0 libxkbcommon-x11-0 libxcb-cursor0 -y

注意：修改用户组后需要重新登录或重启生效。

获取与运行程序

建议直接去官网下载最新版，稳定可靠。下载下来的是 AppImage 格式，不用解压，给个执行权限就能跑。Linux 对大小写敏感，如果文件名不一致记得调整。

cd ~/Downloads
mv QGroundControl.appimage QGroundControl.AppImage
chmod +x QGroundControl.AppImage
./QGroundControl.AppImage

常见问题排查

有时候打开软件地图是白的，别慌，通常是国内网络访问不了 OpenStreetMap 等瓦片服务器导致的。这时候可以试试清理本地缓存，强制它重新拉取。

rm -rf ~/.cache/QGCMapCache300

如果还是不行，可能需要检查代理设置或者使用离线地图包。