isaac928/opensearch-plugins

OpenSearch v2.0.1 插件增强镜像

镜像概述

本镜像基于 OpenSearch v2.0.1 构建，预安装了多种文本分析插件和映射器插件，旨在提供开箱即用的增强型搜索和分析能力，无需手动安装插件即可支持多语言处理、语音分析、文档大小跟踪等功能。

核心功能与特性

预装插件列表

文本分析插件

• analysis-icu：提供 ICU 分析器，支持多语言文本处理、Unicode 规范化及复杂字符集处理
• analysis-kuromoji：日语分词器，支持日语文本的精确分词、形态分析和词性标注
• analysis-nori：韩语分词器，基于韩国语学会标准，提供韩语词汇分析和形态素分解
• analysis-phonetic：语音分析器，支持 Soundex、Metaphone 等语音算法，实现语音相似性匹配
• analysis-smartcn：中文分词器，提供基于词典的智能中文文本分词和语义分析
• analysis-stempel：波兰语分词器，基于 Stempel 算法实现波兰语词根提取和词形还原
• analysis-ukrainian：乌克兰语分析器，支持乌克兰语文本的分词和语言特定处理

映射器插件

• mapper-size：添加文档大小映射字段，可索引和查询文档的存储大小信息
• mapper-murmur3：生成 Murmur3 哈希值字段，用于快速文档标识、去重和比较
• mapper-annotated-text：支持带注释的文本字段，可在索引时处理和保留注释标记

使用场景

• 多语言搜索应用：需处理中文、日语、韩语、波兰语、乌克兰语等多语言文本的搜索引擎
• 语音相似性搜索：需要基于发音相似性匹配（如人名、地名）的应用场景
• 文档元数据跟踪：需监控文档大小、生成唯一标识的日志分析或内容管理系统
• 精细化文本分析：学术研究、内容分类等需要深度语言处理的场景

使用方法

基本部署

使用 docker run 命令启动容器：

bash
docker run -d \
  --name opensearch-enhanced \
  -p 9200:9200 \
  -p 9600:9600 \
  -e "discovery.type=single-node" \
  -e "OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m" \
  your-image-repo/opensearch-plugins:2.0.1

验证插件安装

容器启动后，通过以下命令检查已安装插件：

bash
curl http://localhost:9200/_cat/plugins?v

预期输出应包含所有预装插件名称，格式如下：

opensearch-node1 analysis-icu 2.0.1
opensearch-node1 analysis-kuromoji 2.0.1
...

基本配置

环境变量

常用配置环境变量：

• discovery.type=single-node：单节点模式（开发环境）
• cluster.name：集群名称（默认：opensearch-cluster）
• node.name：节点名称（默认：随机生成）
• OPENSEARCH_JAVA_OPTS：JVM 配置（建议根据实际需求调整内存）

插件使用示例（analysis-smartcn 中文分词）

创建索引时指定中文分词器：

bash
curl -X PUT "http://localhost:9200/chinese_docs" -H "Content-Type: application/json" -d '
{
  "settings": {
    "analysis": {
      "analyzer": {
        "smartcn_analyzer": {
          "type": "smartcn"
        }
      }
    }
  },
  "mappings": {
    "properties": {
      "content": {
        "type": "text",
        "analyzer": "smartcn_analyzer"
      }
    }
  }
}'

Docker Compose 部署

创建 docker-compose.yml：

yaml
version: '3'
services:
  opensearch:
    image: your-image-repo/opensearch-plugins:2.0.1
    container_name: opensearch-enhanced
    ports:
      - "9200:9200"
      - "9600:9600"
    environment:
      - discovery.type=single-node
      - cluster.name=opensearch-demo
      - node.name=demo-node
      - OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g
    volumes:
      - opensearch-data:/usr/share/opensearch/data
    restart: unless-stopped

volumes:
  opensearch-data:

启动服务：

bash
docker-compose up -d

注意事项

• 生产环境建议调整 JVM 内存配置（OPENSEARCH_JAVA_OPTS），避免内存不足
• 多节点部署时需移除 discovery.type=single-node，并配置集群发现参数
• 部分插件（如 analysis-icu）可能增加索引和查询的资源消耗，需根据实际负载调整服务器配置