lyra95/postgres-bigm

PostgreSQL 镜像（含 pg_bigm 扩展）

概述

本镜像为PostgreSQL数据库提供预安装的pg_bigm扩展，支持bitnami/postgresql和官方postgres两种基础镜像。pg_bigm是一款针对东亚语言优化的全文搜索扩展，能够高效处理中文、日文等语言的分词与检索需求，简化需东亚语言全文搜索功能的应用部署流程。

核心功能与特性

• 预安装pg_bigm扩展：无需手动编译安装，镜像内置pg_bigm扩展，可直接启用
• 多基础镜像支持：兼容bitnami/postgresql和官方postgres两种主流PostgreSQL镜像
• 配置简化：针对不同基础镜像提供特定配置方法，降低pg_bigm使用门槛

使用场景

• 需要对中文、日文等东亚语言进行全文搜索的应用系统
• 内容管理系统（CMS）、博客平台、文档检索系统等文本密集型应用
• 基于PostgreSQL的数据分析平台，需处理东亚语言文本数据

使用方法与配置说明

前置配置：加载 pg_bigm

根据pg_bigm官方安装指南，建议在postgresql.conf中设置shared_preload_libraries = 'pg_bigm'（原作者实践中未配置也可运行，但建议按标准流程配置）。以下是不同基础镜像的配置方法：

Bitnami PostgreSQL 镜像

通过环境变量POSTGRESQL_SHARED_PRELOAD_LIBRARIES设置：

bash
docker run -e POSTGRESQL_SHARED_PRELOAD_LIBRARIES=pg_bigm lyra95/postgres-bigm:bitnami

对于Bitnami Helm Chart，在values.yaml中配置：

yaml
postgresqlSharedPreloadLibraries: pg_bigm

官方 PostgreSQL 镜像

需自定义postgresql.conf文件：

1. 从官方镜像复制默认配置模板：

bash
docker run --rm postgres cat /usr/share/postgresql/postgresql.conf.sample > postgresql.conf

2. 编辑配置文件，添加：

shared_preload_libraries = 'pg_bigm'

3. 运行容器时挂载配置文件：

bash
docker run -v $(pwd)/postgresql.conf:/var/lib/postgresql/data/postgresql.conf lyra95/postgres-bigm:official

验证 pg_bigm 安装

进入容器后连接PostgreSQL，执行以下SQL验证扩展是否安装成功：

sql
CREATE EXTENSION pg_bigm;
SELECT * FROM pg_extension WHERE extname = 'pg_bigm';

若返回包含pg_bigm的记录，则表示扩展已成功启用。

Docker Compose 部署示例

Bitnami 版本

yaml
version: '3'
services:
  postgres:
    image: lyra95/postgres-bigm:bitnami
    environment:
      - POSTGRESQL_USER=myuser
      - POSTGRESQL_PASSWORD=mypassword
      - POSTGRESQL_DATABASE=mydb
      - POSTGRESQL_SHARED_PRELOAD_LIBRARIES=pg_bigm
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

官方版本

yaml
version: '3'
services:
  postgres:
    image: lyra95/postgres-bigm:official
    environment:
      - POSTGRES_USER=myuser
      - POSTGRES_PASSWORD=mypassword
      - POSTGRES_DB=mydb
    ports:
      - "5432:5432"
    volumes:
      - ./postgresql.conf:/var/lib/postgresql/data/postgresql.conf
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data: