部署elasticsearch需依次完成:一、安装jdk 17并配置环境变量;二、创建elasticsearch专用用户并授权;三、下载校验后解压安装包;四、修改elasticsearch.yml配置网络与安全参数;五、运行setup-passwords auto初始化密码;六、配置systemd服务并启动。

如果您计划在Linux系统中部署Elasticsearch以构建分布式搜索平台,则需严格遵循环境准备、安装配置与基础启动流程。以下是完成该部署的完整操作步骤:
一、检查并安装Java运行环境
Elasticsearch 8.x版本要求JDK 17或更高版本,且必须使用官方OpenJDK或Oracle JDK;不兼容JRE精简包或非标准构建的Java实现。
1、执行java -version命令确认当前Java版本是否满足要求。
2、若未安装或版本过低,下载JDK 17压缩包(如jdk-17.0.1_linux-x64_bin.tar.gz)至/opt目录。
3、解压至指定路径:sudo tar -xzf jdk-17.0.1_linux-x64_bin.tar.gz -C /opt/。
4、配置全局环境变量:编辑/etc/profile,追加以下三行:
export JAVA_HOME=/opt/jdk-17.0.1
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
5、执行source /etc/profile使配置生效,并再次运行java -version验证输出为17.x。
二、创建专用用户并配置权限
Elasticsearch禁止以root身份直接运行,必须使用独立非特权用户启动服务,避免潜在安全风险与文件权限冲突。
1、执行sudo useradd -m -d /home/elasticsearch -s /bin/bash elasticsearch创建用户。
2、为该用户设置密码:sudo passwd elasticsearch。
3、将Elasticsearch安装目录所有权递归赋予该用户:sudo chown -R elasticsearch:elasticsearch /opt/elasticsearch。
4、切换至该用户:sudo -i -u elasticsearch,后续所有安装及启动操作均在此用户上下文中进行。
三、下载并解压Elasticsearch安装包
从官网获取对应架构与版本的tar.gz发行包可确保组件完整性与签名验证通过,避免使用第三方镜像源导致的校验失败或功能缺失。
1、访问https://www.elastic.co/downloads/elasticsearch,复制Linux x86_64架构的下载链接(例如https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.12.2-linux-x86_64.tar.gz)。
2、在/opt目录下执行下载:wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.12.2-linux-x86_64.tar.gz。
3、校验SHA512值(官网页面提供):shasum -a 512 elasticsearch-8.12.2-linux-x86_64.tar.gz,比对输出是否一致。
4、解压至/opt/elasticsearch:tar -xzf elasticsearch-8.12.2-linux-x86_64.tar.gz -C /opt/ && mv /opt/elasticsearch-8.12.2 /opt/elasticsearch。
四、修改核心配置文件
默认配置仅支持本地回环访问且启用安全特性,需调整网络绑定、节点发现与TLS设置以支持多节点通信与外部访问。
1、编辑/opt/elasticsearch/config/elasticsearch.yml,取消注释并修改以下参数:
node.name: node-1
network.host: 0.0.0.0
http.port: 9200
discovery.seed_hosts: ["127.0.0.1:9300"]
cluster.initial_master_nodes: ["node-1"]
2、确认xpack.security.enabled: true保持启用状态,Elasticsearch 8.x默认强制开启安全模块。
3、保存后退出,确保文件属主为elasticsearch用户,且权限为644:chmod 644 /opt/elasticsearch/config/elasticsearch.yml。
五、初始化安全证书与密码
首次启动时,Elasticsearch自动执行安全初始化流程,生成TLS证书并为内置用户分配随机密码;该过程不可跳过且仅在空数据目录下触发。
1、确保/opt/elasticsearch/data目录为空(首次部署可忽略,若曾运行过需清空)。
2、切换至elasticsearch用户后,执行:/opt/elasticsearch/bin/elasticsearch --enrollment-token <strong><font color="green">此处需先运行setup-passwords auto获取token</font></strong>。
3、实际应先运行:/opt/elasticsearch/bin/elasticsearch-setup-passwords auto --batch,该命令将自动生成并打印elastic、kibana_system等6个内置账户密码。
4、记录控制台输出的elastic用户密码,后续HTTP访问必需携带该凭据,例如:curl -u elastic:<strong><font color="green">生成的密码</font></strong> https://localhost:9200/_cat/nodes?v。
六、配置系统级服务并启动
将Elasticsearch注册为systemd服务可实现开机自启、日志集成与进程守护,优于前台手动启动方式。
1、创建服务定义文件:sudo vim /etc/systemd/system/elasticsearch.service。
2、填入以下内容(注意路径与用户匹配):
[Unit]
Description=Elasticsearch
Wants=network-online.target
After=network-online.target
[Service]
Type=buffer
RuntimeDirectory=elasticsearch
User=elasticsearch
Group=elasticsearch
Environment=ES_HOME=/opt/elasticsearch
Environment=ES_PATH_CONF=/opt/elasticsearch/config
Environment=PID_DIR=/var/run/elasticsearch
LimitNOFILE=65536
LimitMEMLOCK=infinity
ExecStart=/opt/elasticsearch/bin/elasticsearch -p ${PID_DIR}/elasticsearch.pid --quiet
Restart=on-failure
[Install]
WantedBy=multi-user.target
3、重载systemd配置:sudo systemctl daemon-reload。
4、启用并启动服务:sudo systemctl enable elasticsearch && sudo systemctl start elasticsearch。
5、查看运行状态:sudo systemctl status elasticsearch,确认显示active (running)且无ERROR日志。











