MapServer Docker 镜像文档

镜像概述和主要用途

MapServer Docker 镜像是基于开源地理信息系统（GIS）服务器 MapServer 的容器化部署方案。该镜像旨在简化 MapServer 的安装、配置和运行流程，提供跨平台、隔离化的地图服务部署环境。主要用途包括地理空间数据发布、Web 地图服务（如 WMS/WFS/WCS）提供、地图可视化及空间数据分析等场景。

核心功能和特性

核心功能

支持多种地理数据格式：兼容 Shapefile、GeoTIFF、PostGIS、Oracle Spatial 等主流空间数据格式。
标准地图服务协议：实现 OGC 标准服务（WMS 1.3.0、WFS 2.0、WCS 2.0），支持地图渲染、要素查询和数据下载。
灵活的地图样式配置：通过 MapFile（文本配置文件）定义图层样式、符号、标签、比例尺等渲染规则。
高性能渲染：优化地图瓦片生成和动态地图渲染，支持多线程处理。

镜像特性

容器化部署：轻量级、跨平台（Linux/macOS/Windows），环境隔离，避免依赖冲突。
配置简化：支持挂载自定义 MapFile 和数据卷，无需修改镜像内部文件即可更新配置。
即开即用：预配置基础运行环境，可快速启动服务并验证功能。
可扩展性：支持与 Nginx、Apache 等 Web 服务器集成，构建高可用地图服务集群。

使用场景和适用范围

典型使用场景

WebGIS 应用后端：为前端地图应用（如 OpenLayers、Leaflet）提供 WMS/WFS 服务。
地图服务发布：快速部署标准化地理数据服务，供第三方系统调用。
GIS 开发测试：在隔离环境中调试 MapFile 配置或测试数据兼容性。
数据可视化项目：结合地图渲染功能展示空间数据分布特征。

适用对象

GIS 开发人员、Web 地图服务维护者。
需要快速部署地图服务的中小企业或团队。
地理信息教学、科研项目中的临时服务环境搭建。

详细使用方法和配置说明

前提条件

已安装 Docker Engine（20.10+）或 Docker Desktop。
熟悉 MapFile 配置语法（可选，用于自定义地图服务）。

1. 获取镜像

从 Docker Hub 或 GitHub Container Registry 拉取镜像（具体地址需参考***文档）：

bash
docker pull camptocamp/mapserver:latest

2. 基本运行命令（`docker run`）

最简启动（使用默认配置）

bash
docker run -d -p 80:80 --name mapserver camptocamp/mapserver:latest

-d：后台运行容器。
-p 80:80：将容器内 80 端口映射到主机 80 端口（MapServer 默认 HTTP 端口）。
--name mapserver：指定容器名称为 mapserver。

启动后，访问 http://localhost 可验证服务是否正常（默认可能返回示例地图或服务列表）。

挂载自定义配置和数据

MapServer 的核心配置通过 MapFile 定义，需将本地配置文件和数据挂载到容器内。假设本地目录结构如下：

./mapserver/
├── mapfiles/       # 存放 MapFile 文件（如 mymap.map）
└── data/           # 存放地理数据（如 Shapefile、GeoTIFF）

运行命令：

bash
docker run -d \
  -p 8080:80 \
  --name mapserver \
  -v $(pwd)/mapserver/mapfiles:/etc/mapserver/mapfiles \
  -v $(pwd)/mapserver/data:/etc/mapserver/data \
  camptocamp/mapserver:latest \
  sh -c "mapserver -k 'REQUEST=GetCapabilities&SERVICE=WMS&VERSION=1.3.0' /etc/mapserver/mapfiles/mymap.map"

-v $(pwd)/mapserver/mapfiles:/etc/mapserver/mapfiles：挂载本地 MapFile 目录到容器内配置目录。
-v $(pwd)/mapserver/data:/etc/mapserver/data：挂载本地数据目录到容器内数据目录。
最后一行命令指定启动时加载自定义 MapFile（mymap.map）并验证 WMS 服务能力。

3. `docker-compose` 配置示例

创建 docker-compose.yml 文件，定义服务、卷挂载和端口映射：

yaml
version: '3.8'
services:
  mapserver:
    image: camptocamp/mapserver:latest
    container_name: mapserver
    ports:
      - "8080:80"  # 主机端口:容器端口
    volumes:
      - ./mapserver/mapfiles:/etc/mapserver/mapfiles:ro  # 只读挂载配置文件
      - ./mapserver/data:/etc/mapserver/data:ro          # 只读挂载数据文件
      - ./mapserver/logs:/var/log/mapserver              # 挂载日志目录（可选）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）
    environment:
      - TZ=Asia/Shanghai     # 设置时区（可选）
      - LOG_LEVEL=INFO       # 设置日志级别（可选，如 DEBUG/INFO/WARN/ERROR）

启动服务：

bash
docker-compose up -d

4. 配置说明

核心配置文件：MapFile

MapFile 是 MapServer 的核心配置文件，定义地图图层、数据源、投影、样式等。需将自定义 MapFile 挂载到容器内的 /etc/mapserver/mapfiles 目录，并通过启动命令或环境变量指定加载路径。

示例 MapFile（mymap.map）片段：

mapfile
MAP
  NAME "MyMap"
  EXTENT -180 -90 180 90  # 全球范围
  SIZE 800 600
  PROJECTION
    "init=epsg:4326"  # WGS84 坐标系
  END
  LAYER
    NAME "Countries"
    TYPE POLYGON
    DATA "/etc/mapserver/data/countries.shp"  # 容器内数据路径
    CLASS
      STYLE
        COLOR 240 240 240  # 背景色
        OUTLINECOLOR 0 0 0  # 边界色
      END
    END
  END
END