3liz/qgis-wps

基于QGIS 3的WPS服务镜像

概述

该镜像提供基于QGIS 3的Web处理服务（WPS），用于将地理处理算法、脚本和模型通过Web服务形式对外提供。支持并行处理、异步结果存储、自定义处理路径和权限配置，适用于需要通过Web服务提供地理数据处理能力的GIS应用场景。

核心功能与特性

• 基于QGIS 3运行环境，支持QGIS地理处理算法、脚本和模型
• 支持并行处理，可配置并行进程数量
• 通过Redis存储日志（可选），支持异步任务结果状态管理
• 自定义处理算法提供者路径，可挂载外部处理脚本和模型
• 配置缓存根目录和工作目录，管理处理结果数据
• 支持用户权限设置，匹配挂载卷的所有者和组ID
• 可配置日志级别，便于调试和监控

使用场景与适用范围

• GIS应用后端服务，提供地理数据处理能力
• 地理信息系统自动化处理流程
• 需要通过Web服务对外提供自定义地理处理算法的场景
• 多用户共享地理处理资源的环境

使用方法与配置说明

快速启动

创建如下docker-compose.yml文件进行部署：

yaml
version: '3.8'
services:
  wps:
    image: 3liz/qgis-wps:<version_tag>
    environment:
      QGSWPS_SERVER_PARALLELPROCESSES: '2'  # 并行进程数量
      QGSWPS_SERVER_LOGSTORAGE: REDIS       # 日志存储方式（REDIS或其他）
      QGSWPS_REDIS_HOST: redis              # Redis服务主机名
      QGSWPS_PROCESSING_PROVIDERS_MODULE_PATH: /processing  # 处理算法提供者路径
      QGSWPS_CACHE_ROOTDIR: /projects       # 缓存根目录
      QGSWPS_SERVER_WORKDIR: /srv/data      # 服务器工作目录（结果存储）
      QGSWPS_USER: {uid}:{gid}              # 运行用户ID和组ID
      QGSWPS_LOGLEVEL: DEBUG                # 日志级别（DEBUG/INFO/WARNING/ERROR）
    volumes:
      - /path/to/processing:/processing     # 挂载处理算法提供者目录
      - /path/to/projects:/projects         # 挂载QGIS项目目录
      - /path/to/processing/output/dir:/srv/data  # 挂载处理结果输出目录
      - /path/to/qgis/home:/home/qgis       # 可选，挂载QGIS配置文件目录
    ports:
      - 127.0.0.1:8888:8080                 # 端口映射（主机:容器）
  redis:
      image: redis:5-alpine                 # Redis服务镜像，用于日志和结果存储

配置说明

卷挂载要求

• /path/to/projects: 必须包含QGIS项目文件，作为处理算法的工作项目
• /path/to/processing: 包含处理算法提供者、脚本或模型，作为WPS服务的可用进程
• /path/to/processing/output/dir: 存储算法执行后的结果数据
• /path/to/qgis/home: 可选，可包含QGIS配置文件，用于自定义QGIS运行环境

环境变量配置

用户权限设置

需将{uid}:{gid}替换为挂载卷的实际所有者和组ID，确保服务有权限访问挂载的目录和文件。可通过id命令获取当前用户的UID和GID。

Redis服务

Redis服务用于存储日志和异步任务结果状态。若不提供Redis服务，将使用fakeredis服务，但不支持容器重启后的结果状态持久化。

参考资料

• WPS源代码、Dockerfile及更多文档：https://github.com/3liz/py-qgis-wps