Windows 环境下使用 Easysearch #

目前，有多种方案可以在 Windows 下体验 Easysearch。

前置要求 #

Windows 10 / Windows Server 2016 或更高版本
至少 4 GB 可用内存
JDK 11+（推荐 JDK 17+，2.0.3 及以上版本要求 JDK 21+）。Bundle 包已内置 JDK，无需单独安装。

方案一：Docker 安装（推荐） #

如果您的 Windows 环境上有 Docker Desktop，可以用最简单的方式启动：

docker run -d --name easysearch `
  -p 9200:9200 `
  -e "EASYSEARCH_INITIAL_ADMIN_PASSWORD=MyTest@2024" `
  -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" `
  infinilabs/easysearch:latest

详细 Docker 配置请参考 Docker 环境下使用 Easysearch。

方案二：手工安装（无 HTTPS） #

由于 Windows 环境下默认没有 OpenSSL，生成证书不太方便。如果仅用于开发测试，可以先关闭安全模块快速体验。生产环境请务必启用安全功能（参见方案三）。

手工下载 Easysearch，解压到目标目录（如 D:\easysearch）。
手工下载 JDK，解压到 Easysearch 安装目录下，并将目录名称重命名为 jdk。

也可以下载 Bundle 包（内置 JDK），省去手动配置 JDK 的步骤。Bundle 包下载地址。

用记事本打开 config\easysearch.yml，修改配置：

# 关闭安全模块（仅开发测试，生产环境不建议）
security.enabled: false

双击运行 bin\easysearch.bat 或在命令行执行：

bin\easysearch.bat

验证安装：

# 在 PowerShell 中
Invoke-RestMethod -Uri "http://localhost:9200"

# 或在浏览器中打开 http://localhost:9200

方案三：通过 Git Bash 安装（支持 HTTPS） #

安装 Git for Windows，使用其内置的 Bash 环境来执行初始化脚本，可正常生成证书并启用 HTTPS。

注意：以下操作在 Git Bash 终端中执行。

通过在线脚本安装 Easysearch

curl -sSL http://get.infini.cloud | bash -s -- -p easysearch -d /d/data/easysearch

下载并配置 JDK

# 下载 JDK
curl -# https://cdn.azul.com/zulu/bin/zulu17.54.21-ca-jre17.0.13-win_x64.zip -o /d/opt/jdk.zip

# 解压并重命名
cd /d/data/easysearch && unzip -q /d/opt/jdk.zip
mv zulu* jdk

# 设置环境变量
export JAVA_HOME=/d/data/easysearch/jdk

初始化证书、密码及插件

bin/initialize.sh

初始化过程中会生成随机密码，只会在终端显示一次，请妥善保存。

运行 Easysearch

bin\easysearch.bat

验证安装

# 在 Git Bash 中（使用初始化时输出的密码）
curl -ku admin:YOUR_PASSWORD https://localhost:9200

常见问题 #

端口被占用 #

如果 9200 端口被占用，可修改 config\easysearch.yml：

http.port: 9201

忘记 admin 密码 #

在 Git Bash 中运行：

cd /d/data/easysearch
bin/reset_admin_password.sh

内存不足 #

编辑 config\jvm.options，调小堆内存：

-Xms512m
-Xmx512m