openmaptiles/postgis-preloaded

预加载地理空间数据的PostGIS镜像

镜像概述和主要用途

本镜像为基于PostgreSQL+PostGIS的Docker镜像，预加载了lakelines、natural-earth及water data等核心地理空间数据集，旨在提供开箱即用的地理空间数据库环境。主要用途是加速开发/测试阶段的环境搭建，避免手动加载基础地理数据的耗时过程，帮助用户快速验证依赖地理空间数据的应用功能。

核心功能和特性

预加载数据集

• lakelines：包含全球主要湖泊轮廓数据
• natural-earth：提供基础地理要素数据（如国家边界、城市、地形等）
• water data：涵盖水系相关地理空间信息

数据库配置

• 数据库名称：openmaptiles
• 默认用户：openmaptiles
• 默认密码：openmaptiles
• 数据库引擎：PostgreSQL（集成PostGIS扩展，支持地理空间数据存储与查询）

使用场景和适用范围

适用场景

• 快速测试环境搭建：开发阶段需依赖基础地理数据验证功能时，无需手动下载、转换和加载数据
• 地理空间应用原型验证：快速构建包含基础地理要素的数据库环境，加速原型开发
• 教学/演示场景：用于地理信息系统（GIS）相关开发教学，或展示地理空间数据查询功能

不适用场景

• 生产环境：默认配置（如固定用户密码）存在安全风险，且预加载数据可能非最新或不完整
• 大规模数据处理：镜像定位为轻量测试环境，不适合承载高并发查询或大规模数据扩展

使用方法和配置说明

Docker Run 命令示例

通过以下命令快速启动镜像，映射容器内PostgreSQL默认端口（5432）至主机：

bash
docker run -d \
  --name postgis-preloaded \
  -p 5432:5432 \
  openmaptiles/postgis-preloaded:latest

参数说明：

• -d：后台运行容器
• --name：指定容器名称（示例中为postgis-preloaded）
• -p 5432:5432：将容器内5432端口映射至主机5432端口，允许主机通过localhost:5432访问数据库

Docker Compose 配置示例

如需与其他服务联动（如应用后端），可使用docker-compose.yml配置：

yaml
version: '3.8'
services:
  postgis:
    image: openmaptiles/postgis-preloaded:latest
    container_name: postgis-preloaded
    ports:
      - "5432:5432"
    # 可选：如需数据持久化，挂载主机目录至容器内PostgreSQL数据目录
    volumes:
      - ./pgdata:/var/lib/postgresql/data
    restart: unless-stopped

说明：

• volumes配置为可选，用于持久化数据库数据（默认容器内数据非持久化，容器删除后数据丢失）

数据库连接配置

启动容器后，可通过以下信息连接数据库：

• 主机：localhost（或容器IP）
• 端口：5432（若未修改端口映射）
• 数据库名称：openmaptiles
• 用户名：openmaptiles
• 密码：openmaptiles

连接示例（psql客户端）：

bash
psql -h localhost -p 5432 -U openmaptiles -d openmaptiles

配置参数说明