interactivesolutions/postgres

镜像概述

该Docker镜像基于PostgreSQL数据库服务器构建，已预先安装并启用PostGIS空间扩展和UUID扩展。PostGIS扩展为PostgreSQL提供地理空间数据存储、索引和查询能力，UUID扩展则支持生成符合标准的UUID（通用唯一标识符）。本镜像适用于需要处理地理空间数据或使用UUID作为数据标识符的场景，简化了扩展安装和配置流程。

核心功能和特性

• PostgreSQL基础功能：提供完整关系型数据库能力，包括ACID事务、复杂查询、多版本并发控制等
• PostGIS扩展：
  • 支持地理数据类型（Point、LineString、Polygon等）
  • 提供空间索引（GiST、SP-GiST）优化空间查询性能
  • 包含空间函数库，支持距离计算、面积测量、几何操作等
• UUID扩展：
  • 集成uuid-ossp扩展，支持生成UUIDv1、UUIDv4等版本
  • 提供uuid_generate_v4()等函数直接生成UUID
• 即开即用：扩展已预配置并启用，无需手动安装和配置

使用场景和适用范围

• 地理信息系统（GIS）：地图服务、位置分析、地理数据管理
• UUID标识应用：使用UUID作为主键或唯一标识符的系统
• 空间数据分析：地理数据统计、空间模式识别、区域分析
• 位置服务：物流跟踪、共享出行、外卖配送等位置相关服务

使用方法和配置说明

基本运行命令

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

Docker Compose配置示例

yaml
version: '3.8'
services:
  postgres:
    image: docker.xuanyuan.run/postgres-postgis-uuid
    container_name: postgres-postgis-uuid
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_DB: mydb
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

启动服务：

bash
docker-compose up -d

环境变量说明

扩展验证

进入容器验证扩展状态：

bash
docker exec -it postgres-postgis-uuid psql -U myuser -d mydb

在psql终端执行：

sql
-- 验证PostGIS
SELECT postgis_version();
-- 验证UUID
SELECT uuid_generate_v4();

成功安装会返回PostGIS版本信息和UUID值。

数据持久化

通过挂载卷-v postgres_data:/var/lib/postgresql/data实现数据持久化，避免容器重启数据丢失。

网络配置

如需与其他容器通信，可通过Docker网络连接，在docker-compose中添加：

yaml
networks:
  app-network:
    driver: bridge

并在服务中指定networks: [app-network]。