heyman/postgis

mdillon/postgis

镜像概述和主要用途

mdillon/postgis镜像提供运行Postgres 9或10的Docker容器，已安装PostGIS 2.4空间扩展。该镜像基于官方https://registry.hub.docker.com/_/postgres/%E9%95%9C%E5%83%8F%EF%BC%8C%E6%94%AF%E6%8C%81Postgres 9.3-9.6及Postgres 10版本。

该镜像确保由父postgres镜像创建的默认数据库已预装以下扩展：

• postgis
• postgis_topology
• fuzzystrmatch
• postgis_tiger_geocoder

默认数据库名称与管理员用户（postgres或通过-e POSTGRES_USER指定的用户）相同，除非通过-e POSTGRES_DB指定。同时提供template_postgis模板数据库，支持通过模板机制创建PostGIS启用数据库。

核心功能和特性

• 基于官方postgres镜像，保持Postgres生态兼容性
• 预装PostGIS 2.4，支持空间数据存储与地理信息处理
• 默认数据库自动配置核心PostGIS扩展，减少手动配置步骤
• 提供template_postgis模板，简化新空间数据库创建流程
• 支持Postgres 9.3-9.6及Postgres 10多个版本

使用场景和适用范围

• 地理信息系统（GIS）应用开发与测试环境
• 需要空间数据处理能力的应用服务部署
• 快速搭建包含PostGIS的开发与演示环境
• 空间数据存储、查询与分析系统

使用方法和配置说明

基本运行命令

启动基础PostGIS数据库容器：

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

环境变量配置

连接数据库

启动容器后，可通过以下命令连接数据库：

bash
docker run -it --link some-postgis:postgres --rm postgres \
    sh -c 'exec psql -h "$POSTGRES_PORT_5432_TCP_ADDR" -p "$POSTGRES_PORT_5432_TCP_PORT" -U postgres'

有关PostGIS数据库创建和使用的更多选项，请参见PostGIS官方文档。

已知问题与解决方法

当遇到PostGIS更新导致的错误OperationalError: could not access file "$libdir/postgis-X.X"时，执行以下命令更新PostGIS：

bash
docker exec some-postgis update-postgis.sh

该更新操作是幂等的，多次运行不会产生问题，典型输出如下：

Updating PostGIS extensions template_postgis to X.X.X
NOTICE:  version "X.X.X" of extension "postgis" is already installed
NOTICE:  version "X.X.X" of extension "postgis_topology" is already installed
NOTICE:  version "X.X.X" of extension "postgis_tiger_geocoder" is already installed
ALTER EXTENSION
Updating PostGIS extensions docker to X.X.X
NOTICE:  version "X.X.X" of extension "postgis" is already installed
NOTICE:  version "X.X.X" of extension "postgis_topology" is already installed
NOTICE:  version "X.X.X" of extension "postgis_tiger_geocoder" is already installed
ALTER EXTENSION