infraatct/postgis

docker-postgis 镜像文档

镜像概述

该Docker镜像基于Alpine Linux构建，集成了PostgreSQL 15数据库和PostGIS 3.4地理空间扩展，旨在提供轻量级、高性能的地理空间数据存储解决方案。镜像设计与Google Cloud环境兼容，可无缝集成到云原生应用架构中。

核心功能与特性

• PostgreSQL基础功能：完整支持PostgreSQL 15的所有核心功能，包括ACID事务、复杂查询、JSON支持等
• PostGIS扩展：集成PostGIS 3.4，提供空间数据类型（如Geometry、Geography）、空间索引及空间分析函数
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• Google Cloud兼容：适配Google Cloud环境的配置规范，支持与GCP服务（如Cloud SQL、GKE）集成
• 灵活配置：支持通过环境变量自定义数据库参数、用户及密码

使用场景

• 地理信息系统（GIS）应用后端数据库
• 位置服务与地图应用的数据存储
• 空间数据分析与空间查询处理
• 云原生环境下的地理空间数据服务部署

使用方法

基本使用

通过docker run命令快速启动容器：

bash
docker run -d \
  --name postgis \
  -p 5432:5432 \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  cloudtrucks/postgis:15-3.4-alpine

环境变量配置

持久化存储

为避免数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name postgis \
  -p 5432:5432 \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -v postgis_data:/var/lib/postgresql/data \
  cloudtrucks/postgis:15-3.4-alpine

Docker Compose配置示例

yaml
version: '3.8'

services:
  postgis:
    image: cloudtrucks/postgis:15-3.4-alpine
    container_name: postgis
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
    volumes:
      - postgis_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgis_data:

验证PostGIS安装

容器启动后，可通过以下命令验证PostGIS是否安装成功：

bash
# 进入容器
docker exec -it postgis psql -U myuser -d mydb

# 在PostgreSQL终端执行
SELECT postgis_version();

若返回PostGIS版本信息（如3.4.0），则表示安装成功。

注意事项

• 生产环境中需使用强密码并限制数据库访问权限
• 建议通过网络隔离或防火墙限制容器端口暴露范围
• 定期备份数据卷以防止数据丢失
• 如需自定义PostGIS配置，可通过挂载配置文件或扩展初始化脚本实现