sourcepole/qwc-map-viewer-demo

QWC地图查看器演示镜像

镜像概述和主要用途

QWC地图查看器演示镜像是QWC（QGIS Web Client）服务套件的一部分，提供预配置的演示环境，用于快速展示QWC地图查看器的核心功能和使用方式。该镜像简化了环境搭建流程，方便用户直观体验地图浏览、图层控制等基础功能。

核心功能和特性

• 地图浏览功能：支持基础地图操作（缩放、平移、图层切换）
• 演示环境预配置：内置示例数据和服务配置，无需额外设置即可启动
• 轻量级部署：基于Docker容器化设计，部署简单，资源占用低
• QWC服务集成：展示与QWC生态其他服务组件的协同工作能力

使用场景和适用范围

• 功能演示：向用户或客户展示QWC地图查看器的基础功能
• 技术评估：开发团队快速评估QWC地图服务是否满足项目需求
• 学习研究：开发者通过演示环境学习QWC服务架构和配置方式
• 原型验证：作为项目原型开发的基础镜像，加速验证流程

使用方法和配置说明

基本部署命令

通过以下命令快速启动演示容器：

bash
docker run -d -p 8080:80 --name qwc-map-viewer-demo qwc-services/qwc-map-viewer

参数说明：

• -d：后台运行容器
• -p 8080:80：将容器内80端口映射到主机8080端口（可根据需要修改主机端口）
• --name qwc-map-viewer-demo：指定容器名称，便于管理

访问演示界面

容器启动后，通过浏览器访问以下地址打开演示界面：

http://localhost:8080

自定义配置（可选）

环境变量配置

可通过-e参数设置环境变量调整演示行为：

示例（使用自定义地图项目）：

bash
docker run -d -p 8080:80 -e MAP_PROJECT=custom --name qwc-map-viewer-demo qwc-services/qwc-map-viewer

挂载自定义配置文件

如需使用自定义配置，可通过-v参数挂载本地配置目录：

bash
docker run -d -p 8080:80 -v ./local-config:/app/config --name qwc-map-viewer-demo qwc-services/qwc-map-viewer

注：配置文件格式和内容请参考https://github.com/qwc-services/qwc-map-viewer

注意事项

• 该镜像仅用于演示和评估目的，不建议直接用于生产环境
• 生产环境部署请参考https://github.com/qwc-services/qwc-map-viewer%E8%BF%9B%E8%A1%8C%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE
• 如需持久化数据或自定义配置，建议通过-v参数挂载本地目录

参考链接

• https://github.com/qwc-services/qwc-map-viewer
• https://github.com/qwc-services