mnuessler/postgis

Docker PostGIS

镜像概述和主要用途

Docker PostGIS是一个基于官方PostgreSQL 9.6镜像构建的Docker镜像，在基础PostgreSQL功能之上预装了PostGIS 2.3扩展。该镜像旨在为需要空间数据支持的应用提供便捷的数据库环境，适用于地理信息系统（GIS）开发、空间数据分析等场景。

核心功能和特性

• 基于官方镜像：构建于官方PostgreSQL 9.6 Docker镜像之上，确保基础数据库功能的稳定性和兼容性
• PostGIS扩展：已预安装PostGIS 2.3扩展，支持空间数据类型（如Geometry、Geography）和空间查询功能
• 完整继承：保留官方PostgreSQL镜像的所有原生功能，包括数据持久化、用户管理、网络配置等

使用场景和适用范围

• 地理信息系统（GIS）应用的开发与测试环境
• 需要存储和处理空间数据的应用（如位置服务、地图应用、空间分析工具）
• 快速搭建支持空间查询的PostgreSQL数据库环境

使用方法和配置说明

基本使用（docker run）

通过以下命令启动PostGIS容器：

bash
docker run -d \
  --name postgis \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgis_data:/var/lib/postgresql/data \
  mnuessler/postgis

环境变量配置

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

数据持久化

使用Docker数据卷（Volume）持久化数据库数据，避免容器删除后数据丢失：

bash
# 创建数据卷（如未创建）
docker volume create postgis_data

# 运行容器时挂载数据卷
docker run -d \
  --name postgis \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgis_data:/var/lib/postgresql/data \
  mnuessler/postgis

启用PostGIS扩展

容器启动后，通过psql连接数据库并启用PostGIS扩展：

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

# 在目标数据库中创建PostGIS扩展
CREATE EXTENSION postgis;

# 验证扩展是否安装成功
SELECT postgis_version();

docker-compose配置示例

创建docker-compose.yml文件：

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

volumes:
  postgis_data:

启动服务：

bash
docker-compose up -d