bursakomisi/postgres

PostgreSQL 17 with PostGIS 镜像文档

镜像概述

本镜像基于官方PostgreSQL 17基础镜像构建，预安装并启用了PostGIS 3扩展。PostGIS是PostgreSQL的空间数据库扩展，提供地理信息系统（GIS）功能，支持地理空间数据类型、空间索引及空间分析操作，适用于需要处理地理位置数据的应用场景。

核心功能和特性

• 基础数据库功能：完整继承PostgreSQL 17的全部功能，包括ACID事务、复杂查询、JSON支持等
• PostGIS扩展：已预装postgis和postgresql-17-postgis-3包，支持：
  • 空间数据类型（如Geometry、Geography）
  • 空间索引（GiST、SP-GiST等）
  • 空间分析函数（距离计算、面积计算、缓冲区分析等）
  • 地理编码与坐标转换

使用场景

• 地理信息系统（GIS）应用开发与部署
• 位置服务后端数据库（如地图应用、物流追踪系统）
• 空间数据分析与可视化平台
• 需要存储和查询地理位置数据的Web应用

使用方法和配置说明

基本运行命令

bash
docker run -d \
  --name postgres17-postgis \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  postgres17-postgis

数据持久化

为避免数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name postgres17-postgis \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  -v /path/on/host:/var/lib/postgresql/data \
  postgres17-postgis

环境变量配置

支持PostgreSQL官方镜像的所有环境变量，主要包括：

• POSTGRES_USER：数据库超级用户名称（默认：postgres）
• POSTGRES_PASSWORD：超级用户密码（必填）
• POSTGRES_DB：初始化数据库名称（默认与POSTGRES_USER同名）
• PGDATA：数据库数据存储路径（默认：/var/lib/postgresql/data）

验证PostGIS安装

1. 进入容器：

   bash
   docker exec -it postgres17-postgis psql -U myuser -d mydb
   

2. 检查PostGIS扩展：

   sql
   SELECT postgis_version();
   

   若返回PostGIS版本信息（如3.4.0），表示安装成功。

3. 创建空间表示例：

   sql
   CREATE TABLE locations (
     id SERIAL PRIMARY KEY,
     name VARCHAR(100),
     geom GEOMETRY(Point, 4326)  -- WGS84坐标系的点类型
   );
   
   -- 添加空间索引
   CREATE INDEX locations_geom_idx ON locations USING GIST (geom);
   

镜像构建说明

本镜像基于以下Dockerfile构建：

dockerfile
FROM postgres:17
RUN apt-get update && apt-get install -y postgis postgresql-17-postgis-3

构建命令：docker build -t postgres17-postgis .