ideaplexus/postgis

POSTGIS 镜像文档

镜像概述和主要用途

本镜像基于PostgreSQL官方镜像构建，扩展集成了PostGIS空间数据库扩展、PGRouting路由引擎及其他地理空间工具，适用于需要处理空间数据的应用场景。镜像源代码托管于GitLab仓库，镜像名称为ideaplexus/postgis。

核心功能和特性

基础环境

• Alpine版本：3.23
• 支持的PostgreSQL版本：18、17、16、15、14

集成组件版本

• libpqxx：8.0.0
• geos：3.14.1
• gdal：3.12.2
• cgal：6.1.1
• sfcgal：2.2.0
• proj4：9.8.0
• postgis：3.6.2
• pgrouting：4.0.1
• osm2pgsql：2.2.0
• osm2pgrouting：3.0.0

使用场景和适用范围

• 地理信息系统（GIS）应用开发与部署
• 空间数据分析与处理
• 地图服务后端数据库
• OpenStreetMap（OSM）数据导入与管理
• 基于位置的服务（LBS）系统

使用方法和配置说明

基础使用

本镜像基于PostgreSQL官方镜像构建，基本使用方法可参考PostgreSQL官方文档：https://github.com/docker-library/docs/blob/master/postgres/README.md%E3%80%82

初始化脚本

• 镜像包含默认初始化脚本：/docker-entrypoint-initdb.d/postgis.sh，用于在数据库初始化时自动配置PostGIS扩展。

版本更新工具

提供/usr/local/bin/update-postgis.sh脚本，可用于更新现有PostgreSQL数据库中的PostGIS扩展至最新版本。

部署示例

Docker Run命令

bash
docker run -d \
  --name postgis \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_DB=spatialdb \
  -p 5432:5432 \
  ideaplexus/postgis:16

Docker Compose配置

yaml
version: '3'
services:
  postgis:
    image: ideaplexus/postgis:16
    container_name: postgis
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: postgres
      POSTGRES_DB: spatialdb
    ports:
      - "5432:5432"
    volumes:
      - postgis_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgis_data:

注意事项

• 首次启动时，初始化脚本会自动创建PostGIS扩展，无需手动执行CREATE EXTENSION命令
• 使用update-postgis.sh前需确保数据库已启动且可访问
• 根据需求选择合适的PostgreSQL版本标签（如:16、:15等）