3liz/qgis-map-server

Qgis HTTP/OWS服务器

概述

这是一个基于Tornado框架用Python编写的异步HTTP服务器，用于运行完整的Qgis 3 HTTP/OWS服务。该服务器可作为独立的单一服务运行，或作为代理服务器与任意数量的本地或远程工作节点协同工作。独立工作节点会自动连接到前端代理，无需在代理端进行特殊配置，因此非常适合在Rancher、Swarm或Kubernetes等容器编排平台中实现自动扩展配置。

核心功能与特性

• 基于Tornado框架的异步HTTP处理，高效响应请求
• 支持两种运行模式：独立服务模式或代理服务器模式
• 工作节点自动发现并连接前端代理，无需代理端额外配置
• 可通过环境变量灵活配置工作节点数量、日志级别、缓存策略等
• 适配容器编排环境，支持自动扩展，满足动态负载需求

使用场景

适用于需要部署Qgis 3地图服务的地理信息系统（GIS）项目，尤其适合对高可用性和动态扩展有需求的场景。可在Rancher、Swarm、Kubernetes等容器编排平台中部署，为多用户提供稳定的地图数据HTTP/OWS服务。

使用方法

快速启动示例

通过以下命令启动服务器，挂载本地Qgis项目目录并配置基础参数：

bash
docker run -p 8080:8080 \
       -v /path/to/qgis/projects:/projects \
       -e QGSRV_SERVER_WORKERS=2 \
       -e QGSRV_LOGGING_LEVEL=DEBUG  \
       -e QGSRV_CACHE_ROOTDIR=/projects \
       -e QGSRV_CACHE_SIZE=10 \
       3liz/qgis-map-server

参数说明：

• -p 8080:8080：将容器8080端口映射到主机8080端口，暴露服务访问入口
• -v /path/to/qgis/projects:/projects：挂载本地Qgis项目目录到容器内/projects路径（需将/path/to/qgis/projects替换为实际项目目录）
• 环境变量：通过-e参数配置服务运行参数，如工作节点数量、日志级别等

环境变量配置

参考链接

• HTTP服务器源码：https://github.com/3liz/py-qgis-server