pg_tileserv Docker镜像文档

1. 镜像概述和主要用途

本镜像为pg_tileserv的Docker容器化版本，基于最新提交构建（Latest CI build result）。pg_tileserv是一个轻量级服务，主要用途是从PostgreSQL数据库（需包含PostGIS扩展）提供地图瓦片服务，支持通过HTTP接口快速发布空间数据瓦片，便于集成到Web地图应用或GIS系统中。

2. 核心功能和特性

• 瓦片服务能力：提供地图瓦片生成与分发功能，支持标准地图瓦片请求格式。
• PostgreSQL集成：直接连接PostgreSQL数据库，利用PostGIS扩展处理空间数据，无需额外数据导出步骤。
• 便捷部署：通过Docker容器化封装，简化依赖配置，支持快速启动和横向扩展。
• RESTful API：提供HTTP接口，支持瓦片数据请求及元数据查询，兼容主流地图客户端（如Leaflet、OpenLayers）。

3. 使用场景和适用范围

• Web地图应用：为前端地图组件提供瓦片数据源，适用于交互式Web地图展示。
• GIS系统集成：作为中间层，将PostgreSQL中的空间数据以瓦片形式集成到GIS系统。
• 空间数据可视化：快速部署瓦片服务，实现PostgreSQL空间数据的可视化展示与共享。
• 开发与测试环境：便捷搭建临时瓦片服务，用于功能验证、演示或开发调试。

4. 使用方法和配置说明

4.1 基本运行命令

通过docker run直接启动容器，需指定数据库连接信息和端口映射：

bash
docker run -dt \
  -e DATABASE_URL=postgresql://user:pass@host/dbname \
  -p 7800:7800 \
  pramsey/pg_tileserv:latest-amd64

参数说明：

• -d：后台运行容器。
• -t：为容器分配伪终端，确保日志输出正常。
• -e DATABASE_URL=...：设置数据库连接环境变量（必填），格式为postgresql://<用户名>:<密码>@<主机地址>:<端口>/<数据库名>（默认端口5432可省略）。
• -p 7800:7800：端口映射，将容器内7800端口（服务默认端口）映射到主机7800端口，用于外部访问。

4.2 Docker Compose配置示例

创建docker-compose.yml文件，实现更灵活的服务编排（如与数据库联动）：

yaml
version: '3'
services:
  pg_tileserv:
    image: pramsey/pg_tileserv:latest-amd64
    container_name: pg_tileserv
    restart: unless-stopped  # 异常退出后自动重启
    environment:
      - DATABASE_URL=postgresql://gis_user:gis_pass@pg_db:5432/gis_db  # 数据库连接信息（替换为实际值）
    ports:
      - "7800:7800"  # 主机端口:容器端口
    networks:
      - gis_network  # 与数据库共享网络（若数据库在同一Docker网络内，可使用容器名作为host）

  # 示例：若PostgreSQL数据库也通过Docker部署，可添加以下配置
  pg_db:
    image: postgis/postgis:latest  # 带PostGIS扩展的PostgreSQL镜像
    container_name: pg_db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=gis_user
      - POSTGRES_PASSWORD=gis_pass
      - POSTGRES_DB=gis_db
    volumes:
      - pg_data:/var/lib/postgresql/data
    networks:
      - gis_network

networks:
  gis_network:
    driver: bridge

volumes:
  pg_data:

启动服务：

bash
docker-compose up -d  # 后台启动所有服务

4.3 核心配置说明

环境变量

服务访问

服务启动后，通过 http://<主机IP>:7800 访问，可获取瓦片数据及API文档（具体接口参见***文档）。

5. 补充信息

• GitHub仓库：[***]
• 文档：[]

（注：具体功能细节、高级配置及API说明请参考***文档。）