
如果您希望在 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。

评论(0)