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

ElasticSearch Linux 下安装及 Head 插件 | 详情

news 2025/8/3 7:35:46

全文目录：

- 开篇语
- 前言
- 1. 安装 ElasticSearch
- - 1.1 环境准备
  - 1.2 下载并安装 ElasticSearch
- 2. 安装 ElasticSearch Head 插件
- - 2.1 安装 Node.js 和 npm
  - 2.2 安装 ElasticSearch Head 插件
  - 2.3 配置 ElasticSearch Head
  - - 示例：修改 `elasticsearch.json`
- 3. 使用 Head 插件
- - 3.1 创建索引
  - 3.2 执行查询
  - 3.3 查看集群信息
- 4. 常见问题和解决方法
- - 4.1 ElasticSearch 无法启动
  - 4.2 ElasticSearch Head 访问错误
- 5. 总结
- 文末

开篇语

哈喽，各位小伙伴们，你们好呀，我是喵手。运营社区：C站/掘金/腾讯云/阿里云/华为云/51CTO；欢迎大家常来逛逛

今天我要给大家分享一些自己日常学习到的一些知识点，并以文字的形式跟大家一起交流，互相学习，一个人虽可以走的更快，但一群人可以走的更远。

我是一名后端开发爱好者，工作日常接触到最多的就是Java语言啦，所以我都尽量抽业余时间把自己所学到所会的，通过文章的形式进行输出，希望以这种方式帮助到更多的初学者或者想入门的小伙伴们，同时也能对自己的技术进行沉淀，加以复盘，查缺补漏。

小伙伴们在批阅的过程中，如果觉得文章不错，欢迎点赞、收藏、关注哦。三连即是对作者我写作道路上最好的鼓励与支持！

前言

ElasticSearch 是一个基于 Apache Lucene 构建的开源搜索和分析引擎，它通常用于处理大规模的结构化和非结构化数据。ElasticSearch 能够快速、高效地进行全文检索、日志分析、数据监控等功能，广泛应用于企业级搜索引擎、日志收集与分析、实时分析等场景。

在本篇文章中，我们将详细介绍如何在 Linux 上安装 ElasticSearch，并配置其 Head 插件用于图形化界面管理。

1. 安装 ElasticSearch

1.1 环境准备

ElasticSearch 要求 Java 版本为 OpenJDK 8 或更高版本。因此，在安装之前，请确保你的系统中已经安装了 Java。

检查 Java 版本：
```
java -version
```
如果没有安装 Java，可以使用如下命令进行安装（以 Ubuntu 为例）：
```
sudo apt update
sudo apt install openjdk-11-jre
```
通过以下命令设置 JAVA_HOME 环境变量：
```
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
```
完成安装后，可以再次执行 java -version 确认安装成功。

1.2 下载并安装 ElasticSearch

下载 ElasticSearch

你可以从 ElasticSearch 的官方网站或通过 wget 直接下载最新版本。

访问 ElasticSearch 官网，选择适合你系统的版本进行下载，或者使用以下命令下载：
```
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.10.0-linux-x86_64.tar.gz
```

解压安装包

使用以下命令解压安装包：

tar -xvzf elasticsearch-7.10.0-linux-x86_64.tar.gz

进入解压目录
```
cd elasticsearch-7.10.0/
```

启动 ElasticSearch

启动 ElasticSearch 服务：

./bin/elasticsearch

如果一切顺利，ElasticSearch 应该会开始启动，并在终端打印日志。如果系统中没有足够的资源，可能会提示一些警告，通常是因为内存设置较低。

默认情况下，ElasticSearch 监听 9200 端口。你可以通过浏览器访问 http://localhost:9200 来检查是否安装成功。你应该能看到类似以下内容的响应：

{"name" : "your-node-name","cluster_name" : "elasticsearch","cluster_uuid" : "xxxxxxxxxxxxxx","version" : {"number" : "7.10.0","build_flavor" : "default","build_type" : "tar","build_hash" : "xxxxxxx","build_date" : "2020-10-07T13:24:00.000000Z","build_snapshot" : false,"lucene_version" : "8.7.0","minimum_wire_compatibility_version" : "6.8.0","minimum_index_compatibility_version" : "6.0.0"},"tagline" : "You Know, for Search"
}

后台运行 ElasticSearch

如果希望在后台运行 ElasticSearch，可以使用如下命令：
```
nohup ./bin/elasticsearch > elasticsearch.log 2>&1 &
```
这样，ElasticSearch 将在后台运行，日志会被输出到 elasticsearch.log 文件中。

2. 安装 ElasticSearch Head 插件

ElasticSearch Head 插件是一个用于可视化操作和管理 ElasticSearch 集群的工具。它是一个基于浏览器的插件，允许你通过图形化界面进行索引管理、搜索查询、集群状态监控等操作。

2.1 安装 Node.js 和 npm

由于 ElasticSearch Head 插件是一个基于 Node.js 的应用，因此我们需要先安装 Node.js 和 npm。

安装 Node.js 和 npm

sudo apt update
sudo apt install nodejs
sudo apt install npm

验证安装：

node -v
npm -v

2.2 安装 ElasticSearch Head 插件

ElasticSearch Head 插件是一个基于前端的工具，使用了 Node.js 和 npm 进行管理。安装步骤如下：

克隆 ElasticSearch Head 仓库

你可以从 GitHub 上克隆 ElasticSearch Head 的源代码：
```
git clone https://github.com/mobz/elasticsearch-head.git
```
进入插件目录
```
cd elasticsearch-head
```
安装依赖

在该目录下运行 npm install 来安装所有必要的依赖包：
```
npm install
```
启动 Head 插件

安装完依赖后，可以通过 npm 启动 Head 插件：
```
npm run start
```
默认情况下，ElasticSearch Head 插件会在 http://localhost:9100 上运行，你可以在浏览器中访问这个地址来启动图形化管理界面。

2.3 配置 ElasticSearch Head

ElasticSearch Head 插件默认连接本地的 ElasticSearch 服务。如果你的 ElasticSearch 服务运行在不同的主机或端口，可以通过修改 elasticsearch.json 配置文件来改变连接配置。

示例：修改 `elasticsearch.json`

{"url": "http://localhost:9200"
}

将 localhost:9200 替换为你自己的 ElasticSearch 服务地址。

3. 使用 Head 插件

成功启动并访问 ElasticSearch Head 后，你将看到一个基于 Web 的用户界面，界面上提供了以下功能：

集群状态：显示集群的健康状况（绿色、黄色、红色等）以及各个节点的信息。
索引管理：可以创建、删除、查看和操作索引。
搜索查询：可以执行任意的查询，查看查询结果，并提供 JSON 格式输出。
文档管理：可以查看、修改、删除和创建文档。

3.1 创建索引

在 ElasticSearch Head 上，可以点击 “Index” 选项卡，然后点击 “Create Index”，填写索引名称、设置等。

3.2 执行查询

在 “Search” 选项卡中，你可以执行自定义查询。例如，执行简单的 match_all 查询来获取所有文档：

{"query": {"match_all": {}}
}

3.3 查看集群信息

你可以在 “Cluster” 选项卡查看集群的健康状态、节点、分片等信息。

4. 常见问题和解决方法

4.1 ElasticSearch 无法启动

内存不足：确保系统有足够的内存，并检查 jvm.options 文件配置的内存限制。你可以增加堆内存大小：
```
-Xms2g
-Xmx2g
```

4.2 ElasticSearch Head 访问错误

端口冲突：确保 9100 端口未被其他应用占用，或者修改 elasticsearch-head 的 package.json 配置文件，改变端口号。

5. 总结

通过本文的介绍，你已经学会了如何在 Linux 系统上安装并配置 ElasticSearch，以及如何安装和使用 ElasticSearch Head 插件。ElasticSearch 是一个非常强大和灵活的搜索引擎，借助 Head 插件提供的图形化管理界面，开发者可以更加轻松地进行集群管理、索引操作、查询执行等任务。