Ubuntu 系统上安装 Elasticsearch

以下是在 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

常见问题

  1. 启动失败:检查日志 /var/log/elasticsearch/elasticsearch.log
  2. 内存不足:降低 XmsXmx 值。
  3. 证书问题:使用 bin/elasticsearch-certutil 重新生成。

完成!Elasticsearch 8.13.4 现已运行。如需 Kibana 或 Logstash,可参考官方文档继续安装。

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容