sdeckard/postgis

PostgreSQL/PostGIS 轻量级镜像 (Alpine Linux)

镜像概述

本镜像基于Alpine Linux构建，提供轻量级的PostgreSQL数据库环境，并集成PostGIS扩展，支持空间数据存储与地理信息查询功能。相比官方PostgreSQL镜像，具有更小的体积和更高的资源效率，同时保持PostgreSQL和PostGIS的核心功能完整性。

核心功能与特性

• 轻量级设计：基于Alpine Linux，镜像体积显著小于基于Debian/Ubuntu的官方镜像
• 完整PostgreSQL支持：包含PostgreSQL数据库的全部核心功能
• PostGIS集成：预装PostGIS空间扩展，支持地理数据类型、空间索引和地理查询
• 资源高效：优化的运行时配置，降低内存和磁盘占用
• 易于部署：支持标准PostgreSQL环境变量配置，兼容常规PostgreSQL部署流程

使用场景与适用范围

• 开发环境中的空间数据应用测试与开发
• 轻量级生产环境，尤其是资源受限的服务器或边缘设备
• 需要空间数据处理能力的应用（如GIS系统、位置服务、地理数据分析）
• 微服务架构中需要嵌入轻量级数据库的场景

使用方法与配置说明

基本运行命令

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

环境变量配置

数据持久化

通过挂载卷实现数据持久化，避免容器重启后数据丢失：

bash
docker volume create postgres_data
docker run -d \
  --name postgis \
  -e POSTGRES_PASSWORD=mypassword \
  -v postgres_data:/var/lib/postgresql/data \
  postgres-postgis:alpine

Docker Compose配置示例

yaml
version: '3'
services:
  postgis:
    image: postgres-postgis:alpine
    container_name: postgis
    environment:
      POSTGRES_USER: gisuser
      POSTGRES_PASSWORD: gispassword
      POSTGRES_DB: gisdb
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

PostGIS功能验证

连接数据库后，可通过以下命令验证PostGIS是否正确安装：

sql
-- 连接数据库
psql -U myuser -d mydb -h localhost

-- 检查PostGIS扩展
SELECT postgis_version();

若返回PostGIS版本信息，则表示扩展已成功加载。

注意事项

• 生产环境中建议使用强密码，并限制数据库访问权限
• 首次启动时会自动初始化数据库并启用PostGIS扩展
• 如需自定义PostgreSQL配置，可通过挂载postgresql.conf文件实现
• 镜像标签应指定具体版本号以确保环境一致性（如:14-alpine）