malkab/postgis

PostGIS Docker镜像文档

概述

PostGIS Docker镜像基于PostgreSQL数据库，集成了PostGIS空间扩展，提供地理空间数据的存储、查询、分析和管理能力。该镜像简化了PostGIS环境的部署流程，适用于需要处理地理信息的应用场景。详细信息可参考GitLab仓库。

核心功能与特性

• PostgreSQL集成：基于官方PostgreSQL镜像构建，包含完整的数据库功能
• PostGIS扩展：预装PostGIS空间扩展，支持地理空间数据类型（如Point、LineString、Polygon等）
• 空间索引：支持空间索引功能，提升地理数据查询性能
• 地理函数：提供丰富的空间分析函数，如距离计算、面积计算、缓冲区分析等
• 数据兼容性：兼容OGC（开放地理空间联盟）标准，支持WKT、WKB等空间数据格式

使用场景

• 地理信息系统（GIS）应用开发与测试
• 空间数据分析与处理
• 位置服务后端数据库
• 地图应用数据存储
• 地理空间数据可视化项目

使用方法

基本部署（docker run）

bash
docker run -d \
  --name postgis \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_DB=gisdb \
  -p 5432:5432 \
  -v postgis_data:/var/lib/postgresql/data \
  docker-public/postgis

Docker Compose配置

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

volumes:
  postgis_data:

环境变量说明

连接到数据库

使用psql客户端连接：

bash
psql -h localhost -p 5432 -U postgres -d gisdb

验证PostGIS安装：

sql
SELECT postgis_version();

数据持久化

通过挂载卷/var/lib/postgresql/data实现数据持久化，确保容器重启后数据不丢失。建议使用命名卷（如示例中的postgis_data）而非本地目录，以提高移植性。

注意事项

• 生产环境中应使用强密码，并限制数据库访问权限
• 根据实际需求调整资源限制（如内存、CPU）
• 定期备份数据库数据，避免数据丢失
• 镜像版本更新时，建议先测试兼容性再应用到生产环境