kartoza/qgis-server

QGIS Server Docker镜像

镜像概述

本镜像基于QGIS Desktop Docker镜像构建，用于运行QGIS Server，提供符合OGC标准的地理信息服务（如WMS、WFS）。镜像遵循GPL V2开源协议，支持通过环境变量配置参数，可灵活挂载本地QGIS项目文件进行部署。

核心功能

• 提供WMS、WFS等OGC标准地理信息服务；
• 支持挂载本地QGIS项目文件（.qgs）快速部署；
• 允许通过环境变量配置QGIS Server和Apache参数；
• 内置On-the-fly项目创建插件，可基于文件系统图层动态生成QGIS项目；
• 支持多项目部署，需在URL中指定项目路径。

使用场景

• 快速测试QGIS项目的OGC服务功能；
• 搭建轻量级GIS服务节点；
• 集成到地理信息系统应用中提供地图服务；
• 用于开发或演示GIS相关应用。

配置说明

环境变量

Apache相关变量（默认值）：

• APACHE_CONFDIR: /etc/apache2
• APACHE_RUN_USER: www-data
• APACHE_LOG_DIR: /var/log/apache2

QGIS相关变量（默认值）：

• QGIS_DEBUG: 5
• QGIS_PROJECT_FILE: /project/project.qgs
• QGIS_SERVER_LOG_LEVEL:5
• PGSERVICEFILE: /project/pg_service.conf

扩展Apache配置

可通过设置QGIS_CONF_FILE环境变量指定自定义Apache配置文件，或直接将配置文件挂载到/etc/apache2/conf-enabled目录。

部署示例

拉取镜像

bash
docker pull kartoza/qgis-server:LTR

运行容器（单项目）

挂载本地项目文件夹到/project，默认加载project.qgs：

bash
docker run --name "qgis-server" -v /path/to/your/project_folder:/project -p 8080:80 -d -t kartoza/qgis-server:LTR

访问http://localhost:8080/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities获取服务元数据。

运行容器（多项目）

设置QGIS_PROJECT_FILE为空，挂载项目文件夹到任意路径（如/gis）：

bash
docker run --name "qgis-server" -e QGIS_PROJECT_FILE='' -v /path/to/your/project_folder:/gis -p 8080:80 -d -t kartoza/qgis-server:LTR

访问指定项目：http://localhost:8080/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities&MAP=/gis/your_project.qgs

Docker Compose示例

yaml
db:
  image: kartoza/postgis:9.6-2.4
  environment:
    - USERNAME=docker
    - PASS=docker

qgisserver:
  image: kartoza/qgis-server:LTR
  hostname: qgis-server
  volumes:
    - ./project:/project
  links:
    - db:db
  ports:
    - "8080:80"

启动命令：docker-compose up