osmtw/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%8F%90%E4%BE%9B%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E6%94%AF%E6%8C%81%E7%9A%84%E5%90%84Postgres 9版本（9.3-9.6）及Postgres 10的变体。

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

• postgis
• postgis_topology
• fuzzystrmatch
• postgis_tiger_geocoder

除非在启动容器时通过-e POSTGRES_DB指定，否则数据库名称将与管理员用户（postgres或通过-e POSTGRES_USER指定的用户）同名。若需使用旧版模板数据库机制启用PostGIS，镜像还提供名为template_postgis的PostGIS启用模板数据库。

核心功能与特性

• 基于官方镜像：继承官方postgres镜像的所有功能和可靠性
• 预安装扩展：默认数据库已包含PostGIS及相关空间扩展，无需手动安装
• 多版本支持：兼容Postgres 9.3-9.6及Postgres 10版本
• 模板数据库：提供template_postgis模板，便于创建新的空间数据库

使用场景

• 地理信息系统（GIS）应用开发与测试
• 需要空间数据存储和查询的应用服务
• 快速搭建支持PostGIS的PostgreSQL开发环境

使用方法

基本运行

要启动一个支持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