以下是在 Ubuntu 系统上安装 Elasticsearch 8.13.4 的详细步骤:
1. 准备工作
- 系统要求:确保是 Ubuntu 20.04/22.04 LTS(推荐),且内存 ≥ 2GB。
-
权限要求:使用
sudo权限的账户操作。
2. 安装 Java
Elasticsearch 8.x 需要 Java 17 或更高版本:
sudo apt update
sudo apt install openjdk-17-jdk -y
验证安装:
java -version
3. 下载 Elasticsearch 8.13.4
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.13.4-linux-x86_64.tar.gz
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.13.4-linux-x86_64.tar.gz.sha512
校验文件完整性:
sha512sum -c elasticsearch-8.13.4-linux-x86_64.tar.gz.sha512
解压:
tar -xzf elasticsearch-8.13.4-linux-x86_64.tar.gz
sudo mv elasticsearch-8.13.4 /usr/share/elasticsearch
4. 配置 Elasticsearch
内存调整(可选)
编辑 jvm.options:
sudo nano /usr/share/elasticsearch/config/jvm.options
修改堆内存(根据服务器配置调整):
-Xms1g
-Xmx1g
修改系统配置
调整虚拟内存和最大线程数:
sudo sysctl -w vm.max_map_count=262144
echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf
调整用户资源限制:
echo "* soft nofile 65536" | sudo tee -a /etc/security/limits.conf
echo "* hard nofile 65536" | sudo tee -a /etc/security/limits.conf
5. 创建专用用户
sudo adduser --no-create-home --disabled-login --disabled-password --shell /bin/false elasticsearch
sudo chown -R elasticsearch:elasticsearch /usr/share/elasticsearch
6. 启动 Elasticsearch
临时启动(测试用)
sudo -u elasticsearch /usr/share/elasticsearch/bin/elasticsearch
按 Ctrl+C 停止。
配置系统服务
创建服务文件:
sudo nano /etc/systemd/system/elasticsearch.service
内容如下:
[Unit]
Description=Elasticsearch
Wants=network-online.target
After=network-online.target
[Service]
User=elasticsearch
Group=elasticsearch
ExecStart=/usr/share/elasticsearch/bin/elasticsearch
Restart=always
LimitNOFILE=65536
Environment="ES_JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64"
[Install]
WantedBy=multi-user.target
启用并启动服务:
sudo systemctl daemon-reload
sudo systemctl enable elasticsearch
sudo systemctl start elasticsearch
检查状态:
sudo systemctl status elasticsearch
7. 验证安装
curl -k https://localhost:9200 -u elastic:your_password
(首次启动时,终端会输出默认密码,或使用 bin/elasticsearch-reset-password -u elastic 重置)
8. 配置客户端连接
生成 HTTP 证书(可选)
sudo /usr/share/elasticsearch/bin/elasticsearch-certutil http
按提示操作,生成 .p12 文件并配置到客户端。
修改 elasticsearch.yml
sudo nano /usr/share/elasticsearch/config/elasticsearch.yml
调整以下参数:
xpack.security.enabled: true
xpack.security.http.ssl.enabled: true
network.host: 0.0.0.0
http.port: 9200
9. 防火墙设置(如需远程访问)
sudo ufw allow 9200/tcp
sudo ufw reload
常见问题
-
启动失败:检查日志
/var/log/elasticsearch/elasticsearch.log。 -
内存不足:降低
Xms和Xmx值。 -
证书问题:使用
bin/elasticsearch-certutil重新生成。
完成!Elasticsearch 8.13.4 现已运行。如需 Kibana 或 Logstash,可参考官方文档继续安装。