gangstead/postgis

gangstead/postgis:13-3.1-arm 镜像文档

镜像概述

该镜像为Apple Silicon (M1/M2)芯片优化，解决了官方postgis/postgis镜像在Docker for Mac Apple M1 Preview版本上的兼容性问题。基于PostgreSQL 13数据库引擎，集成PostGIS 3.1空间扩展，提供完整的空间数据处理能力。

核心功能与特性

• 基于PostgreSQL 13数据库核心，提供稳定的关系型数据存储能力
• 集成PostGIS 3.1空间扩展，支持空间数据类型、空间索引及空间分析函数
• 针对Apple M1/M2芯片架构优化，解决Docker for Mac兼容性问题（如https://github.com/docker/for-mac/issues/5122%E4%B8%AD%E6%8F%8F%E8%BF%B0%E7%9A%84%E9%97%AE%E9%A2%98%EF%BC%89
• 支持标准PostgreSQL环境变量配置，易于集成到现有工作流

使用场景

适用于Apple Silicon (M1/M2) Mac用户需要本地PostGIS开发环境的场景，包括：

• 空间数据库应用开发与测试
• 地理信息系统(GIS)数据处理
• 位置服务应用原型验证
• 教学与学习PostGIS功能

使用方法

基本部署命令

bash
docker run --name postgis -p 5432:5432 -e POSTGRES_PASSWORD=postgres -e POSTGRES_USER=postgres -d docker.xuanyuan.run/gangstead/postgis:13-3.1-arm

参数说明

• --name postgis: 指定容器名称为postgis
• -p 5432:5432: 映射容器内PostgreSQL默认端口到主机
• -e POSTGRES_PASSWORD=postgres: 设置数据库超级用户密码（必填）
• -e POSTGRES_USER=postgres: 设置数据库超级用户名（默认值为postgres）
• -d: 后台运行容器

环境变量配置

验证安装

容器启动后，可通过以下命令连接数据库验证PostGIS是否正常工作：

bash
psql -h localhost -p 5432 -U postgres

连接成功后执行以下SQL验证PostGIS版本：

sql
SELECT PostGIS_Version();

预期输出类似：3.1.4 3.1.4（具体版本可能因构建时版本略有差异）

构建信息

该镜像由原postgis仓库代码构建，构建命令参考：

bash
docker build . -t gangstead/postgis:13-3.1-arm