Windows 系统 Elasticsearch 安装配置指南

⚠️ 生产环境务必开启安全配置（用户名/密码）

四、启动 Elasticsearch

方式 1：命令行启动（推荐）

1. 以 管理员身份 打开命令提示符（CMD）或 PowerShell

进入 Elasticsearch 的 bin 目录：

cd C:\Elasticsearch\elasticsearch-8.x.x\bin

启动服务：

# 前台运行（显示日志）
elasticsearch.bat
# 或后台运行
elasticsearch-service.bat install
# 启动服务
elasticsearch-service.bat start

方式 2：作为 Windows 服务安装

# 安装服务
elasticsearch-service.bat install
# 启动服务
elasticsearch-service.bat start
# 停止服务
elasticsearch-service.bat stop
# 卸载服务
elasticsearch-service.bat remove

服务管理：

• 也可以在 services.msc 中搜索 'Elasticsearch' 服务进行管理

五、验证安装

1. 检查服务状态

访问浏览器或使用 curl：

http://localhost:9200/

成功响应示例：

{
  "name":"node-1",
  "cluster_name":"my-elasticsearch",
  "version":{
    "number":"8.13.4"
  }
}

2. 查看集群健康状态

http://localhost:9200/_cluster/health

六、常见问题与解决

问题 1：Java 版本不兼容

• 症状：启动时提示 Java 版本错误
• 解决：
  1. 安装 JDK 17+ 并设置 JAVA_HOME 环境变量
  2. 或使用 Elasticsearch 自带的 JDK（在 jdk 目录中）

问题 2：端口冲突（9200/9300）

• 症状：启动失败，端口被占用
• 解决：
  1. 修改 elasticsearch.yml 中的端口号
  2. 或关闭占用端口的程序：

     netstat -ano | findstr :9200
     taskkill /PID <进程 ID> /F
     

问题 3：内存不足

• 症状：启动时崩溃，日志显示内存错误
• 解决：
  1. 32 位系统需使用 Elasticsearch 6.x 或更低版本
  2. 编辑 config/jvm.options：

     # 初始堆大小（根据机器内存调整）
     -Xms1g
     # 最大堆大小（建议不超过物理内存的 50%）
     -Xmx1g
     

问题 4：文件权限不足

• 症状：无法创建数据/日志目录
• 解决：
  1. 以管理员身份运行命令行
  2. 或修改 elasticsearch.yml 中的路径到有权限的目录

问题 5：无法远程访问

• 症状：localhost 可访问，但 IP 无法访问
• 解决：
  1. 确认 elasticsearch.yml 中 network.host: 0.0.0.0
  2. 确保防火墙允许端口 9200：

     netsh advfirewall firewall add rule name="Elasticsearch" dir=in action=allow protocol=TCP localport=9200
     

七、安装 Kibana（可选可视化工具）

步骤：

1. 下载 Kibana Windows 版
2. 运行 bin\kibana.bat
3. 访问 http://localhost:5601

解压并编辑 kibana.yml：

server.port: 5601
server.host:"0.0.0.0"
elasticsearch.hosts:["http://localhost:9200"]

八、生产环境建议

安全配置（必须）

启用内置安全功能：

# 启动时自动生成密码
elasticsearch-keystore add bootstrap.password

手动配置 elasticsearch.yml：

xpack.security.enabled:true
xpack.security.transport.ssl.enabled:true

性能优化

1. 调整 JVM 堆大小（jvm.options）
2. 配置合适的垃圾回收器
3. 禁用交换文件：

   bootstrap.memory_lock:true
   

九、常用命令速查

# 启动（前台）
elasticsearch.bat
# 服务管理
elasticsearch-service.bat install/start/stop/remove
# 检查节点
curl http://localhost:9200/_cat/nodes?v
# 创建索引
curl -X PUT "localhost:9200/my_index"
# 删除索引
curl -X DELETE "localhost:9200/my_index"

总结