gospatial/tegola

Tegola Docker镜像文档

镜像概述和主要用途

Tegola是一个用Go语言编写的高性能Mapbox矢量瓦片（MVT）服务器，旨在提供高效的地理空间数据矢量瓦片服务。它支持多种地理数据源（如PostGIS数据库、GeoPackage文件），可通过灵活的配置满足不同地图渲染和地理信息系统（GIS）应用的需求，适用于Web地图、移动地图应用及GIS数据可视化等场景。

核心功能和特性

• 高性能：基于Go语言开发，具备高效的并发处理能力和低资源占用
• 标准兼容：完全符合Mapbox矢量瓦片规范，可与主流地图库（如Mapbox GL JS）无缝集成
• 多数据源支持：兼容PostGIS空间数据库、GeoPackage（GPKG）文件等多种地理数据格式
• 灵活配置：支持本地文件配置和HTTP远程配置两种方式，便于不同部署环境使用
• 轻量部署：通过Docker容器化部署，简化环境配置和版本管理

使用场景和适用范围

适用于需要提供地理空间矢量瓦片服务的各类应用场景，包括但不限于：

• Web地图服务：为Web端地图应用提供底层矢量瓦片数据
• 移动地图应用：支持移动端地图渲染的高效瓦片服务
• 地理信息系统（GIS）：为GIS平台提供数据可视化所需的矢量瓦片
• 地理数据分发：高效分发大规模地理空间数据，降低网络传输成本

使用方法和配置说明

显示命令行选项

如需查看Tegola支持的所有命令行参数，可运行以下命令：

bash
docker run --rm docker.xuanyuan.run/tegola -h

基于HTTP配置的PostGIS使用

通过HTTP远程配置文件连接PostGIS数据源并启动服务：

bash
docker run -p 8080 docker.xuanyuan.run/tegola --config http://my-domain.com/config serve

说明：将http://my-domain.com/config替换为实际的远程配置文件URL

基于本地配置的PostGIS使用

通过本地配置文件连接PostGIS数据源的步骤：

1. 创建本地配置目录：

   bash
   mkdir docker-config
   

2. 将本地配置文件复制到配置目录：

   bash
   cp my-config-file docker-config/config.toml
   

3. 启动容器并挂载配置目录：

   bash
   docker run -v /path/to/docker-config:/opt/tegola_config -p 8080 docker.xuanyuan.run/tegola serve --config /opt/tegola_config/config.toml
   

注意：将/path/to/docker-config替换为实际的本地配置目录绝对路径

GeoPackage（GPKG）文件使用

使用本地GeoPackage文件作为数据源的步骤：

1. 创建本地配置目录：

   bash
   mkdir docker-config
   

2. 复制配置文件到配置目录：

   bash
   cp my-config-file docker-config/config.toml
   

3. 复制GeoPackage文件到配置目录：

   bash
   cp my-db.gpkg docker-config/
   

4. 编辑配置文件docker-config/config.toml，将数据源路径设置为容器内路径：/opt/tegola_config/my-db.gpkg
5. 启动容器并挂载配置目录：

   bash
   docker run -v /path/to/docker-config:/opt/tegola_config -p 8080 docker.xuanyuan.run/tegola serve --config /opt/tegola_config/config.toml
   

注意：确保配置文件中GPKG文件路径与容器内挂载路径一致，且本地配置目录路径需替换为实际路径