nnurphy/pg

镜像概述

nnurphy/pg是一个PostgreSQL数据库镜像，支持通过环境变量灵活配置数据库关键参数，帮助用户快速部署和管理PostgreSQL服务，适用于开发、测试及需要自定义配置的场景。

核心功能

• 可配置超级用户（POSTGRES_USER）及密码（POSTGRES_PASSWORD）
• 支持自定义默认数据库名称（POSTGRES_DB）
• 允许设置initdb参数（POSTGRES_INITDB_ARGS）及事务日志存储位置（POSTGRES_INITDB_WALDIR）
• 可调整postgresql.conf中的关键参数（如shared_buffers、wal_level等）
• 支持自定义数据库文件存储路径（PGDATA）

使用场景

• 开发环境快速搭建PostgreSQL数据库进行应用测试
• 需要自定义数据库配置的生产或测试场景
• 需要挂载外部字典文件（如结巴分词字典）的全文搜索场景

配置说明

环境变量

POSTGRES_PASSWORD

推荐使用的环境变量，用于设置PostgreSQL超级用户的密码。默认超级用户由POSTGRES_USER定义。
注意1：本地连接（同一容器内）启用信任认证无需密码，跨主机/容器连接需密码；
注意2：该变量仅设置数据库实例内的超级用户密码，与psql客户端的PGPASSWORD环境变量无关。

POSTGRES_USER

可选变量，与POSTGRES_PASSWORD配合创建超级用户及同名数据库，默认使用postgres用户。

POSTGRES_DB

可选变量，定义镜像首次启动时创建的默认数据库名称，默认使用POSTGRES_USER的值。

POSTGRES_INITDB_ARGS

可选变量，向initdb传递参数（空格分隔字符串），例如添加数据页校验和：-e POSTGRES_INITDB_ARGS="--data-checksums"。

POSTGRES_INITDB_WALDIR

可选变量，定义事务日志存储位置（默认在PGDATA子目录）。PostgreSQL 9.x版本需使用POSTGRES_INITDB_XLOGDIR。

postgresql.conf相关参数

• PGC_SHARED_BUFFERS
• PGC_SHARED_PRELOAD_LIBRARIES
• PGC_WAL_LEVEL
• PGC_MAX_REPLICATION_SLOTS

PGDATA

可选变量，定义数据库文件存储路径，默认值为/var/lib/postgresql/data。若使用挂载点作为数据卷，建议使用子目录（如/var/lib/postgresql/data/pgdata）。

启动示例

bash
docker run --name test-fts --rm \
    -p 5532:5432 \
    -e POSTGRES_PASSWORD=*** \
    -e PGCONF_SHARED_BUFFERS=512MB \
    -v $PWD/user.dict:/usr/share/postgresql/12/tsearch_data/jieba_user.dict \
    nnurphy/pg