mixdeve/postgres-zhparser

镜像概述

postgres-zhparser是为PostgreSQL扩展zhparser构建的Docker镜像。zhparser是一款用于中文全文搜索的PostgreSQL插件，本镜像基于官方PostgreSQL镜像构建，预安装并配置了zhparser插件，简化了中文全文搜索功能的部署流程，用户可直接使用中文分词与检索能力。

核心功能和特性

• 支持多版本PostgreSQL：兼容PostgreSQL 12、13、14、15、16、17、18版本
• 跨架构支持：提供linux/amd64和linux/arm64两种架构镜像
• 预安装zhparser插件：无需手动编译安装扩展，镜像启动后即可使用中文分词功能
• 与官方镜像兼容：保留官方PostgreSQL镜像的所有基础功能和配置选项，支持标准PostgreSQL运维操作

使用场景和适用范围

适用于需要在PostgreSQL中实现中文全文搜索的各类应用场景，包括但不限于：

• 内容管理系统（CMS）的中文文章检索
• 博客平台、论坛的中文内容搜索功能
• 文档管理系统的中文文档全文检索
• 企业内部知识库的中文信息查询
• 任何需要对中文文本进行高效分词和搜索的PostgreSQL数据库应用

使用方法和配置说明

基本使用

支持版本与架构

• PostgreSQL版本：12、13、14、15、16、17、18（通过镜像标签指定，如:16表示PostgreSQL 16版本）
• 支持架构：linux/amd64、linux/arm64

启动容器

使用以下命令启动包含zhparser插件的PostgreSQL容器：

bash
docker run -d \
    --name postgres \
    -p 5432:5432 \
    -e POSTGRES_PASSWORD=postgres \
    ghcr.io/mnixry/postgres-zhparser:16

参数说明：

• -d：后台运行容器
• --name postgres：指定容器名称为postgres（可自定义）
• -p 5432:5432：将容器内PostgreSQL默认端口（5432）映射到主机5432端口
• -e POSTGRES_PASSWORD=postgres：设置数据库超级用户（postgres）的密码（生产环境建议使用强密码）
• ghcr.io/mnixry/postgres-zhparser:16：镜像地址及版本标签（16可替换为支持的其他PostgreSQL版本）

验证中文分词功能

容器启动后，可通过以下步骤验证zhparser插件功能：

1. 进入容器并连接数据库：

   bash
   docker exec -it postgres psql -U postgres
   

2. 执行中文分词测试SQL：

   sql
   select to_tsvector('chinese', '小明爱吃苹果');
   

3. 预期输出（中文分词结果）：

   ---------------------------------
    '吃':3 '小明':1 '爱':2 '苹果':4
   (1 row)
   

许可协议

本程序是自由软件：您可以根据自由软件基金会发布的GNU通用公共许可证第3版（或任何更高版本）的条款重新分发和/或修改它。

本程序的分发是希望它能有用，但不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。有关更多详细信息，请参见GNU通用公共许可证。

您应该已经收到了GNU通用公共许可证的副本。如果没有，请参见<[***]>。