TileServer GL (轻量版) 镜像文档

概述

TileServer GL (轻量版) 是TileServer GL的简化版本，专注于提供矢量瓦片服务，移除了服务器端按需将矢量瓦片光栅化为栅格瓦片的功能。该镜像旨在以更低的资源占用提供核心矢量瓦片服务能力，适用于仅需矢量瓦片分发或前端自行渲染矢量瓦片的场景。

核心功能与特性

核心功能

• 提供MBTiles格式矢量瓦片的HTTP服务
• 支持矢量瓦片元数据查询与分发
• 内置基础Web界面用于瓦片预览

主要特性

• 轻量级设计：相比完整版TileServer GL，资源占用更低，启动速度更快
• 功能聚焦：仅保留矢量瓦片服务核心功能，移除服务器端光栅化模块
• 兼容性：支持标准MBTiles矢量瓦片格式
• 易于部署：无需复杂配置即可快速启动矢量瓦片服务

使用场景

• 前端渲染矢量瓦片的Web应用：适合前端通过MapLibre GL JS、Leaflet等库自行渲染矢量瓦片的场景
• 资源受限环境：在低配置服务器或边缘计算设备上部署矢量瓦片服务
• 矢量瓦片分发服务：作为后端服务向客户端提供原始矢量瓦片数据
• 开发与测试环境：快速搭建本地矢量瓦片服务进行应用开发测试

使用方法

基本部署

前提条件

• 已安装Docker引擎
• 准备MBTiles格式的矢量瓦片文件（如data.mbtiles）

启动容器

通过以下命令启动容器，将本地MBTiles文件挂载至容器并暴露服务端口：

docker run -d \
  -p 8080:8080 \
  -v $(pwd)/tiles:/data \
  --name tileserver-gl-light \
  maptiler/tileserver-gl-light

参数说明：

• -p 8080:8080：将容器的8080端口映射到主机的8080端口
• -v $(pwd)/tiles:/data：将主机当前目录下的tiles文件夹挂载至容器的/data目录（存放MBTiles文件）
• --name tileserver-gl-light：指定容器名称
• maptiler/tileserver-gl-light：镜像名称

访问服务

容器启动后，可通过以下地址访问服务：

• 矢量瓦片服务：http://localhost:8080/data/{z}/{x}/{y}.mvt（具体路径取决于MBTiles配置）
• 预览界面：http://localhost:8080

配置说明

默认情况下，镜像会自动检测/data目录下的MBTiles文件并创建服务。如需自定义配置，可在/data目录下创建config.json文件，示例配置：

{
  "options": {
    "paths": {
      "root": "/data"
    }
  },
  "data": {
    "mytiles": {
      "mbtiles": "data.mbtiles"
    }
  }
}

注意事项

• 不支持栅格瓦片输出：由于移除了服务器端光栅化功能，无法将矢量瓦片转换为PNG/JPEG等栅格瓦片
• 性能优化：建议为MBTiles文件启用适当的压缩以提升传输效率
• 资源限制：根据瓦片数据量调整容器内存限制，避免因内存不足导致服务异常