银河麒麟V10离线安装QGis全攻略：依赖处理与天地图加载-北京尧图网络

简介本资源面向在银河麒麟操作系统上开展地理信息工作的科研与技术人员提供QGis 3.10.4的完整离线安装包解决国产化环境下无网络时无法在线部署GIS软件的难题。压缩包共95个文件以89个deb安装包为主涵盖qgis主程序、GDAL、Python3依赖及Qt5组件另含2个sh安装脚本、1个txt说明文档、1个sig校验文件、1个log日志与1个gz压缩包整体约358.59MB。资源已获1242人学习下载说明其在国产系统GIS部署场景中具有较高参考价值。借助预置的离线安装脚本与依赖清单读者可跳过繁琐的依赖排查直接完成软件包校验、安装与功能验证并针对飞腾等国产CPU架构进行适配快速搭建稳定可靠的地理信息数据处理平台适用于环境监测、城市规划等领域的科研与生产活动。1. 银河麒麟离线装 QGis为什么内网机器非得走这条路上周帮一个做测绘的兄弟处理一台银河麒麟 V10 SP1 的机器整机在内网里网口只通业务系统连软件商店都刷不出列表。他要在上面跑 QGis 打开天地图影像做底图配准结果apt install qgis直接卡在源地址超时。这不是个例——银河麒麟的桌面版默认源在不少内网环境里根本够不着而 QGis 又不像 WPS、搜狗输入法那样在麒麟软件商店里有现成适配包。所以「银河麒麟系统离线安装 QGis 包」这件事本质是把一台能联网的机器当成中转站把 QGis 及其几十个依赖完整搬到目标机上。适合谁做 GIS 内业、测绘、应急指挥、涉密办公环境里需要在麒麟上出图的从业者。这篇就把我实际走通的流程、依赖怎么凑齐、装完打不开怎么排查一条条拆开讲。2. 先搞清楚装哪个 QGis麒麟源、官方包与依赖树2.1 银河麒麟能装的 QGis 版本边界银河麒麟 V10 SP1 桌面版底层是 Debian 系但它的软件源经过二次裁剪qgis这个包名在默认源里时有时无。我实测过几个版本V10 SP1 2303 的源里能搜到qgis但版本停在 3.10 左右而且依赖链经常断V10 SP1 2403 的源里干脆没有。所以别指望apt install qgis一把梭离线安装才是稳的路子。选版本有个硬约束QGis 3.x 依赖 Qt5 和 Python3银河麒麟 V10 自带 Python 3.7 和 Qt 5.12这个组合能跑 QGis 3.16 到 3.28 之间的 LTS 版本。再往上 3.34 开始要求 Qt 5.15麒麟自带的 Qt 版本不够硬装会缺libQt5Core.so.5.15这类库。我一般推荐QGis 3.28 LTR它是最后一个对 Qt 5.12 友好的长期支持版功能也够用加载天地图、做矢量裁剪都不虚。提示如果你不确定目标机 Qt 版本先跑qmake --version或dpkg -l | grep qt5看一眼别闷头下最新版。2.2 离线包的三种来源与取舍离线安装 QGis包从哪来决定了后面顺不顺。常见三条路来源优点坑点麒麟官方源导出 deb依赖匹配度最高版本老可能没有 qgis 包QGis 官方 Debian 包版本新、功能全依赖要自己补Qt 版本可能不匹配第三方打包的 AppImage单文件、免依赖麒麟上 FUSE 有时要额外配字体可能乱我实际用的是第二条路在一台同版本银河麒麟的联网机器上用apt-get install --download-only把 QGis 和它的全部依赖 deb 包拉下来再整体拷到内网机。这样依赖树是现成的不用一个个去猜缺哪个库。AppImage 那条路我也试过启动时报fuse: device not found还得装fuse和改权限对新手不友好所以这篇主讲 deb 包方案。2.3 依赖树到底有多深QGis 的依赖不是一两个包的事。我那次--download-only拉下来/var/cache/apt/archives/里躺了187 个 deb 包除了 qgis 本体还有qgis-providers、qgis-plugin-grass、libgdal、libproj、libgeos、python3-qgis这一大串。这里面最容易被忽略的是qgis-providers——它管着数据源插件缺了它 QGis 能打开但加载不了天地图这种 XYZ 瓦片。还有libqt5sql5-sqlite缺了会导致工程文件存不上。所以离线安装的核心不是「装 qgis」而是「把这 180 多个包按正确顺序喂进去」。下面一章就讲怎么在联网机上把包凑齐、怎么在目标机上批量装。3. 联网机导出与目标机批量安装命令级操作3.1 在联网麒麟上把 QGis 及依赖下载到本地找一台和目标准备装 QGis 的机器系统版本一致的银河麒麟这点很重要版本不一致依赖会对不上确保它能连上软件源。然后执行# 更新源索引确保能拿到最新的包列表 sudo apt-get update # 只下载不安装把 qgis 及其全部依赖存到缓存目录 sudo apt-get install --download-only -y qgis qgis-providers qgis-plugin-grass python3-qgis # 把下载好的 deb 包统一拷到一个文件夹方便打包 mkdir -p ~/qgis-offline sudo cp /var/cache/apt/archives/*.deb ~/qgis-offline/ # 统计一下包数量和总大小心里有数 ls ~/qgis-offline/*.deb | wc -l du -sh ~/qgis-offline/--download-only是关键参数它让 apt 只解析依赖并下载不执行安装这样不会污染联网机的环境。qgis-providers和python3-qgis要显式写进去因为有些源里它们不是 qgis 的强依赖不写就不会被拉下来。跑完ls | wc -l看到一百多个包是正常的我那次是 187 个总大小约 620MB。注意如果apt-get update报源地址连不上先确认这台联网机的/etc/apt/sources.list指向的是可用的麒麟源别用内网那台的配置。3.2 打包拷贝与目标机导入把~/qgis-offline整个文件夹用 U 盘或内网共享拷到目标机。目标机上先建一个本地源目录把 deb 包放进去# 在目标机上创建本地包目录 mkdir -p ~/qgis-offline # 假设 deb 包已经拷到 U 盘挂载点 /media/kylin/USB cp /media/kylin/USB/qgis-offline/*.deb ~/qgis-offline/ # 用 dpkg 批量安装-R 递归-i 安装通配符匹配所有 deb sudo dpkg -iR ~/qgis-offline/ # 上面这步大概率会报依赖错误用下面这条修复 sudo apt-get install -f -ydpkg -iR会按文件顺序装遇到依赖顺序不对会报dependency problems这是正常的不用慌。紧接着的apt-get install -f会尝试从本地已装的包里补齐依赖关系。但这里有个前提目标机的 apt 源里得能解析到这些依赖如果源完全不通-f也会失败。所以更稳的做法是先把本地目录做成一个临时源# 生成 Packages 索引文件 cd ~/qgis-offline dpkg-scanpackages . /dev/null | gzip -9c Packages.gz # 把这个目录加进 apt 源列表 echo deb [trustedyes] file:///home/kylin/qgis-offline ./ | sudo tee /etc/apt/sources.list.d/qgis-local.list # 更新索引后正常安装 sudo apt-get update sudo apt-get install -y qgis qgis-providers python3-qgisdpkg-scanpackages生成索引[trustedyes]跳过签名校验本地包没必要签名file://指向本地路径。这样 apt 就能从本地目录解析依赖并自动排序安装比dpkg -iR稳得多。装完跑qgis --version看版本号能打印出来就说明主程序到位了。3.3 验证安装与首次启动装完别急着高兴先验证几个关键点# 检查 qgis 主程序路径 which qgis # 检查 Python 绑定是否可用加载天地图脚本要用 python3 -c import qgis.core; print(qgis.core.Qgis.QGIS_VERSION) # 检查 providers 插件目录是否存在 ls /usr/lib/qgis/plugins/ | head如果import qgis.core报ModuleNotFoundError说明python3-qgis没装好回上一步补。/usr/lib/qgis/plugins/里应该有provider_xyz之类的文件这是加载天地图瓦片的基础。首次启动直接终端敲qgis如果弹窗报缺库看报错里的.so名字用apt-file search或dpkg -S反查是哪个包再回联网机补下。4. 装完打不开、加载不了天地图避坑与排查4.1 启动报 libQt5Core.so.5.15 not found现象终端敲qgis报error while loading shared libraries: libQt5Core.so.5.15: cannot open shared object file。原因装的是 QGis 3.34 版本它编译时链接了 Qt 5.15而银河麒麟 V10 自带 Qt 5.12。解决降级到 QGis 3.28 LTR。回联网机重新--download-only拉 3.28 的包别硬凑 Qt 5.15麒麟上升级 Qt 会连带一堆系统组件风险太大。4.2 能启动但加载天地图瓦片空白现象QGis 打开了添加 XYZ 连接填了天地图地址图层列表有但画布全白。原因qgis-providers没装或版本不匹配XYZ 瓦片解析器缺失也可能是天地图 key 没填对。解决先确认dpkg -l | grep qgis-providers有输出。天地图地址格式要对常见写法是https://t{0-7}.tianditu.gov.cn/DataServer?Timg_wx{x}y{y}l{z}tk你的key{0-7}是子域轮询key 必须是天地图官网申请的有效 key内网机如果连不上天地图服务器瓦片照样出不来——这点要提前确认网络策略。4.3 dpkg 安装报大量 dependency problems现象dpkg -iR刷屏报dependency problems prevent configuration。原因deb 包安装顺序不对或者目标机缺基础依赖如libc6、libstdc6。解决别用dpkg -iR硬怼改用 3.2 节的本地源方案让 apt 自己算顺序。如果本地源也报缺把报错里的包名记下来回联网机apt-get download 包名单独补。4.4 装完菜单里找不到 QGis 图标现象命令行能启动但开始菜单搜不到。原因.desktop文件没装到/usr/share/applications/或者装了但图标缓存没刷新。解决ls /usr/share/applications/ | grep -i qgis看有没有。没有的话从联网机拷qgis.desktop过来然后sudo update-desktop-database刷新缓存。4.5 中文界面乱码或字体缺失现象QGis 界面中文显示成方块。原因麒麟系统缺 QGis 默认调用的中文字体或者 locale 没配。解决sudo apt-get install fonts-wqy-zenhei装文泉驿字体离线包同样要提前下然后fc-cache -fv刷新字体缓存。locale 用locale命令看LANGzh_CN.UTF-8要存在。5. 进阶把离线包装成可复用的一键部署脚本装一次不算完内网里往往有好几台麒麟要装。我后来把这套流程写成了一个脚本放在 U 盘里插上就能跑。核心思路是把「本地源批量安装验证」串起来#!/bin/bash # qgis-offline-install.sh # 用法把 deb 包放在脚本同级的 packages/ 目录sudo 执行本脚本 set -e PKG_DIR$(cd $(dirname $0) pwd)/packages LOCAL_SRC/etc/apt/sources.list.d/qgis-local.list # 1. 生成包索引 cd $PKG_DIR dpkg-scanpackages . /dev/null | gzip -9c Packages.gz # 2. 注册本地源先清理旧的避免重复 sudo rm -f $LOCAL_SRC echo deb [trustedyes] file://$PKG_DIR ./ | sudo tee $LOCAL_SRC # 3. 更新并安装 sudo apt-get update sudo apt-get install -y qgis qgis-providers python3-qgis # 4. 验证 echo --- 验证 --- qgis --version echo QGis 主程序 OK python3 -c import qgis.core; print(Python 绑定 OK) echo Python 绑定 OK ls /usr/lib/qgis/plugins/ | grep -q provider_xyz echo XYZ provider OK echo 安装完成终端输入 qgis 启动这个脚本里set -e让任何一步失败就停避免错误累积。PKG_DIR用脚本自身路径推导U 盘挂载点变了也不怕。验证段三行分别查主程序、Python 绑定、XYZ 插件三个都 OK 才算真装好。我一般还会在脚本末尾加一句fc-cache -fv刷字体省得中文乱码再来一遍。有个细节值得说dpkg-scanpackages在包多的时候会慢187 个包大概要十几秒别以为卡死了。另外[trustedyes]只适合本地离线包如果哪天这台机器要连外网源记得把这个 list 文件删掉不然 apt 会优先从本地找找不到再报错。从那以后我每次给内网麒麟装 QGis都强制走一遍「联网机 download-only → 本地源 → 脚本验证」这三步再没出现过装到一半缺库的情况。希望帮到你。本文还有配套的精品资源点击获取

银河麒麟V10离线安装QGis全攻略：依赖处理与天地图加载

相关推荐

判断对称二叉树：递归与迭代实现及面试避坑指南

华为云Flexus+DeepSeek征文｜ModelArts Studio加持：Flexus X实例上Search4All AI搜索平台与TaoToken统一Key接入实战

跨平台配置 VSCode 全指南：Python + Git + Codex AI 编程助手接入 TaoToken

更多资讯

SpringBoot智能出行系统：拼车打车与订单状态机实战解析

SpringBoot+Vue+MyBatis构建宠物爱心组织管理系统全栈实战

SharePoint Online文档库还原实战：回收站、版本历史与文件恢复全解析

大厂Offer通关攻略：从投递到谈薪的硬核复盘

AI应用从演示到上线：跨越工程化鸿沟的落地实践

Windows共享打印机0x00000709错误终极修复指南

今日更新

Agent Skills 完全指南：原理、写法、安装与实战避坑

Agent Skills 实战：从 Genkit 定义到 GKE 部署与排查

Agent Skills 实战：从设计到调试的完整指南

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？