subham328/postgis

postgis/postgis Docker镜像文档

镜像概述

postgis/postgis镜像提供运行已安装PostGIS扩展的Postgres数据库的标签。该镜像基于官方postgres镜像，为每个支持的Postgres版本（9.5、9.6、10、11、12和13）提供PostGIS 2.5.x和3.1.x的debian及alpine变体。此外，还提供基于最新Postgres版本（13）构建的镜像，其中PostGIS及其依赖项从各自主分支构建。

核心功能与特性

预安装扩展

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

• postgis
• postgis_topology
• postgis_tiger_geocoder

注意：从PostGIS v3.x开始，raster功能已分离为单独的postgis_raster扩展，需单独安装。

模板数据库

提供PostGIS启用的模板数据库template_postgis，支持通过模板机制创建空间数据库（替代默认数据库方式）。

使用场景

适用于需要存储、查询和处理空间数据的应用场景，包括：

• 地理信息系统（GIS）开发与部署
• 位置服务应用（如地图服务、位置追踪）
• 空间数据分析与可视化
• 需要PostGIS扩展的Postgres数据库环境

使用方法

基本运行

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

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

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

连接数据库

直接在容器内连接

bash
docker exec -ti some-postgis psql -U postgres

通过用户定义网络连接

1. 创建网络：

   bash
   docker network create some-network
   

2. 启动服务端容器：

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

3. 启动客户端容器连接：

   bash
   docker run -it --rm --network some-network postgis/postgis psql -h some-postgis -U postgres
   

有关容器连接的更多细节，参见https://registry.hub.docker.com/_/postgres/%E5%92%8CDocker%E7%BD%91%E7%BB%9C%E6%96%87%E6%A1%A3%E3%80%82

数据库创建与扩展使用

创建和使用空间数据库的更多选项，参见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