安装指南 #

本章介绍如何安装和运行 Easysearch。无论是开发测试还是生产部署，都可以在这里找到适合的安装方式。

快速开始 #

最快的方式是使用一键安装脚本，在 Linux 上几分钟内完成安装：

# 1. 安装 Easysearch（默认安装到 /data/easysearch）
curl -sSL http://get.infini.cloud | bash -s -- -p easysearch

# 2. 初始化（生成证书和 admin 密码）
cd /data/easysearch && bin/initialize.sh -s

# 3. 调整目录权限
chown -R easysearch:easysearch /data/easysearch

# 4. 以 easysearch 用户启动
su easysearch -c "/data/easysearch/bin/easysearch -d"

# 5. 验证（使用初始化时终端输出的密码）
curl -ku admin:YOUR_PASSWORD https://localhost:9200

安全提示：初始化完成后 admin 密码将直接输出在终端中，只显示一次，请务必妥善保存。也可以通过环境变量 EASYSEARCH_INITIAL_ADMIN_PASSWORD 预先指定自定义密码（需要 1.8.2 及以后版本）。

# 使用 root 用户操作
whoami && cat /etc/redhat-release && uptime
# 安装 JDK
yum -y install java-11
# 创建 easysearch 用户
groupadd -g 602 easysearch
useradd -u 602 -g easysearch -m -d /home/easysearch -c 'easysearch' -s /bin/bash easysearch
# 安装 Easysearch
curl -sSL http://get.infini.cloud | bash -s -- -p easysearch
# 配置 Easysearch JDK
ln -s /usr/lib/jvm/java-11-openjdk-11.0.20.0.8-1.el7_9.x86_64 /data/easysearch/jdk
sed -i 's/1g/512m/g' /data/easysearch/config/jvm.options
# 初始化
cd /data/easysearch && bin/initialize.sh -s
# 调整目录权限
chown -R easysearch:easysearch /data/easysearch
# 运行 Easysearch
su easysearch -c "/data/easysearch/bin/easysearch -d"
# 检查 Easysearch，密码是随机的在安装过程中有展示
curl -ku admin:8bf1565cf6ff084d823e https://localhost:9200

前置要求 #

操作系统 #

Easysearch 支持 Linux（x86_64 / ARM64 / LoongArch）、macOS 和 Windows。生产环境推荐 Linux。

JDK 要求 #

推荐使用 Bundle 包（内置 JDK），免去手动配置 JDK 的步骤。Bundle 包 下载地址。

如需使用自行安装的 JDK，有两种方式：

1. 将 JAVA_HOME 环境变量指向 JDK 安装路径
2. 将 JDK 软链接到 Easysearch 安装目录下并命名为 jdk

JVM 堆内存 #

通过启动参数或配置文件设置 JVM 堆内存：

# 方式一：启动参数
ES_JAVA_OPTS="-Xms4g -Xmx4g" bin/easysearch

# 方式二：编辑 config/jvm.options
-Xms4g
-Xmx4g

-Xms 和 -Xmx 建议设置为相同值，不超过物理内存的 50%，且不超过 31 GB。

系统调优 #

安装前请完成操作系统参数调优，否则 Easysearch 可能启动失败或性能不佳：

# 虚拟内存映射（必须）
sysctl -w vm.max_map_count=262144

# 文件描述符
ulimit -n 65535

完整调优参数请参考 系统调优。

选择安装方式 #

根据您的使用场景选择合适的安装方式：

按场景选择 #

按平台选择 #

操作系统

容器与编排

云平台

信创平台

Easysearch 全面支持国产芯片与操作系统：

更多信创适配信息请参考博客： Arm 架构、 LoongArch 架构。

其他

• 一键安装 Console 和 Easysearch — 同时部署 INFINI Console 管理界面
• IPv6 支持 — 配置 IPv6 网络环境

初始化与安全 #

Easysearch 默认启用安全功能，首次安装后需执行初始化：

cd /data/easysearch
bin/initialize.sh -s

初始化脚本会：

1. 生成 TLS 证书（节点间通信和 HTTPS）
2. 生成 admin 用户的随机密码
3. 安装默认插件

⚠️ 重要：

• admin 密码仅在终端输出中显示一次，请务必记录
• 初始化脚本会覆盖已有的证书和密码，请勿对已运行的集群重复执行
• 如忘记密码，可使用 bin/reset_admin_password.sh 重置，或参考 密码重置指南

验证安装 #

# 访问 REST API（将 YOUR_PASSWORD 替换为初始化时输出的密码）
curl -ku admin:YOUR_PASSWORD https://localhost:9200

预期输出：

{
  "name" : "node-1",
  "cluster_name" : "easysearch",
  "cluster_uuid" : "...",
  "version" : {
    "distribution" : "easysearch",
    "number" : "x.y.z",
    "distributor" : "INFINI Labs",
    ...
  },
  "tagline" : "You Know, For Easy Search!"
}

也可以在浏览器中打开 https://localhost:9200/ 验证（需要接受自签名证书提示）。

推荐使用 INFINI Console 进行集群管理，功能更加强大和方便。

插件安装 #

联网环境下，初始化脚本会自动安装常用插件。内网环境需要手动安装。

最新版本插件 下载地址。

# 切换到 easysearch 用户
su - easysearch

# 离线安装插件（以 analysis-ik 为例）
bin/easysearch-plugin install file:///tmp/analysis-ik-1.2.0.zip

# 查看已安装的插件
bin/easysearch-plugin list

常用插件列表：

安装插件后需重启 Easysearch 才能生效。

客户端兼容 #

Easysearch 兼容 Elasticsearch 7.10.x 协议。连接时请注意：

如果客户端版本校验失败，请在 config/easysearch.yml 中启用 API 兼容模式：

elasticsearch.api_compatibility: true