文档中心

云搜索服务

自定义插件

管理自定义插件

当您上传插件文件后，您可以安装自定义插件。本文介绍如何管理自定义插件。

注意事项

安装自定义插件会触发重启集群，建议在业务低峰期安装插件。

自定义插件可能会影响实例的稳定性。因此，在实例上安装自定义插件前，请务必先在本地进行安装测试验证，保证插件的可用性和安全性。

您在上传与安装自定义插件时，如果出现上传失败、安装卡住或者卸载卡住等异常问题，可参见自定义插件安装异常处理方案进行排查解决。

前提条件

在实例安装插件会触发集群重启，如果插件存在代码缺陷，将会导致实例节点安装后启动失败，同时影响集群的稳定性。任何需要上传并安装到云搜索服务实例中的自定义插件，都需要提前在本地自建的 Elasticsearch 服务中进行安装测试，只有安装测试通过后的插件才可以上传并安装到云搜索服务实例。

在本地 Elasticsearch 服务中安装插件。

命令为：./bin/elasticsearch-plugin install file:///path-to-your-plugins.zip

重启集群加载插件。

查询插件是否安装成功。

执行GET /_cat/plugins?v命令，获取插件信息，判断自定义插件是否安装成功。

安装自定义插件

当您上传自定义插件后，您可以安装插件。

登录云搜索服务控制台。

在顶部导航栏，选择目标项目和地域。

在实例列表页面，单击目标实例名称。

在左侧导航栏选择实例管理 > 插件管理，然后单击自定义插件页签。

在自定义插件页签下，单击批量安装/升级/卸载。

在目标插件的操作列中勾选安装并选择需要安装的插件版本，然后单击批量提交。

支持同时勾选多个自定义插件，进行批量安装操作。

在批量提交对话框，查看安装插件的提示信息，然后单击确定。

说明

安装自定义插件会触发重启集群，建议在业务低峰期安装插件。

自定义插件本身可能会影响实例的稳定性，请务必保证自定义插件的可用性和安全性。

查看自定义插件安装进度。

执行插件安装操作后，目标插件状态显示为安装中。当显示插件的目标版本后，表示插件安装成功。

升级自定义插件

每个插件最多支持上传 5 个不同版本的插件文件，只能安装 1 个版本的插件。插件安装后，您可以根据业务需要升级插件的版本。

登录云搜索服务控制台。

在顶部导航栏，选择目标项目和地域。

在实例列表页面，单击目标实例名称。

在左侧导航栏选择实例管理 > 插件管理，然后单击自定义插件页签。

在自定义插件页签下，单击批量安装/升级/卸载。

在目标插件的操作列中，勾选升级并选择需要升级到的目标版本，然后单击批量提交。

在批量提交对话框，查看提示信息和升级后的插件版本，然后单击确定。

说明

升级自定义插件会触发重启集群，建议在业务低峰期安装插件。

查看自定义插件升级进度。

执行插件升级操作后，插件历史版本显示为卸载中，新版本显示为安装中。当插件版本显示为新版本后，则表示插件升级成功。

注意

如果升级插件失败，您可以在任务中心回滚该操作。详情请参见查看任务进度。

最近更新时间：2026.03.25 17:29:45

这个页面对您有帮助吗？

有用

无用