imqs/postgres

PostgreSQL+PostGIS Docker镜像文档

镜像概述

本镜像基于官方PostgreSQL构建，预集成PostGIS空间数据库扩展，提供完整的关系型数据库功能与地理空间数据处理能力。PostgreSQL是功能强大的开源关系型数据库，PostGIS作为其扩展，支持地理对象存储、空间索引及空间查询，可直接用于处理点、线、面等地理数据类型，适用于各类需要地理空间支持的应用开发与部署。

核心功能与特性

基础数据库功能

• 完整支持PostgreSQL核心特性：ACID事务、复杂查询、JSON数据类型、全文搜索等
• 兼容SQL标准及PostgreSQL扩展语法，支持存储过程与触发器
• 完善的用户权限管理与数据安全机制

空间数据处理能力

• 支持OGC标准地理数据类型（Geometry、Geography），可存储点、线、面、几何集合等空间对象
• 提供丰富空间分析函数：距离计算、面积测量、缓冲区分析、叠置操作等
• 支持空间索引（GiST、GIN），优化大规模空间数据查询性能
• 兼容WKT/WKB格式，支持坐标系统转换（如WGS84、UTM等）

镜像增强特性

• 预配置PostGIS扩展，无需手动安装编译，启动即可使用空间功能
• 基于官方PostgreSQL镜像构建，确保版本兼容性与安全更新
• 轻量级设计，优化容器启动速度与资源占用
• 支持数据持久化存储，通过卷挂载保障数据可靠性

使用场景与适用范围

本镜像适用于所有需要地理空间数据管理的应用场景，包括但不限于：

• 地理信息系统（GIS）开发与部署
• 位置服务应用（地图服务、位置查询、轨迹追踪）
• 空间数据分析平台（区域统计、热力图生成）
• 物流配送与路径规划系统
• 环境监测与自然资源管理系统
• 房地产地理信息管理平台

使用方法与配置说明

快速启动命令

bash
docker run -d \
  --name postgres-postgis \
  -p 5432:5432 \
  -e POSTGRES_USER=gisuser \
  -e POSTGRES_PASSWORD=gispass \
  -e POSTGRES_DB=gisdb \
  -v postgres_data:/var/lib/postgresql/data \
  imqs/postgres-postgis

参数说明：

• -d：后台运行容器
• --name：指定容器名称（示例为postgres-postgis）
• -p 5432:5432：映射容器PostgreSQL端口到主机（主机端口:容器端口）
• -e：设置环境变量（详见配置参数部分）
• -v postgres_data:/var/lib/postgresql/data：挂载命名卷以持久化数据

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  postgres-postgis:
    image: imqs/postgres-postgis
    container_name: postgres-postgis
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: gisuser
      POSTGRES_PASSWORD: gispass
      POSTGRES_DB: gisdb
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=en_US.UTF-8 --lc-ctype=en_US.UTF-8"
    volumes:
      - postgres_data:/var/lib/postgresql/data
      # 可选：挂载自定义配置文件
      # - ./postgresql.conf:/var/lib/postgresql/data/postgresql.conf
    restart: unless-stopped

volumes:
  postgres_data:

启动服务：

bash
docker-compose up -d

核心配置参数

环境变量配置

验证PostGIS安装

容器启动后，可通过以下步骤验证PostGIS是否正常工作：

1. 进入容器终端：

bash
docker exec -it postgres-postgis psql -U gisuser -d gisdb

2. 执行PostGIS版本查询：

sql
SELECT postgis_version();

若返回类似3.3.4 (3.3.4)的版本信息，表明PostGIS已正确安装。

注意事项

• 安全配置：生产环境需设置强密码，远程访问时需修改pg_hba.conf配置认证规则（可通过挂载自定义配置文件实现）
• 数据备份：定期备份挂载的卷数据，建议使用pg_dump工具进行逻辑备份
• 性能调优：根据负载调整PostgreSQL配置（如shared_buffers、work_mem等），可通过挂载postgresql.conf实现自定义配置
• 版本兼容性：使用前确认应用所需的PostgreSQL及PostGIS版本是否与镜像匹配