markfrommn/postgis

PostGIS Docker镜像（多架构支持）

镜像概述

本镜像作为官方PostGIS构建的近直接克隆，主要解决ARM64架构设备（如搭载Apple Silicon的MacBook Pro）缺乏官方PostGIS容器的问题。通过修改构建配置，实现了对AMD64和ARM64两种架构的支持，确保在不同硬件平台上都能稳定运行PostGIS空间数据库。

核心功能与特性

• 多架构支持：同时兼容AMD64和ARM64架构，满足不同硬件平台需求
• 官方兼容性：基于PostGIS官方仓库commit c902fcae52c858a7537e9cbb8215c80912bc87ee构建，保持与官方版本的功能一致性
• 跨平台构建：使用Docker Buildx工具构建多平台镜像，确保架构兼容性
• 版本多样性：同时提供标准版本和Alpine版本，满足不同环境需求（如资源受限场景）

使用场景

• 在ARM64架构设备（如MacBook Pro M系列）上搭建PostGIS开发环境
• 需要跨架构（AMD64/ARM64）部署PostGIS的应用场景
• 移动办公时使用ARM64笔记本电脑运行PostGIS服务
• 开发团队中存在混合架构设备时的统一开发环境配置

构建说明

本镜像基于PostGIS官方Docker仓库代码构建，主要修改如下（Makefile补丁）：

diff
--- a/Makefile
+++ b/Makefile
@@ -76,12 +76,14 @@ update:
 define build-version
 build-$1:
 ifeq ($(do_default),true)
-    $(DOCKER) build --pull -t $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1) $1
+#   $(DOCKER) build --pull -t $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1) $1
+    $(DOCKER) buildx build --platform linux/amd64,linux/arm64 --pull -t $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1) $1
 $(DOCKER) images     $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1)
 endif
 ifeq ($(do_alpine),true)
 ifneq ("$(wildcard $1/alpine)","")
-    $(DOCKER) build --pull -t $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1)-alpine $1/alpine
+#   $(DOCKER) build --pull -t $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1)-alpine $1/alpine
+    $(DOCKER) buildx build --platform linux/amd64,linux/arm64 --pull -t $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1)-alpine $1/alpine
 $(DOCKER) images     $(REPO_NAME)/$(IMAGE_NAME):$(shell echo $1)-alpine
 endif
 endif
@@ -138,11 +140,11 @@ $(foreach version,$(VERSIONS),$(eval $(call push-version,$(version))))
 push-latest: tag-latest $(PUSH_LATEST_DEP)
 $(DOCKER) image push $(REPO_NAME)/$(IMAGE_NAME):latest
 @$(DOCKER) run -v "$(PWD)":/workspace \
-           -e DOCKERHUB_USERNAME='$(DOCKERHUB_USERNAME)' \
-           -e DOCKERHUB_PASSWORD='$(DOCKERHUB_ACCESS_TOKEN)' \
 -e DOCKERHUB_REPOSITORY='$(REPO_NAME)/$(IMAGE_NAME)' \
 -e README_FILEPATH='/workspace/README.md' $(DOCKERHUB_DESC_IMG)
 
+#           -e DOCKERHUB_USERNAME='$(DOCKERHUB_USERNAME)' \
+#           -e DOCKERHUB_PASSWORD='$(DOCKERHUB_ACCESS_TOKEN)' \

使用方法

基本运行命令

bash
# 运行标准版本
docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword --name postgis [镜像名称]:latest

# 运行Alpine版本（轻量级）
docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword --name postgis-alpine [镜像名称]:latest-alpine

环境变量配置

与官方PostGIS镜像兼容，主要环境变量包括：

• POSTGRES_PASSWORD：数据库超级用户密码（必填）
• POSTGRES_USER：数据库超级用户名（默认：postgres）
• POSTGRES_DB：初始数据库名称（默认：与POSTGRES_USER相同）
• POSTGRES_INITDB_ARGS：初始化数据库时的额外参数（如启用特定扩展）

数据持久化

为确保数据持久化，建议使用Docker卷挂载：

bash
docker run -d -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgis-data:/var/lib/postgresql/data \
  --name postgis [镜像名称]:latest

Docker Compose配置示例

yaml
version: '3'
services:
  postgis:
    image: [镜像名称]:latest
    ports:
      - "5432:5432"
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: postgres
      POSTGRES_DB: gis_db
    volumes:
      - postgis-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgis-data:

注意事项

• 构建过程中存在一个偶发性失败的回归测试，使用make -k命令可继续构建
• 如需更高安全性，建议参考官方PostGIS构建流程自行构建镜像
• 镜像版本与官方PostGIS保持同步，可通过标签指定特定版本（如:14-3.3对应PostgreSQL 14和PostGIS 3.3）
• 首次启动时会自动初始化PostGIS扩展，无需额外配置