sourcepole/qwc-qgis-server

QWC QGIS Server

镜像概述

QWC QGIS Server是QWC（QGIS Web Client）服务套件的核心组件，基于开源QGIS Server构建，专注于提供稳定、高效的Web地图服务。作为QWC生态的关键部分，该镜像集成了QGIS Server的地图渲染能力与QWC服务的协同特性，可快速部署为WebGIS系统的地图服务后端，支持标准地理信息服务协议，满足各类Web地图应用的服务需求。

核心功能与特性

• 标准协议支持：全面兼容OGC标准，包括WMS（Web Map Service）、WFS（Web Feature Service）、WCS（Web Coverage Service），确保与主流GIS客户端的互操作性。
• 高性能地图渲染：基于QGIS引擎，支持复杂地图样式、符号化、标注及空间分析结果可视化，输出高质量地图图像。
• QWC生态集成：与QWC服务套件其他组件（如qwc-ogc-service、qwc-map-viewer、qwc-data-service）无缝协作，构建完整WebGIS解决方案。
• 灵活配置能力：支持自定义QGIS项目路径、服务端口、日志级别、并发线程数等参数，适应不同部署场景需求。
• 容器化部署：通过Docker镜像简化部署流程，可在Linux、Windows、macOS等操作系统的Docker环境中快速启动，降低环境依赖复杂度。

使用场景与适用范围

• 企业级WebGIS系统：为***、国土、规划、环境等领域的WebGIS应用提供稳定的地图服务支撑。
• 地图服务发布平台：将QGIS桌面项目快速发布为Web服务，供前端应用或第三方系统调用。
• 地理数据共享：通过标准化协议（WMS/WFS）实现地理空间数据的跨平台共享与集成。
• 开发与测试环境：为QWC服务套件的二次开发、功能测试提供标准化的地图服务环境。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动容器，提供基础地图服务：

bash
docker run -d \
  --name qwc-qgis-server \
  -p 8000:80 \
  -v /path/to/local/qgis/projects:/etc/qgis/projects \
  docker.xuanyuan.run/qwc-services/qwc-qgis-server

参数说明：

• -p 8000:80：端口映射，将容器内80端口（默认服务端口）映射到主机8000端口，通过http://localhost:8000访问服务。
• -v /path/to/local/qgis/projects:/etc/qgis/projects：挂载本地QGIS项目目录，容器通过该路径读取地图项目文件（.qgs/.qgz格式）。

Docker Compose集成

在QWC服务套件部署中，通常与其他组件协同工作，以下是典型的docker-compose.yml配置片段：

yaml
version: '3'
services:
  qgis-server:
    image: docker.xuanyuan.run/qwc-services/qwc-qgis-server
    container_name: qwc-qgis-server
    ports:
      - "8000:80"
    volumes:
      - ./qgis-projects:/etc/qgis/projects  # 本地QGIS项目目录
      - ./qgis-cache:/var/cache/qgis-server  # 可选，地图缓存目录
    environment:
      - QGIS_SERVER_LOG_LEVEL=0  # 日志级别：0=info, 1=warning, 2=error, 3=critical
      - QGIS_PROJECTS_PATH=/etc/qgis/projects  # 项目文件路径（容器内）
      - MAX_THREADS=8  # 并发线程数，根据服务器CPU核心数调整
      - QGIS_SERVER_TIMEOUT=60  # 服务超时时间（秒）
    restart: unless-stopped

核心配置参数

通过环境变量或配置文件调整服务行为，常用参数如下：

服务验证与测试

服务启动后，可通过以下URL验证运行状态（替换localhost:8000为实际部署地址）：

• 获取服务能力元数据（WMS）：
  http://localhost:8000/wms?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities

• 访问特定项目服务：
  若挂载的项目目录中存在my_project.qgz，可通过http://localhost:8000/ows/my_project?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities获取该项目的服务元数据。

注意事项

• 项目文件权限：确保挂载的QGIS项目文件及目录对容器内运行用户（通常为www-data）有读取权限，避免因权限问题导致服务无法加载项目。
• 性能优化：高并发场景下，建议调整MAX_THREADS参数（一般设置为CPU核心数的1-2倍），并考虑启用地图缓存（通过挂载缓存目录实现）。
• 生产环境配置：生产环境中建议结合反向代理（如Nginx）使用，实现负载均衡、SSL终止、请求过滤等功能，提升服务安全性与可用性。
• 版本兼容性：QWC QGIS Server版本需与QWC套件其他组件版本匹配，具体参考官方文档：https://github.com/qwc-services/qwc-qgis-server