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 拉取镜像（具体地址需参考官方文档）：

docker pull camptocamp/mapserver:latest

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

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

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）

运行命令：

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 文件，定义服务、卷挂载和端口映射：

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）

启动服务：

docker-compose up -d

4. 配置说明

核心配置文件：MapFile

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

示例 MapFile（mymap.map）片段：

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

常用端口

• 80：默认 HTTP 服务端口（用于提供 WMS/WFS 等 HTTP 服务）。

环境变量（可选）

安全注意事项

• 生产环境中建议限制容器权限（如使用非 root 用户运行），并通过反向代理（如 Nginx）配置 HTTPS。
• 敏感数据（如数据库凭证）避免直接写入 MapFile，可通过环境变量或外部配置文件注入。
• 定期更新镜像以修复安全漏洞，参考官方安全文档：SECURITY.md。

参考链接

• 官方文档：GitHub - camptocamp/docker-mapserver
• MapServer 官方网站：[***]
• MapFile 语法指南：MapFile Reference