> 技术文档 > Elasticsearch超详细安装部署教程(Windows & Linux双系统)_elasticsearch安装

Elasticsearch超详细安装部署教程(Windows & Linux双系统)_elasticsearch安装


文章目录

    • 一、前言
    • 二、Windows系统安装部署
      • 2.1 环境准备
      • 2.2 Elasticsearch安装
      • 2.3 安装为Windows服务
      • 2.4 Head插件安装
      • 2.5 Kibana集成(可选
    • 三、Linux系统安装部署
      • 3.1 环境准备
      • 3.2 Elasticsearch安装
      • 3.3 系统优化
      • 3.4 启动服务
      • 3.5 安全配置(可选)
      • 3.6 Kibana安装(可选)
    • 四、常见问题排查
      • 4.1 Windows系统
      • 4.2 Linux系统
    • 五、总结

一、前言

Elasticsearch是一个基于Lucene的分布式搜索和分析引擎,适用于日志分析、全文搜索等场景。本文提供Windows和Linux双系统的安装部署教程,包含环境配置、服务安装、插件集成及安全设置。


二、Windows系统安装部署

2.1 环境准备

  1. 安装JDK

    • 访问Oracle JDK下载页面下载JDK 11或更高版本。
    • 安装完成后配置环境变量:
      JAVA_HOME = C:\\Program Files\\Java\\jdk-11Path += %JAVA_HOME%\\bin
  2. 验证Java环境
    打开CMD输入:

    java -version

2.2 Elasticsearch安装

  1. 下载Elasticsearch
    访问官方下载页选择Windows ZIP包(如8.17.0版本)。

  2. 解压并启动
    解压到D:\\elasticsearch,进入bin目录运行:

    elasticsearch.bat
  3. 验证服务
    浏览器访问:

    http://localhost:9200

    返回JSON即表示成功。

2.3 安装为Windows服务

  1. 安装服务
    以管理员身份运行CMD,进入bin目录执行:

    elasticsearch-service.bat install
  2. 管理服务

    elasticsearch-service.bat start # 启动elasticsearch-service.bat stop # 停止elasticsearch-service.bat remove # 卸载

2.4 Head插件安装

  1. 安装Node.js
    下载Node.js LTS版本,安装后验证:

    node -v
  2. 安装Grunt

    npm install -g grunt-cli
  3. 下载Head插件
    从GitHub仓库下载ZIP包,解压到D:\\elasticsearch-head

  4. 启动Head
    进入解压目录执行:

    npm install && npm start

    浏览器访问:

    http://localhost:9100
  5. 配置CORS
    修改elasticsearch.yml

    http.cors.enabled: truehttp.cors.allow-origin: \"*\"

2.5 Kibana集成(可选)

  1. 下载Kibana
    访问Kibana下载页,选择与ES匹配的版本。

  2. 修改配置
    编辑kibana.yml

    server.port: 5601server.host: \"0.0.0.0\"elasticsearch.hosts: [\"http://localhost:9200\"]
  3. 启动Kibana
    进入bin目录运行:

    kibana.bat

三、Linux系统安装部署

3.1 环境准备

  1. 安装JDK

    wget https://download.java.net/openjdk/jdk8u392/ri/openjdk-8u392-b07-linux-x64-ri.tar.gztar -zxvf openjdk-8u392-b07-linux-x64-ri.tar.gz -C /optecho \'export JAVA_HOME=/opt/jdk8u392-b07\' >> ~/.bashrcsource ~/.bashrc
  2. 创建用户组

    groupadd esgroupuseradd -g esgroup esuserpasswd esuser # 设置密码

3.2 Elasticsearch安装

  1. 下载并解压

    wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.17.0-linux-x86_64.tar.gztar -zxvf elasticsearch-8.17.0-linux-x86_64.tar.gz -C /optln -s /opt/elasticsearch-8.17.0 /opt/elasticsearch
  2. 配置权限

    chown -R esuser:esgroup /opt/elasticsearch*
  3. 修改配置文件
    编辑/opt/elasticsearch/config/elasticsearch.yml

    cluster.name: my-clusternode.name: node-1network.host: 0.0.0.0http.port: 9200cluster.initial_master_nodes: [\"node-1\"]

3.3 系统优化

  1. 调整文件句柄数
    编辑/etc/security/limits.conf

    esuser hard nofile 65536
  2. 修改虚拟内存
    编辑/etc/sysctl.conf

    vm.max_map_count=262144

    执行:

    sysctl -p

3.4 启动服务

  1. 切换用户并启动

    su - esusercd /opt/elasticsearch/bin./elasticsearch
  2. 后台启动(可选)

    nohup ./elasticsearch > /dev/null 2>&1 &

3.5 安全配置(可选)

  1. 生成TLS证书
    使用官方脚本生成证书:

    ./bin/elasticsearch-certutil cert -out config/certs/elastic-certificates.p12 -pass \"\"
  2. 配置HTTPS
    修改elasticsearch.yml

    xpack.security.enabled: truexpack.security.http.ssl.enabled: truexpack.security.http.ssl.key: certs/elastic-certificates.p12
  3. 设置密码

    ./bin/elasticsearch-setup-passwords interactive

3.6 Kibana安装(可选)

  1. 下载并解压

    wget https://artifacts.elastic.co/downloads/kibana/kibana-8.17.0-linux-x86_64.tar.gztar -zxvf kibana-8.17.0-linux-x86_64.tar.gz -C /opt
  2. 修改配置
    编辑/opt/kibana/config/kibana.yml

    server.port: 5601server.host: \"0.0.0.0\"elasticsearch.hosts: [\"https://localhost:9200\"]elasticsearch.ssl.certificateAuthorities: [\"/opt/elasticsearch/config/certs/http_ca.crt\"]
  3. 启动Kibana

    nohup /opt/kibana/bin/kibana > /dev/null 2>&1 &

四、常见问题排查

4.1 Windows系统

  • 启动失败:检查JDK版本和环境变量,确保无空格路径。
  • Head插件无法连接:确认elasticsearch.yml中CORS配置正确。

4.2 Linux系统

  • 权限问题:确保目录所有权属于esuser
  • 内存不足:调整jvm.options中的-Xms-Xmx参数。
  • 防火墙拦截:开放9200和5601端口:
    firewall-cmd --permanent --add-port=9200/tcpfirewall-cmd --reload

五、总结

本文提供了Elasticsearch在Windows和Linux系统的详细安装部署流程,涵盖环境配置、服务安装、插件集成及安全设置。根据实际需求选择是否启用HTTPS和Kibana,生产环境建议配置集群模式以提高可用性。

手工编织毛衣