3. Elasticsearch 单节点安装：下载、配置与验证

Elasticsearch 是 ELK 栈的核心存储与检索引擎。本节将演示在 Linux 环境下完成单节点安装的全过程，涵盖二进制包下载、核心参数配置、启动验证及常见问题排查。掌握单节点安装是后续搭建集群与集成 Logstash、Kibana 的基础。

3.1 下载与解压

Elasticsearch 官方提供 .tar.gz 与 .rpm / .deb 包。本课程采用通用性最强的 .tar.gz 方式，适用于所有 Linux 发行版。

3.1.1 版本选择与下载

建议使用 7.x 或 8.x LTS 版本。以下以 Elasticsearch 7.17.15 为例（请根据实际需求替换版本号）。

3.1.2 解压与目录结构

# 解压到 /usr/local 目录
tar -zxvf elasticsearch-7.17.15-linux-x86_64.tar.gz -C /usr/local/

# 创建软链接，方便版本切换
ln -s /usr/local/elasticsearch-7.17.15 /usr/local/elasticsearch

# 查看解压后的目录结构
ls -l /usr/local/elasticsearch/

解压后关键目录说明：

# 创建 elasticsearch 用户
useradd -m -s /bin/bash elasticsearch

# 更改目录所有者
chown -R elasticsearch:elasticsearch /usr/local/elasticsearch-7.17.15

3.2 配置 elasticsearch.yml 核心参数

elasticsearch.yml 位于 config/ 目录下，是决定节点行为的核心配置文件。单节点安装只需关注以下四个关键参数。

3.2.1 参数详解

3.2.2 配置示例

编辑 /usr/local/elasticsearch/config/elasticsearch.yml，追加或修改以下内容：

# ---------------------------- 集群与节点 ----------------------------
cluster.name: elk-cluster
node.name: node-1

# ---------------------------- 数据与日志路径 ----------------------------
path.data: /data/elasticsearch/data
path.logs: /data/elasticsearch/logs

# ---------------------------- 网络与端口 ----------------------------
network.host: 0.0.0.0
http.port: 9200

# ---------------------------- 单节点发现（重要） ----------------------------
discovery.type: single-node

3.3 启动与验证

3.3.1 启动 Elasticsearch

切换到 elasticsearch 用户，执行启动脚本：

# 切换用户
su - elasticsearch

# 前台启动（调试用）
/usr/local/elasticsearch/bin/elasticsearch

# 后台启动（生产推荐）
/usr/local/elasticsearch/bin/elasticsearch -d -p /tmp/elasticsearch.pid

启动参数说明：

• -d：后台守护进程模式
• -p：将 PID 写入指定文件，便于后续管理

3.3.2 验证节点状态

节点启动约 10-30 秒后，通过以下方式验证：

1. 检查进程

ps -ef | grep elasticsearch | grep -v grep

2. 查看日志

tail -f /data/elasticsearch/logs/elk-cluster.log

正常启动日志末尾应包含：

[INFO ][o.e.n.Node               ] [node-1] started
[INFO ][o.e.l.LicenseService     ] [node-1] license [xxxx] mode [basic] - valid
[INFO ][o.e.g.GatewayService     ] [node-1] recovered [0] indices into cluster_state

3. API 验证

curl -X GET "http://localhost:9200/"

返回示例：

{
  "name" : "node-1",
  "cluster_name" : "elk-cluster",
  "cluster_uuid" : "xxxx",
  "version" : {
    "number" : "7.17.15",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "xxxx",
    "build_date" : "2024-01-15T10:00:00Z",
    "build_snapshot" : false,
    "lucene_version" : "8.11.1",
    "minimum_wire_compatibility_version" : "6.8",
    "minimum_index_compatibility_version" : "6.0.0"
  },
  "tagline" : "You Know, for Search"
}

4. 集群健康检查

curl -X GET "http://localhost:9200/_cluster/health?pretty"

期望输出：

{
  "cluster_name" : "elk-cluster",
  "status" : "green",
  "timed_out" : false,
  "number_of_nodes" : 1,
  "number_of_data_nodes" : 1,
  "active_primary_shards" : 0,
  "active_shards" : 0,
  "relocating_shards" : 0,
  "initializing_shards" : 0,
  "unassigned_shards" : 0,
  "delayed_unassigned_shards" : 0,
  "number_of_pending_tasks" : 0,
  "number_of_in_flight_fetch" : 0,
  "task_max_waiting_in_queue_millis" : 0,
  "active_shards_percent_as_number" : 100.0
}

3.4 单节点安装流程总览

3.5 常见问题与排查