systect/qgis-server

QGIS Server Docker镜像

镜像概述

该Docker镜像提供了简单的QGIS Server运行环境，基于Apache httpd服务。最新版本（>=3.2）使用QGIS3构建依赖镜像作为基础。请注意，在生产环境使用前需调整安全配置。

核心功能

• 运行QGIS Server，支持OGC标准服务（WMS、WFS等）
• 通过环境变量配置Apache和QGIS参数
• 支持挂载本地QGIS项目文件（.qgs）
• 兼容Docker Compose部署，可与PostGIS等服务集成

使用场景

• 开发者快速搭建GIS服务进行测试
• 小型GIS项目的轻量化部署
• 学习QGIS Server功能的实验环境

配置说明

拉取镜像

bash
docker pull systect/qgis-server:LTR

（LTR版本跟踪最新QGIS长期支持版，建议使用特定版本标签避免配置兼容问题）

运行容器

单个项目部署

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

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

访问http://localhost:8080/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities获取服务能力描述。

多个项目部署

设置QGIS_PROJECT_FILE为空，通过URL指定项目路径：

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

访问http://localhost:8080/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities&MAP=/gis/project.qgs获取特定项目服务能力描述。

Docker Compose示例

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

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

运行命令：docker-compose up

环境变量配置

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_PLUGINPATH: /opt/qgis-server/plugins

（详细参数请参考QGIS Server官方文档）

注意事项

• 生产环境需调整安全配置
• 建议使用版本标签而非latest，避免版本兼容问题
• 当前镜像暂不支持QGIS Server插件，欢迎PR贡献