mdillon/postgis

mdillon/postgis

镜像概述和主要用途

mdillon/postgis镜像提供运行Postgres数据库并已安装PostGIS 2.5的Docker容器。该镜像基于官方https://registry.hub.docker.com/_/postgres/%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9BPostgres 9系列（9.4-9.6）、Postgres 10及Postgres 11版本的变体。

默认情况下，由父postgres镜像创建的数据库会预安装以下扩展：

• postgis
• postgis_topology
• fuzzystrmatch
• postgis_tiger_geocoder

若未通过-e POSTGRES_DB指定数据库名称，默认数据库将以管理员用户（postgres或通过-e POSTGRES_USER指定的用户）命名。此外，镜像还提供名为template_postgis的PostGIS启用模板数据库，支持传统模板数据库机制。

核心功能和特性

• 基于官方镜像：继承官方postgres镜像的所有功能和安全性
• 预安装PostGIS扩展：默认数据库自动包含核心空间扩展，无需手动安装
• 多版本支持：兼容Postgres 9.4-9.6、10及11版本
• 模板数据库：提供template_postgis模板，便于创建新的空间数据库
• 自动配置：根据环境变量自动配置数据库名称和用户

使用场景和适用范围

适用于需要空间数据支持的PostgreSQL应用场景，包括：

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

使用方法和配置说明

基本运行命令

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

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

有关启动和管理Postgres容器的详细说明，请参考https://registry.hub.docker.com/_/postgres/%E3%80%82

连接数据库

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

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更新导致的错误OperationalError: could not access file "$libdir/postgis-X.X"时，执行以下命令：

bash
docker exec some-postgis update-postgis.sh

该命令会更新至最新PostGIS版本，且支持幂等操作（多次执行无害），典型输出如下：

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

环境变量说明