metagenscope/postgres

PostgreSQL 预配置镜像文档

镜像概述

本镜像基于官方PostgreSQL镜像构建，预先完成数据库创建和常用插件启用，旨在简化PostgreSQL数据库的部署流程，用户可直接使用已配置的数据库环境，无需手动执行初始化操作。

核心功能与特性

核心功能

• 预创建数据库：镜像启动时自动创建指定名称的数据库，无需手动执行CREATE DATABASE命令
• 插件支持：默认启用多种常用PostgreSQL插件，包括pg_trgm（文本搜索）、hstore（键值对存储）、pg_stat_statements（性能监控）等
• 配置优化：内置基础性能优化配置，适配中小型应用场景

特性

• 与官方PostgreSQL镜像完全兼容，支持相同的环境变量和配置方式
• 支持数据持久化存储，确保容器重启后数据不丢失
• 可通过环境变量自定义数据库名称、用户名、密码及插件列表

使用场景

• 开发环境：快速搭建具备完整功能的PostgreSQL开发环境，无需手动配置
• 测试环境：为自动化测试提供预配置的数据库实例，缩短测试准备时间
• 小型生产环境：适用于数据量不大、配置需求简单的生产场景

使用方法与配置说明

基础使用（docker run）

bash
docker run -d \
  --name postgres-preconfig \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  [镜像名称]:[标签]

docker-compose 配置示例

yaml
version: '3'
services:
  postgres:
    image: [镜像名称]:[标签]
    container_name: postgres-preconfig
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
      # 可选：自定义插件列表，多个插件用逗号分隔
      POSTGRES_PLUGINS: "pg_trgm,hstore,pg_stat_statements"
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

环境变量说明

数据持久化

通过挂载卷（如示例中的postgres-data）实现数据持久化，确保容器删除或重启后数据不丢失。

插件管理

• 默认插件：镜像默认启用pg_trgm、hstore、pg_stat_statements
• 自定义插件：通过POSTGRES_PLUGINS环境变量指定插件列表，例如：POSTGRES_PLUGINS="uuid-ossp,pgcrypto"
• 验证插件：容器启动后，可通过以下命令验证插件是否启用：

  bash
  docker exec -it postgres-preconfig psql -U myuser -d mydb -c "SELECT * FROM pg_extension;"
  

兼容性

• 支持PostgreSQL 12+版本（具体版本取决于镜像标签）
• 兼容官方PostgreSQL镜像的所有配置方式和客户端工具

注意事项

• 生产环境中建议使用强密码，并通过非root用户运行容器
• 如需自定义postgresql.conf配置，可通过挂载配置文件到/etc/postgresql/postgresql.conf实现
• 高并发场景下需根据实际需求调整性能参数（如max_connections、shared_buffers等）