当前位置: 首页 > news >正文

elasticsearch安装插件 - 实践

针对 Elasticsearch 9.1.3,需下载该仓库下版本为 9.1.3 的 IK 分词器,确保与 ES 版本完全一致。
分词器下载

一、核心匹配规则

infinilabs/analysis-ik 的版本命名严格遵循「与 Elasticsearch 版本一一对应」的原则:

  • ES 版本 → IK 分词器版本:9.1.39.1.3
  • 下载链接格式:https://github.com/infinilabs/analysis-ik/releases/download/v{ES版本}/elasticsearch-analysis-ik-{ES版本}.zip

二、在 Elasticsearch容器中安装(两种方式)

例如:elasticsearch-analysis-ik分词器下载

方式 1:在线安装(推荐,无需本地下载)
  1. 进入 ES 容器
    先通过 docker ps 查看 ES 容器的名称或 ID,再执行进入命令:

    docker exec -it <你的ES容器ID/名称> /bin/bash

    示例:若容器 ID 为 152ebbfee746,则执行 docker exec -it 152ebbfee746 /bin/bash

  2. 执行在线安装命令
    直接使用 ES 自带的 elasticsearch-plugin 工具,从 infinilabs 仓库拉取 9.1.3 版本的 IK 分词器:

    ./bin/elasticsearch-plugin install https://release.infinilabs.com/analysis-ik/stable/elasticsearch-analysis-ik-<版本>.zip
    • 安装过程中会提示「是否信任该插件」,输入 y 确认即可。
  3. 重启 ES 容器
    安装完成后,退出容器(执行 exit),并重启容器使插件生效:

    docker restart <你的ES容器ID/名称>
方式 2:离线安装(适用于容器无法联网的场景)
  1. 本地下载 IK 分词器包
    浏览器访问 infinilabs 的 9.1.3 版本发布页,下载压缩包:
    https://release.infinilabs.com/analysis-ik/stable/elasticsearch-analysis-ik-9.1.3.zip
    下载文件名为 elasticsearch-analysis-ik-9.1.3.zip

  2. 将压缩包传入 ES 容器
    使用 docker cp 命令,将本地下载的压缩包复制到容器内的 ES 插件目录(默认插件目录为 /usr/share/elasticsearch/plugins):

    # 格式:docker cp 本地压缩包路径 容器ID/名称:容器内目标路径
    docker cp /本地路径/elasticsearch-analysis-ik-9.1.3.zip <你的ES容器ID/名称>:/usr/share/elasticsearch/plugins/

    示例(本地文件在 ~/Downloads 目录):

    docker cp ~/Downloads/elasticsearch-analysis-ik-9.1.3.zip 152ebbfee746:/usr/share/elasticsearch/plugins/
  3. 进入容器并解压
    再次进入容器,进入插件目录并解压压缩包:

    # 1. 进入容器
    docker exec -it <你的ES容器ID/名称> /bin/bash# 2. 进入插件目录cd /usr/share/elasticsearch/plugins/# 3. 解压(若容器内无 unzip 工具,先执行 apt update && apt install -y unzip 安装)unzip elasticsearch-analysis-ik-9.1.3.zip# 4. 删除压缩包(可选,节省空间)rm -rf elasticsearch-analysis-ik-9.1.3.zip
  4. 重启 ES 容器
    退出容器后重启,确保插件加载:

    docker restart <你的ES容器ID/名称>

三、验证安装是否成功

重启容器后,通过 Kibana Dev Tools 或 curl 测试 IK 分词器是否生效:

  1. 在 Kibana Dev Tools 执行:
    GET _analyze
    {
    "analyzer": "ik_smart", // IK 分词器的「智能分词」模式
    "text": "在Elasticsearch 9.1.3中使用IK分词器" // 待分词的中文文本
    }
  2. 若返回如下包含中文分词结果的响应,说明安装成功:
    {
    "tokens" : [
    {
    "token" : "在",
    "start_offset" : 0,
    "end_offset" : 1,
    "type" : "CN_CHAR",
    "position" : 0
    },
    {
    "token" : "elasticsearch",
    "start_offset" : 1,
    "end_offset" : 14,
    "type" : "ENGLISH",
    "position" : 1
    },
    {
    "token" : "9.1.3",
    "start_offset" : 15,
    "end_offset" : 19,
    "type" : "ARABIC",
    "position" : 2
    },
    {
    "token" : "中",
    "start_offset" : 19,
    "end_offset" : 20,
    "type" : "CN_CHAR",
    "position" : 3
    },
    {
    "token" : "使用",
    "start_offset" : 20,
    "end_offset" : 22,
    "type" : "CN_WORD",
    "position" : 4
    },
    {
    "token" : "ik",
    "start_offset" : 22,
    "end_offset" : 24,
    "type" : "ENGLISH",
    "position" : 5
    },
    {
    "token" : "分词器",
    "start_offset" : 24,
    "end_offset" : 27,
    "type" : "CN_WORD",
    "position" : 6
    }
    ]
    }

四、注意事项

  1. 版本必须严格一致:若 ES 是 9.1.3,IK 分词器必须是 9.1.3,版本不匹配会导致插件加载失败(容器日志会报 version conflict 错误)。
  2. 容器权限问题:若安装时提示「权限不足」,可在进入容器后,先执行 chown -R elasticsearch:elasticsearch /usr/share/elasticsearch/plugins/ 赋予 ES 用户插件目录的权限。
  3. 集群环境需全节点安装:若 ES 是集群(多容器),需在所有节点容器中重复上述安装步骤,否则集群会因节点插件不一致导致异常。
http://www.hskmm.com/?act=detail&tid=18868

相关文章:

  • 个人学习——前端react项目框架
  • 软件基础第一次作业
  • LGP9755 [CSP-S 2023] 种树 学习笔记
  • 7、revision 是 Maven 3.5+ 引入的现代版本管理机制 - 实践
  • P1731 生日蛋糕 做题记录
  • 如何有效提升代码覆盖率:从单元测试到集成测试的实践指南
  • Spring知识点(2)
  • 超越实习期的AI自动化工具:播客工作流与Slack导出器实战
  • 调度器的各项指标以及计算方式
  • 浅谈dsu on tree
  • JavaDay10
  • 昇腾多机推理极速上手:10倍简化的 DeepSeek R1 超大规模模型部署
  • python开始exe应用程序初级教程
  • B站油管抖音一键笔记
  • 介绍自己
  • pycharm更换国内源
  • 基于Python+Vue开发的反诈视频宣传管理系统源码+运行步骤
  • 0voice-2.2.1-服务器百万并发实现
  • 微服务去掉认证的功能
  • INNER JOIN LEFT JOIN, RIGHT JOIN, FULL OUTER JOIN
  • 进程调度的时机,切换与过程
  • 深入解析:六维力传感器材质选择:影响性能与精度的关键因素
  • 按键精灵安卓/ios辅助工具,脚本开发新手教程ui界面介绍 - 教程
  • P3197fwx - FanWenxuan
  • 2025年AI大模型赋能智能座舱研究报告:技术、资本与市场|附20+份报告PDF、数据仪表盘汇总下载
  • 专题:2025年AI Agent智能体行业洞察报告|附110+份报告PDF、数据仪表盘汇总下载
  • 开启我的Java旅程
  • MYSQL: 时间戳演示
  • 自动化测试用例结构分析
  • 谷歌新款具身智能模型 Gemini Robotics 1.5 和 Gemini Robotics-ER 1.5