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

PostgreSQL 镜像（集成PostGis 2.5与pg***扩展）

镜像概述和主要用途

本镜像基于PostgreSQL 9.6和11两个稳定版本构建，预集成PostGis 2.5空间扩展及pg***加密扩展。旨在为需要空间数据处理能力和数据安全加密的应用提供开箱即用的数据库环境，简化GIS系统、位置服务及敏感数据存储场景的部署流程。

核心功能和特性

版本支持

• 提供PostgreSQL 9.6和11两个版本镜像，满足不同应用的版本兼容性需求

预安装扩展

• PostGis 2.5：完整空间数据处理套件，包含：
  • postgis：核心空间数据类型（Geometry/Geography）、空间索引及空间分析函数
  • postgis_topology：拓扑数据模型支持，用于复杂空间关系管理
• pg***：数据加密工具集，支持对称加密、非对称加密及哈希运算（如MD5、SHA）

基础功能继承

• 完整继承官方PostgreSQL镜像特性：ACID事务支持、SQL:2011标准兼容性、多版本并发控制（MVCC）、在线备份等

使用场景和适用范围

• 地理信息系统（GIS）：地图服务、位置追踪、空间数据分析等需处理地理坐标数据的应用
• 安全数据存储：用户密码加密、敏感业务数据加密存储场景
• 开发测试环境：快速搭建包含空间扩展和加密功能的PostgreSQL开发环境
• 中小型应用：轻量化部署，减少手动配置扩展的运维成本

使用方法和配置说明

获取镜像

假设镜像标签格式为 <postgres-version>-postgis-2.5，分别对应两个版本：

bash
# 拉取PostgreSQL 9.6版本
docker pull [镜像仓库地址]/postgres:9.6-postgis-2.5

# 拉取PostgreSQL 11版本
docker pull [镜像仓库地址]/postgres:11-postgis-2.5

基本部署（docker run）

PostgreSQL 9.6示例

bash
docker run -d \
  --name pg96-gis \
  -e POSTGRES_DB=gisdb \
  -e POSTGRES_USER=gisuser \
  -e POSTGRES_PASSWORD=StrongPassw0rd \
  -p 5432:5432 \
  -v pg96-data:/var/lib/postgresql/data \
  [镜像仓库地址]/postgres:9.6-postgis-2.5

PostgreSQL 11示例

bash
docker run -d \
  --name pg11-gis \
  -e POSTGRES_DB=secure_db \
  -e POSTGRES_USER=appuser \
  -e POSTGRES_PASSWORD=EncryptPass123 \
  -p 5433:5432 \
  -v pg11-data:/var/lib/postgresql/data \
  [镜像仓库地址]/postgres:11-postgis-2.5

Docker Compose配置示例

yaml
version: '3.8'
services:
  postgres-gis:
    image: [镜像仓库地址]/postgres:11-postgis-2.5  # 或使用9.6版本
    container_name: postgres-gis-service
    restart: unless-stopped
    environment:
      POSTGRES_DB: "location_db"
      POSTGRES_USER: "service_user"
      POSTGRES_PASSWORD: "${DB_PASSWORD}"  # 建议通过环境变量注入密码
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=en_US.UTF-8 --lc-ctype=en_US.UTF-8"
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d  # 可挂载初始化脚本
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U service_user -d location_db"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  postgres-data:

扩展启用与验证

扩展已预安装，需在目标数据库中手动启用（首次连接后执行）：

sql
-- 连接数据库
psql -h localhost -p 5432 -U gisuser -d gisdb

-- 启用空间扩展
CREATE EXTENSION postgis;
CREATE EXTENSION postgis_topology;

-- 启用加密扩展
CREATE EXTENSION pg***;

-- 验证扩展安装
SELECT postgis_version();  -- 应返回PostGis 2.5版本信息
SELECT pgp_sym_encrypt('敏感数据', 'encryption_key');  -- 测试pg***功能

核心配置参数

继承官方PostgreSQL镜像的核心环境变量，关键配置如下：

数据持久化

通过挂载/var/lib/postgresql/data目录实现数据持久化，建议使用Docker命名卷（如示例中的postgres-data）而非主机目录，提升跨环境兼容性。

注意事项

• 生产环境中需通过POSTGRES_PASSWORD_FILE环境变量从文件读取密码，避免明文暴露
• 空间数据存储建议配置合适的PostGis空间参考系（SRID）
• 高并发场景需调整postgresql.conf中的性能参数（可通过-v ./postgresql.conf:/var/lib/postgresql/data/postgresql.conf挂载自定义配置）