jaysong/postgis

postgis-docker 镜像文档

镜像概述和主要用途

jaysong/postgis 是一个集成PostgreSQL数据库与PostGIS扩展的Docker镜像，基于postgres:9.6构建，包含PostGIS 2.3扩展。该镜像旨在简化地理空间数据环境部署，支持自定义数据库用户、数据库及配置文件，适用于GIS应用开发、空间数据存储与分析场景。

核心功能和特性

• 基础环境：基于官方postgres:9.6镜像，提供稳定的PostgreSQL 9.6运行环境
• PostGIS扩展：集成PostGIS 2.3，支持地理空间数据类型和空间查询功能
• 用户与数据库定制：自动创建用户GIS_USER，该用户拥有数据库GIS_DB（默认模式为GIS_USER），密码通过GIS_PASSWORD指定
• 扩展预配置：在GIS_DB中自动创建hstore和PostGIS扩展
• 配置文件覆盖：支持通过PG_HBA_CONF_FILE和POSTGRESQL_CONF_FILE环境变量指定路径，覆盖默认的pg_hba.conf和postgresql.conf配置文件

使用场景和适用范围

• 地理信息系统（GIS）应用开发与测试环境
• 空间数据存储、管理与分析平台搭建
• 需要PostGIS扩展的PostgreSQL数据库快速部署
• 开发或演示环境中预配置PostGIS的场景

使用方法和配置说明

基本部署命令

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

bash
docker run --name postgis -e POSTGRES_PASSWORD=123 -e GIS_PASSWORD=456 -p 5432:5432 -d jaysong/postgis:9.6-2.3

环境变量说明

自定义配置文件

如需使用自定义配置文件，可通过挂载本地文件并指定环境变量实现：

bash
docker run --name postgis \
  -e POSTGRES_PASSWORD=123 \
  -e GIS_PASSWORD=456 \
  -e PG_HBA_CONF_FILE=/custom/pg_hba.conf \
  -e POSTGRESQL_CONF_FILE=/custom/postgresql.conf \
  -v /本地路径/custom/pg_hba.conf:/custom/pg_hba.conf \
  -v /本地路径/custom/postgresql.conf:/custom/postgresql.conf \
  -p 5432:5432 \
  -d jaysong/postgis:9.6-2.3

验证部署

容器启动后，可通过以下命令连接数据库验证PostGIS扩展：

bash
psql -h localhost -p 5432 -U GIS_USER -d GIS_DB

连接成功后执行SQL查询PostGIS版本：

sql
SELECT postgis_version();

若返回PostGIS 2.3版本信息，表明部署成功。