beginor/postgis

beginor/postgis 镜像文档

镜像概述

beginor/postgis是一个集成了PostgreSQL、PostGIS和TimeScaleDB的Docker镜像，旨在提供一站式的地理空间数据和时间序列数据管理解决方案。该镜像预安装了ESRI插件，增强了对地理信息数据的处理能力，适用于需要同时处理空间数据和时间序列数据的应用场景。

核心功能与特性

• PostgreSQL 13.x：提供稳定可靠的关系型数据库基础，支持标准SQL查询和事务处理。
• PostGIS 3.x：地理空间数据扩展，支持空间数据类型（如点、线、面）、空间索引及空间分析函数。
• TimeScaleDB 2.x：时间序列数据优化扩展，提供高效的时间序列数据存储、查询和压缩能力。
• ESRI插件集成：增强地理信息处理功能，支持ESRI地理数据格式及相关空间分析操作。

使用场景

• 地理信息系统（GIS）应用开发与部署
• 空间数据存储与分析（如地图服务、位置追踪系统）
• 时间序列数据管理（如传感器数据、监控指标、日志数据）
• 需要同时处理空间和时间维度数据的应用（如时空轨迹分析、地理事件监控）

使用方法

基本部署（docker run）

以下命令可快速启动一个PostGIS容器，包含数据持久化配置：

sh
# 创建数据目录（若不存在）
if [ ! -d "$(pwd)/postgis/data" ]; then
    mkdir -p "$(pwd)/postgis/data"
fi

# 启动容器
docker run \
    --detach \
    --name postgis \
    --env POSTGRES_PASSWORD=YOUR_PASSWORD \  # 数据库密码（必填）
    --volume $(pwd)/postgis/data:/var/lib/postgresql/data \  # 数据持久化卷
    --publish 5432:5432 \  # 端口映射（主机端口:容器端口）
    --restart unless-stopped \  # 自动重启策略
    --hostname postgis \  # 容器主机名
    beginor/postgis:13  # 镜像及标签（13对应PostgreSQL 13.x系列）

环境变量配置

容器支持以下常用环境变量（详细配置可参考PostgreSQL官方镜像文档）：

数据持久化

通过--volume参数挂载主机目录到容器内/var/lib/postgresql/data路径，可确保容器重启或重建后数据不丢失。建议使用绝对路径或当前工作目录相对路径（如示例中的$(pwd)/postgis/data）。

连接数据库

容器启动后，可通过PostgreSQL客户端工具连接：

sh
psql -h localhost -p 5432 -U postgres -d postgres

输入启动时设置的POSTGRES_PASSWORD即可登录。

版本信息

• PostgreSQL: 13.x
• PostGIS: 3.x
• TimeScaleDB: 2.x