Windows本地搭建ES详细教程

本文详细介绍了在 Windows 系统上零基础本地搭建 Elasticsearch 开发环境的完整流程，涵盖 JDK 17（推荐官方捆绑版）的安装与环境变量配置、Elasticsearch ZIP 包解压与核心参数修改（如绑定 localhost 和禁用默认安全机制）、PowerShell 启动服务的关键操作，以及防火墙端口放行等实用技巧，全程聚焦开发测试场景，步骤清晰、避坑明确，助你快速启动一个开箱即用的本地搜索引擎服务。

如果您希望在 Windows 系统上安装 Elasticsearch 并搭建本地搜索引擎服务用于开发与测试，则需满足 Java 运行环境依赖、正确配置系统变量、解压并启动服务。以下是具体操作步骤：

一、确认并安装 Java 17 或兼容版本

Elasticsearch 8.x 要求运行在 Java 17 或更高版本上，且官方推荐使用 Elasticsearch 自带的 JDK。若未安装或版本不匹配，将导致启动失败。

1、访问 https://www.elastic.co/downloads/past-releases/jdk-17-0-2 下载 Elasticsearch 官方捆绑的 JDK 17.0.2 Windows 版本。

2、解压下载的 zip 文件至路径如 C:\elasticsearch\jdk，确保路径不含空格与中文。

3、右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中新建变量 JAVA_HOME，值设为 C:\elasticsearch\jdk。

4、编辑系统变量 Path，新增条目 %JAVA_HOME%\bin。

5、打开新命令提示符，执行 java -version，确认输出包含 17.0.2 及 “Elastic” 字样。

二、下载并解压 Elasticsearch 主程序

Elasticsearch 提供免安装的 ZIP 发行包，无需执行安装向导，直接解压即可获得完整运行环境。

1、访问 https://www.elastic.co/downloads/elasticsearch，选择对应最新稳定版的 Windows ZIP 包（如 elasticsearch-8.15.0-windows-x86_64.zip）。

2、将 ZIP 文件解压至固定目录，例如 C:\elasticsearch\elasticsearch-8.15.0，路径不得含空格与中文。

3、进入该目录下的 config 子目录，用记事本打开 elasticsearch.yml。

4、取消注释并修改以下两行：
  network.host: localhost
  http.port: 9200

三、禁用安全功能以简化本地开发

默认启用的安全特性（如 TLS、用户认证）会增加本地调试复杂度；开发测试阶段可临时关闭，避免反复输入凭证或配置证书。

1、在 config\elasticsearch.yml 文件末尾新增以下配置：

xpack.security.enabled: false

2、继续添加：

xpack.security.http.ssl.enabled: false

3、保存文件，确保无 BOM 编码，建议使用 VS Code 或 Notepad++ 以 UTF-8 无 BOM 格式保存。

四、通过 PowerShell 启动 Elasticsearch 服务

Windows 下必须使用 PowerShell（非 CMD）执行启动脚本，因其支持脚本签名策略及更完整的权限控制逻辑。

1、以管理员身份运行 PowerShell。

2、执行命令切换路径：Set-Location C:\elasticsearch\elasticsearch-8.15.0。

3、执行启动命令：.\bin\elasticsearch.bat。

4、等待日志中出现 started 字样，且无 ERROR 红字报错。

5、另开一个 PowerShell 窗口，执行：Invoke-RestMethod -Uri http://localhost:9200/，返回 JSON 响应即表示服务已就绪。

五、配置 Windows 防火墙放行端口

若其他设备需访问本机 ES（如 WSL 或局域网测试），需显式允许 9200 端口入站通信，否则请求将被静默丢弃。

1、以管理员身份运行 PowerShell。

2、执行命令创建入站规则：New-NetFirewallRule -DisplayName "Elasticsearch HTTP" -Direction Inbound -Protocol TCP -LocalPort 9200 -Action Allow。

3、验证规则是否生效：Get-NetFirewallRule -DisplayName "Elasticsearch HTTP" | Select-Object Enabled,Profile，确认输出中 Enabled 为 True。

4、如需同时开放传输端口（默认 9300），重复执行上述命令并将 LocalPort 改为 9300。

好了，本文到此结束，带大家了解了《Windows本地搭建ES详细教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！