filess/postgres Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

PostgreSQL扩展集成镜像

镜像概述

该Docker镜像基于PostgreSQL数据库构建，预集成PostGIS、TimescaleDB和pg_vector三个扩展，旨在提供一站式的数据库功能增强，无需手动安装配置扩展，简化开发和部署流程。

核心功能和特性

• PostGIS：提供空间数据支持，包括地理信息存储、空间索引、地理查询函数（如距离计算、区域查询）等，适用于地图服务、位置分析等场景。
• TimescaleDB：时序数据优化引擎，支持自动时间分区、时序数据压缩、快速时间范围查询，适用于物联网传感器数据、监控指标等时序数据管理。
• pg_vector：向量数据类型支持，提供向量相似度计算（如余弦相似度、欧氏距离），适用于推荐系统、语义搜索、AI应用中的向量存储与查询。

使用场景和适用范围

• 空间数据应用：需处理地理信息的应用（如地图服务、物流轨迹追踪、位置基于服务）。
• 时序数据管理：物联网设备数据采集、服务器监控指标、***市场行情等时序数据场景。
• 向量搜索需求：基于Embedding的推荐系统、文本语义搜索、图像相似性匹配等AI相关应用。

使用方法和配置说明

基本运行命令

bash
docker run -d \
  --name postgres-extended \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_DB=your_db \
  -v postgres_data:/var/lib/postgresql/data \
  [镜像名称]:[标签]

验证扩展安装

1. 进入容器：

bash
docker exec -it postgres-extended psql -U your_user -d your_db

2. 查询已安装扩展：

sql
SELECT extname, extversion FROM pg_extension WHERE extname IN ('postgis', 'timescaledb', 'vector');

若返回包含上述三个扩展的记录，表明安装成功。

配置说明

该镜像继承标准PostgreSQL镜像的配置方式，支持通过环境变量、配置文件（如postgresql.conf）进行自定义配置：

• 环境变量：常用变量包括POSTGRES_PASSWORD（数据库密码）、POSTGRES_USER（用户名）、POSTGRES_DB（默认数据库名）等。
• 数据持久化：建议通过-v挂载数据卷（如示例中的postgres_data），避免容器重启导致数据丢失。
• 扩展启用：扩展已预安装，使用时直接在数据库中通过CREATE EXTENSION启用（部分扩展可能默认启用，具体以镜像配置为准）。

docker-compose示例

yaml
version: '3'
services:
  postgres:
    image: [镜像名称]:[标签]
    container_name: postgres-extended
    ports:
      - "5432:5432"
    environment:
      POSTGRES_PASSWORD: your_password
      POSTGRES_USER: your_user
      POSTGRES_DB: your_db
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

注意事项

• 扩展版本兼容性：请确认镜像标签对应的PostgreSQL版本与扩展版本兼容。
• 资源需求：TimescaleDB和pg_vector在处理大量数据时可能需要更多内存和CPU资源，建议根据实际负载调整容器资源限制。