QGIS Server 3.44/4.0 独立部署指南：Ubuntu 22.04 下 5 步配置 Apache 与虚拟主机

QGIS Server 3.44/4.0 独立部署指南：Ubuntu 22.04 下 5 步配置 Apache 与虚拟主机

在当今地理信息系统（GIS）领域，QGIS Server 作为一款开源的地图服务解决方案，正逐渐成为企业级空间数据发布的首选工具。与传统的桌面端 QGIS 不同，QGIS Server 专注于提供稳定高效的 Web 地图服务（WMS）、Web 要素服务（WFS）和 Web 覆盖服务（WCS）。本文将深入讲解如何在 Ubuntu 22.04 服务器上独立部署 QGIS Server 3.44/4.0 版本，并通过 Apache 实现高性能的虚拟主机配置。

1. 系统环境准备

在开始安装之前，我们需要确保系统环境满足基本要求。推荐使用 Ubuntu 22.04 LTS 作为基础操作系统，这是一个长期支持版本，提供了稳定的运行环境和安全更新。

首先更新系统软件包并安装必要的依赖项：

sudo apt update && sudo apt upgrade -y sudo apt install -y software-properties-common gnupg

添加 QGIS 官方软件源以确保获取最新版本：

sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable sudo apt update

提示：生产环境中建议使用稳定版本仓库（ppa:ubuntugis/ppa），但本文以最新功能演示为目的选择非稳定分支。

验证系统架构是否匹配：

uname -m # 输出应为 x86_64 或 aarch64，确保与下载包架构一致

2. QGIS Server 核心安装

与桌面端集成安装不同，生产环境推荐独立部署 QGIS Server 以避免不必要的图形界面依赖。执行以下命令进行最小化安装：

sudo apt install -y qgis-server --no-install-recommends

验证安装是否成功：

/usr/lib/cgi-bin/qgis_mapserv.fcgi --version # 应输出类似内容： # QGIS 3.44.4 'Solothurn' # QGIS code revision 108203c541e # ...

安装 Python 插件支持（可选）：

sudo apt install -y python3-qgis

关键文件位置说明：

3. Apache 服务器集成配置

Apache 作为最流行的 Web 服务器之一，与 QGIS Server 的集成能提供稳定的服务环境。首先安装 Apache 和 FastCGI 模块：

sudo apt install -y apache2 libapache2-mod-fcgid sudo a2enmod fcgid

创建专用配置文件/etc/apache2/conf-available/qgis-server.conf：

<IfModule mod_fcgid.c> FcgidInitialEnv QGIS_SERVER_LOG_LEVEL 0 FcgidInitialEnv QGIS_SERVER_LOG_FILE /var/log/qgis-server/qgis-server.log FcgidInitialEnv QGIS_PLUGINPATH "/usr/lib/qgis/plugins" FcgidInitialEnv QGIS_SERVER_PARALLEL_RENDERING 1 FcgidInitialEnv QGIS_SERVER_MAX_THREADS 4 FcgidInitialEnv QGIS_SERVER_CACHE_SIZE 50 </IfModule>

启用配置并重启服务：

sudo a2enconf qgis-server sudo systemctl restart apache2

4. 虚拟主机高级配置

为隔离不同项目环境，建议为每个 QGIS Server 实例配置独立的虚拟主机。以下示例创建gis.example.com的虚拟主机：

1. 创建主机目录结构：

sudo mkdir -p /var/www/gis/{projects,logs,cache} sudo chown -R www-data:www-data /var/www/gis

2. 配置虚拟主机文件/etc/apache2/sites-available/gis.conf：

<VirtualHost *:80> ServerName gis.example.com DocumentRoot /var/www/gis ErrorLog ${APACHE_LOG_DIR}/qgis-error.log CustomLog ${APACHE_LOG_DIR}/qgis-access.log combined ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ <Directory "/usr/lib/cgi-bin"> AllowOverride None Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch Require all granted SetHandler fcgid-script </Directory> # 项目文件访问权限 <Directory "/var/www/gis/projects"> Options FollowSymLinks Require all granted </Directory> # 性能调优参数 FcgidMaxRequestLen 10MB FcgidConnectTimeout 60 FcgidIOTimeout 60 FcgidBusyTimeout 60 </VirtualHost>

3. 启用站点并测试配置：

sudo a2ensite gis.conf sudo apachectl configtest sudo systemctl reload apache2

5. 服务验证与性能优化

完成部署后，需要通过实际请求验证服务是否正常运行。使用 curl 测试基础功能：

curl "http://localhost/cgi-bin/qgis_mapserv.fcgi?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities"

预期应返回 XML 格式的服务能力文档。若出现错误，可检查日志定位问题：

tail -f /var/log/apache2/qgis-error.log

性能优化建议：

1. 缓存配置：启用 QGIS 服务缓存可显著提升重复请求响应速度

sudo mkdir /var/cache/qgis-server sudo chown www-data:www-data /var/cache/qgis-server

2. 线程池调整：根据服务器 CPU 核心数优化并发处理能力

<!-- 在虚拟主机配置中添加 --> FcgidMaxProcesses 8 FcgidMinProcessesPerClass 2 FcgidMaxProcessesPerClass 8

3. 内存管理：针对大尺寸地图渲染调整内存限制

FcgidMaxRequestInMem 65536 FcgidOutputBufferSize 65536

4. 启用压缩：减少网络传输数据量

AddOutputFilterByType DEFLATE text/xml

通过以上步骤，您已成功在 Ubuntu 22.04 上部署了生产级 QGIS Server 环境。实际项目中，建议结合 CI/CD 流程实现项目文件的自动化部署，并通过监控工具如 Prometheus 跟踪服务健康状态。