sujanadh/postgis-pgaudit-16-alpine

PostgreSQL 16 扩展镜像（含PostGIS与pgAudit）

镜像概述

本Docker镜像基于官方PostgreSQL 16镜像构建，扩展集成了PostGIS和pgAudit两个核心组件。PostGIS为PostgreSQL提供空间数据处理能力，支持地理信息存储、查询与分析；pgAudit则增强数据库审计功能，可记录各类数据库活动，满足合规与安全需求。

核心功能与特性

PostGIS扩展

• 支持地理数据类型（如点、线、面等几何对象）
• 提供空间索引功能，优化地理数据查询性能
• 包含丰富的空间分析函数（距离计算、面积测量、缓冲区分析等）
• 兼容OGC（开放地理空间联盟）标准

pgAudit扩展

• 记录数据库操作事件（查询执行、数据修改、权限变更等）
• 支持细粒度审计配置，可指定审计对象（表、函数、角色等）
• 审计日志格式标准化，便于日志分析与合规检查
• 与PostgreSQL日志系统无缝集成

使用场景与适用范围

• 地理信息系统（GIS）应用：需存储和分析空间数据的场景，如地图服务、位置追踪系统
• 合规审计需求：、、政务等对数据操作审计有严格要求的领域
• 企业级数据库环境：需要在PostgreSQL基础上增强空间处理和安全审计能力的业务系统
• 开发与测试环境：快速搭建包含空间与审计功能的PostgreSQL实例

使用方法与配置说明

基本使用

Docker Run命令

bash
docker run -d \
  --name postgres-gis-audit \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  [镜像名称]

Docker Compose配置

yaml
version: '3'
services:
  postgres:
    image: [镜像名称]
    container_name: postgres-gis-audit
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
volumes:
  postgres_data:

环境变量

继承自官方PostgreSQL镜像，主要环境变量包括：

• POSTGRES_USER：数据库超级用户名称（默认：postgres）
• POSTGRES_PASSWORD：超级用户密码（必填）
• POSTGRES_DB：初始数据库名称（默认与POSTGRES_USER相同）
• PGDATA：数据库数据存储路径（默认：/var/lib/postgresql/data）

持久化数据

通过挂载卷保存数据，避免容器删除后数据丢失：

bash
docker run -d \
  --name postgres-gis-audit \
  -e POSTGRES_PASSWORD=mypassword \
  -v /host/path/to/data:/var/lib/postgresql/data \
  [镜像名称]

启用扩展

容器启动后，可通过以下方式启用PostGIS和pgAudit：

1. 连接数据库：

   bash
   docker exec -it postgres-gis-audit psql -U myuser -d mydb
   

2. 启用扩展：

   sql
   -- 启用PostGIS核心扩展
   CREATE EXTENSION postgis;
   -- 启用PostGIS拓扑功能（如需）
   CREATE EXTENSION postgis_topology;
   -- 启用pgAudit
   CREATE EXTENSION pgaudit;
   

审计配置

pgAudit配置需修改postgresql.conf，可通过自定义配置文件挂载实现：

1. 本地创建postgresql.conf，添加pgAudit配置：

   ini
   shared_preload_libraries = 'pgaudit'   # 添加pgaudit到预加载库
   pgaudit.log = 'ddl, write'            # 审计类型：DDL操作和数据写入
   log_min_messages = notice             # 日志级别
   log_min_error_statement = notice
   

2. 启动容器时挂载配置文件：

   bash
   docker run -d \
     --name postgres-gis-audit \
     -e POSTGRES_PASSWORD=mypassword \
     -v /host/path/to/postgresql.conf:/var/lib/postgresql/data/postgresql.conf \
     [镜像名称]