MapProxy Docker镜像文档

镜像概述

该Docker镜像用于运行MapProxy，一个功能强大的WMS服务代理和缓存工具，可实现地图服务的配置管理、请求转发和瓦片缓存优化。

核心功能与特性

• WMS服务代理：转发和处理WMS请求，支持多源服务聚合
• 配置管理：提供默认配置文件，支持用户自定义服务定义
• 瓦片缓存：自动缓存WMS瓦片至本地文件系统
• 持久化存储：支持外部卷挂载，确保配置和缓存数据持久化
• 灵活部署：可独立运行或通过docker-compose集成QGIS Server与nginx反向代理

使用场景

适用于需要部署WMS服务代理、优化地图瓦片加载速度、管理多源地图服务的GIS应用环境，如WebGIS服务器、地图数据分发系统等。

获取镜像

拉取官方镜像（推荐）

通过Docker可信构建直接拉取：

docker pull kartoza/mapproxy

手动构建镜像

从GitHub仓库构建

docker build -t kartoza/mapproxy git://github.com/kartoza/docker-mapproxy

本地源码构建

1. 克隆代码仓库：

   git clone git://github.com/kartoza/docker-mapproxy
   

2. 进入目录并构建：

   cd docker-mapproxy
   docker build -t kartoza/mapproxy .
   

使用方法

基本运行

启动基础MapProxy容器：

docker run --name "mapproxy" -p 8080:8080 -d -t kartoza/mapproxy

持久化配置（推荐）

挂载本地目录以持久化配置文件和缓存数据：

# 创建本地配置目录
mkdir mapproxy

# 启动容器并挂载卷
docker run --name "mapproxy" -p 8080:8080 -d -t -v $(pwd)/mapproxy:/mapproxy kartoza/mapproxy

配置说明

• 首次运行时，默认配置文件将自动生成到./mapproxy目录
• 配置文件修改后需重启容器生效：docker restart mapproxy
• 缓存瓦片默认存储路径：./mapproxy/cache_data（可通过mapproxy.yaml自定义）

权限注意事项

容器进程使用UID:GID 1000:10001运行，挂载现有目录时需设置权限：

chown -R 1000:10001 ./mapproxy

docker-compose配置

支持通过docker-compose实现多服务集成，可链接QGIS Server容器与nginx反向代理，web目录中提供index.html用于图层预览。

反向代理配置

容器支持uwsgi协议，可配合nginx实现反向代理：

• nginx接收HTTP请求并转换为uwsgi协议转发至MapProxy
• 默认配置使用http socket，可通过docker-compose实现容器间自动链接与请求头配置

访问服务

服务启动后，通过以下URL访问MapProxy服务（假设映射至本地8080端口）：

http://localhost/mapproxy/service/

详细配置请参考MapProxy官方文档。