以下是在 Windows 系统上为 Elasticsearch 8 安装 ICU 分词器、IK 分词器和拼音分词器的详细步骤:

准备工作

  1. 确保已正确安装 Elasticsearch 8.x 并能正常启动
  2. 记录你的 Elasticsearch 版本号(后续下载对应版本的分词器)
  3. 确保 Elasticsearch 服务已停止(安装插件前必须停止服务)

安装 ICU 分词器

ICU 分词器是 Elasticsearch 官方维护的插件,支持多语言分词。

  1. 打开命令提示符(CMD)或 PowerShell
  2. 进入 Elasticsearch 安装目录的 bin 文件夹:
    cd D:\javaAll\elasticsearch-8.0.0\bin
    
  3. 执行安装命令:
    elasticsearch-plugin install analysis-icu
    
  4. 当出现确认提示时,输入 y 并回车
  5. 等待安装完成,会显示 “Installed analysis-icu”
    在这里插入图片描述

安装 IK 分词器

IK 分词器是针对中文的分词器,支持自定义词典。

  1. 首先确定需要安装的 IK 分词器版本,必须与 Elasticsearch 版本完全一致
  2. 打开浏览器,访问 IK 分词器的 GitHub releases 页面:
    https://release.infinilabs.com/analysis-ik/stable/

在这里插入图片描述

  1. 下载对应版本的 zip 包(例如 elasticsearch-analysis-ik-8.0.0.zip)
  2. 在 Elasticsearch 安装目录中创建 plugins/ik 文件夹:
  3. 将下载的 zip 包解压到刚创建的 ik 文件夹中
  4. 确认解压后的文件结构,应直接包含 plugin-descriptor.properties 等文件,而不是嵌套在另一个文件夹中
    在这里插入图片描述

安装拼音分词器

拼音分词器可以将中文转换为拼音,支持首字母等功能。

  1. 确定需要安装的拼音分词器版本,必须与 Elasticsearch 版本匹配

  2. 打开浏览器,访问拼音分词器的 GitHub releases 页面:
    https://release.infinilabs.com/analysis-pinyin/stable/
    在这里插入图片描述

  3. 下载对应版本的 zip 包(例如 elasticsearch-analysis-pinyin-8.0.0.zip)

  4. 在 Elasticsearch 安装目录中创建 plugins/pinyin 文件夹:

  5. 将下载的 zip 包解压到刚创建的 pinyin 文件夹中

  6. 确认文件结构正确,直接包含插件相关文件
    在这里插入图片描述

验证安装

  1. 启动 Elasticsearch 服务:

  2. 打开另一个命令提示符窗口,使用 curl 验证插件是否安装成功:

    在 curl 命令中添加 -k 或 --insecure 参数,跳过证书验证:

    curl -k -u elastic:Nf1DPSjkYq6skDNAHY1K "https://localhost:9200/_cat/plugins?v"
    
  3. 如果安装成功,会显示类似以下内容:
    在这里插入图片描述

常见问题解决

  1. 版本不匹配:确保所有分词器版本与 Elasticsearch 版本完全一致
  2. 权限问题:如果解压文件失败,尝试以管理员身份运行解压软件
  3. 文件结构错误:插件文件必须直接放在 plugins/[插件名] 目录下,不能有额外的层级
  4. 启动失败:查看 logs 目录下的日志文件,通常会明确指出错误原因

完成以上步骤后,你就成功在 Windows 系统的 Elasticsearch 8 中安装了 ICU 分词器、IK 分词器和拼音分词器,可以在索引映射中配置使用这些分词器了。

Logo

火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。

更多推荐