atomcream/postgis

PostgreSQL 13 with PostGIS 扩展 Docker 镜像

镜像概述

本Docker镜像基于PostgreSQL 13构建，预集成PostGIS扩展，提供开箱即用的地理空间数据处理能力。PostGIS是PostgreSQL的空间数据库扩展，支持地理对象存储、空间索引、空间查询等功能，适用于需要处理地理位置数据的应用场景。

核心功能与特性

• 基础环境：基于官方PostgreSQL 13镜像构建，确保数据库核心功能稳定可靠
• PostGIS支持：预安装并启用PostGIS扩展，支持地理空间数据类型（如Point、LineString、Polygon等）
• 空间功能：提供空间索引、距离计算、面积计算、空间关系判断等地理信息处理能力
• 兼容性：兼容PostgreSQL 13的所有原生功能，包括事务、ACID特性、JSON支持等
• 可扩展性：支持通过环境变量自定义数据库配置，满足不同应用需求

使用场景与适用范围

• 地理信息系统（GIS）应用开发与部署
• 位置服务应用（如地图服务、位置追踪系统）
• 空间数据分析与可视化平台
• 需要存储和查询地理位置数据的Web应用
• 地理空间数据科学研究与实验环境

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name postgres13-postgis \
  -p 5432:5432 \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=myspatialdb \
  -v postgres_data:/var/lib/postgresql/data \
  postgres:13-postgis

Docker Compose 配置示例

yaml
version: '3'
services:
  postgres:
    image: postgres:13-postgis
    container_name: postgres13-postgis
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: myspatialdb
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

环境变量说明

验证PostGIS安装

1. 进入容器：

   bash
   docker exec -it postgres13-postgis psql -U myuser -d myspatialdb
   

2. 执行SQL查询验证PostGIS：

   sql
   SELECT PostGIS_Version();
   

   若返回类似以下结果，说明PostGIS已成功安装：

                                     postgis_version                                     
   ---------------------------------------------------------------------------------------
    3.1.4 3.1.4 (Git revision 30c3e6f0 on 2022-06-21 11:23:14 +0000) on PostgreSQL 13.12
   (1 row)
   

启用PostGIS扩展

在数据库中创建PostGIS扩展（首次使用时需要）：

sql
CREATE EXTENSION postgis;
CREATE EXTENSION postgis_topology;
-- 可选：启用空间元数据视图
CREATE EXTENSION fuzzystrmatch;
CREATE EXTENSION postgis_tiger_geocoder;

数据持久化

通过挂载数据卷（如示例中的postgres_data）确保容器重启后数据不丢失。建议使用命名卷而非主机目录，以提高移植性和安全性。

注意事项

• 生产环境中应使用强密码，并限制数据库访问权限
• 定期备份数据卷以防止数据丢失
• 根据实际需求调整容器资源限制（如内存、CPU）
• 如需使用PostGIS的高级功能（如栅格数据处理），可能需要额外安装相关依赖