camptocamp/mapcache

MapCache

https://img.shields.io/docker/pulls/camptocamp/mapcache.svg](https://hub.docker.com/r/camptocamp/mapcache/)

https://travis-ci.org/camptocamp/docker-mapcache.svg](https://travis-ci.org/camptocamp/docker-mapcache)

镜像概述和主要用途

MapCache是一款实现瓦片缓存的服务器，旨在加速对WMS（Web地图服务）图层的访问。其主要目标是提供快速且易于部署的解决方案，同时具备瓦片缓存所需的核心功能及更多扩展特性。

有关更多信息，请参见MapCache仓库：https://github.com/mapserver/mapcache

核心功能和特性

• 瓦片缓存：实现对WMS图层的瓦片缓存，显著提升地图数据访问速度
• 快速部署：通过Docker容器化部署，简化安装和配置流程
• 核心功能完备：提供瓦片缓存解决方案所需的基本功能及扩展特性
• 灵活性：支持通过配置文件自定义缓存策略和图层设置

使用场景和适用范围

适用于需要加速WMS图层访问的场景，包括但不限于：

• 地图服务提供商
• 地理信息系统（GIS）应用
• 需要高效访问地图瓦片的Web应用
• 地图数据分发系统

安装方法

bash
$ git clone https://github.com/camptocamp/docker-mapcache.git
$ docker build -t camptocamp/mapcache .

使用方法

运行MapCache服务

基本命令：

bash
# 启动MapCache容器（后台运行，映射端口8281到容器80端口，挂载瓦片目录和配置文件）
$ docker run -d -p 8281:80 -v /path/to/tiles:/var/sig/tiles -v /path/to/config.xml:/mapcache/config.xml --name mapcache camptocamp/mapcache

# 启动已创建的容器
$ docker start mapcache

# 停止容器
$ docker stop mapcache

参数说明：

• -d：后台运行容器
• -p 8281:80：将主机8281端口映射到容器80端口（MapCache服务端口）
• -v /path/to/tiles:/var/sig/tiles：挂载主机瓦片存储目录到容器内的/var/sig/tiles
• -v /path/to/config.xml:/mapcache/config.xml：挂载主机MapCache配置文件到容器内的/mapcache/config.xml
• --name mapcache：指定容器名称为mapcache

运行mapcache_seed种子工具

用于预生成（种子化）地图瓦片，示例如下：

种子化配置文件中的google图层：

bash
$ docker run --rm -ti -v /path/to/tiles:/var/sig/tiles -v /path/to/config.xml:/mapcache/config.xml camptocamp/mapcache mapcache_seed -c /mapcache/config.xml -l google

参数说明：

• --rm：容器退出后自动删除
• -ti：交互式终端模式
• -l google：指定要种子化的图层名称（需在config.xml中定义）
• -c /mapcache/config.xml：指定配置文件路径

配置说明

MapCache的核心配置通过config.xml文件实现，需将该文件挂载到容器内的/mapcache/config.xml路径。配置文件中可定义缓存策略、图层信息、数据源等关键参数，具体配置方法参见MapCache官方文档。

瓦片存储目录需挂载到容器内的/var/sig/tiles，用于持久化存储生成的地图瓦片。

TODO

• 支持fastcgi
• 为MapCache构建添加可选参数