QGIS Server Docker 镜像文档

镜像概述

QGIS Server Docker 镜像是用于部署 QGIS Server 的容器化解决方案。QGIS Server 是一款开源地图服务器，基于 QGIS 桌面应用程序构建，能够将 QGIS 项目文件（.qgs/.qgz）发布为标准化 Web 地图服务，支持多平台快速部署与集成。

核心功能与特性

• 标准化服务支持：兼容 OGC 标准，提供 WMS（Web 地图服务）、WFS（Web 要素服务）、WCS（Web 覆盖服务）等。
• QGIS 项目兼容：直接使用 QGIS 桌面版创建的项目文件作为配置源，无需额外转换。
• 轻量容器化：通过 Docker 封装，简化依赖管理，支持在 Linux、Windows、macOS 等系统中一致运行。
• 灵活配置：支持通过环境变量、挂载卷或配置文件自定义服务参数，满足不同场景需求。

使用场景与适用范围

• Web 地图发布：将地理数据以标准化服务形式发布，供 Web 应用、移动端调用。
• GIS 系统集成：作为后端服务集成到企业级地理信息系统（GIS）中，提供地图渲染与数据访问能力。
• 开发与测试：快速搭建本地地图服务环境，用于 WebGIS 应用的开发、测试与演示。

使用方法与配置说明

前提条件

• 已安装 Docker 引擎（参考 Docker ***安装文档）。
• 准备 QGIS 项目文件（.qgs 或 .qgz 格式）及相关地理数据。

基本部署示例

1. 启动容器（基础命令）

bash
docker run -d -p 80:80 \
  -v /本地路径/qgis项目:/etc/qgis-server/projects \
  camptocamp/qgis-server

• -p 80:80：将容器内 80 端口映射到主机 80 端口（可根据需求修改主机端口）。
• -v /本地路径/qgis项目:/etc/qgis-server/projects：挂载本地 QGIS 项目目录到容器内默认项目路径。

2. 访问服务

容器启动后，通过以下 URL 访问服务（假设项目文件名为 my_map.qgs）：

• WMS 能力文档：http://localhost/ogc/my_map?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities

详细文档与安全信息

完整配置说明、高级用法及版本更新日志，请参考***文档：
GitHub 项目文档

安全漏洞报告、安全策略及合规信息，请查阅：
安全说明

关键配置参数