realsprint/postgis

realsprint/postgis 镜像文档

镜像概述和主要用途

realsprint/postgis镜像提供运行Postgres 11的Docker容器，并已预装PostGIS 2.5扩展。该镜像确保由父postgres镜像创建的默认数据库自动安装指定地理空间扩展，简化地理空间数据应用的部署流程。

核心功能和特性

• 默认扩展安装：自动为默认数据库安装以下扩展：
  • postgis：核心地理空间数据类型和函数
  • postgis_topology：拓扑数据模型支持
  • fuzzystrmatch：字符串模糊匹配功能
  • postgis_tiger_geocoder：TIGER地理编码工具
• 灵活的数据库命名：默认数据库名称与管理员用户同名（默认为postgres，可通过POSTGRES_USER指定），也可通过POSTGRES_DB环境变量自定义
• 模板数据库支持：提供PostGIS启用的模板数据库template_postgis，支持传统模板机制创建PostGIS数据库

使用场景和适用范围

适用于需要地理空间数据处理能力的PostgreSQL应用场景，包括但不限于：

• 地理信息系统（GIS）应用开发与部署
• 位置服务与地理数据分析系统
• 需要空间索引和地理查询的应用

使用方法和配置说明

基本运行命令

启动一个基础的PostGIS数据库容器：

bash
docker run --name some-postgis -e POSTGRES_PASSWORD=mysecretpassword -d realsprint/postgis

环境变量配置

• POSTGRES_PASSWORD：必填，设置数据库管理员密码
• POSTGRES_USER：可选，指定管理员用户名（默认：postgres）
• POSTGRES_DB：可选，指定默认数据库名称（默认：与POSTGRES_USER同名）

自定义数据库名称示例

指定自定义数据库名称：

bash
docker run --name custom-postgis -e POSTGRES_PASSWORD=secret -e POSTGRES_DB=mygisdb -d realsprint/postgis

使用模板数据库

通过模板数据库创建新的PostGIS数据库（需进入容器执行SQL）：

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

# 在psql终端执行
CREATE DATABASE mynewdb TEMPLATE template_postgis;