optimadata/postgis

PostgreSQL PostGis 容器镜像

镜像概述和主要用途

PostgreSQL PostGis容器镜像是基于官方PostgreSQL镜像构建的专用容器，预集成了PostGIS空间扩展。该镜像旨在简化需要空间数据支持的应用部署，提供开箱即用的空间数据库功能，支持地理信息存储、查询和分析。

核心功能和特性

• 完整PostgreSQL支持：基于官方PostgreSQL镜像，保留所有标准数据库功能
• PostGIS扩展集成：预安装PostGIS扩展，支持空间数据类型（Geometry、Geography）和地理信息函数
• 版本兼容性：提供多个PostgreSQL版本标签（如12-postgis、14-postgis等），适配不同应用需求
• 灵活配置：支持通过环境变量自定义数据库用户、密码、数据库名称等
• 数据持久化：支持数据卷挂载，确保容器重启后数据不丢失
• 轻量级部署：优化镜像大小，适合开发、测试和生产环境快速部署

使用场景和适用范围

• 地理信息系统（GIS）应用开发与部署
• 位置服务应用（如地图服务、位置查询系统）
• 空间数据分析与可视化平台
• 需要存储和处理地理空间数据的Web应用
• 开发/测试环境中空间数据库的快速搭建

使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name postgres-postgis \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=gis_user \
  -e POSTGRES_DB=gis_db \
  -v postgres_gis_data:/var/lib/postgresql/data \
  -p 5432:5432 \
  postgres:14-postgis

环境变量配置

数据持久化配置

通过Docker数据卷实现数据持久化，避免容器删除导致数据丢失：

bash
# 创建专用数据卷
docker volume create postgres_gis_data

# 使用数据卷运行容器
docker run -d \
  --name postgres-postgis \
  -e POSTGRES_PASSWORD=your_secure_password \
  -v postgres_gis_data:/var/lib/postgresql/data \
  -p 5432:5432 \
  postgres:14-postgis

Docker Compose 配置示例

yaml
version: '3.8'
services:
  postgres-postgis:
    image: postgres:14-postgis
    container_name: postgres-postgis
    environment:
      POSTGRES_PASSWORD: your_secure_password
      POSTGRES_USER: gis_user
      POSTGRES_DB: gis_db
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
    volumes:
      - postgres_gis_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U gis_user -d gis_db"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  postgres_gis_data:

验证PostGIS安装

容器启动后，可通过以下步骤验证PostGIS是否正确安装：

bash
# 进入容器
docker exec -it postgres-postgis psql -U gis_user -d gis_db

# 在psql终端执行查询
SELECT postgis_version();

成功安装会返回类似以下结果：

            postgis_version             
---------------------------------------
 3.3.4 3.3.4 (3.3.4)
(1 row)

启用额外PostGIS扩展

如需使用PostGIS的额外功能（如拓扑、栅格等），可在数据库中手动启用：

sql
-- 启用拓扑扩展
CREATE EXTENSION postgis_topology;

-- 启用栅格扩展
CREATE EXTENSION postgis_raster;

-- 启用Tiger地理编码扩展
CREATE EXTENSION postgis_tiger_geocoder;