Docker部署本地Elasticsearch后Kibana卡在「Completing Setup」

• 先确认Elasticsearch核心状态
  直接检查ES集群健康度，在宿主机执行：

  curl -X GET "http://localhost:9200/_cluster/health?pretty"
  

  重点看status字段，必须是green才代表ES完全正常。如果是yellow，可能是分片未分配；如果是red，说明ES核心服务异常，先解决ES的问题再看Kibana。

• 验证Kibana与ES的网络连通性
  进入Kibana容器内部，测试和ES的网络是否通畅：

  # 替换<kibana-container-id>和<es-container-name>为实际值
  docker exec -it <kibana-container-id> ping <es-container-name>
  docker exec -it <kibana-container-id> telnet <es-container-name> 9200
  

  如果ping不通或者telnet失败，说明Docker网络配置有问题，比如不在同一个网络、容器名解析失败，需要调整Docker网络设置（比如将两个容器加入同一个自定义网络）。

• 检查Kibana专属索引与权限
  Kibana需要在ES中创建.kibana开头的专属索引，且要有足够权限操作：

  1. 如果ES开启了身份验证，确认Kibana配置中的elasticsearch.username和elasticsearch.password正确，且该用户拥有kibana_system角色权限。
  2. 检查Kibana索引状态：

     # 若开启认证，添加-u <用户名>:<密码>参数
     curl "http://localhost:9200/_cat/indices/.kibana*?v"
     

     如果索引不存在，说明Kibana无法创建索引；如果索引状态异常（比如red），尝试删除后让Kibana重建：

     curl -X DELETE "http://localhost:9200/.kibana*"
     

• 调整Kibana资源分配
  Kibana基于Node.js运行，内存不足会导致启动卡住。在启动容器时增加内存配置：

  # docker run方式添加环境变量
  docker run -d -e "NODE_OPTIONS=--max-old-space-size=2048" ... 其他Kibana启动参数
  
  # docker-compose方式添加到environment
  services:
    kibana:
      ...
      environment:
        NODE_OPTIONS: "--max-old-space-size=2048"
  

• 开启Kibana debug日志排查细节
  修改Kibana配置（通过环境变量或挂载配置文件），将日志级别设为debug：

  # docker run添加环境变量
  -e "logging.root.level=debug"
  
  # docker-compose添加
  environment:
    logging.root.level: debug
  

  重启容器后，查看日志：

  docker logs -f <kibana-container-id>
  

  重点关注ES通信、索引创建相关的日志，定位具体卡住的环节。

• 清除浏览器缓存或用无痕模式访问
  前端缓存可能导致页面显示异常，清除浏览器缓存后重新访问，或直接用无痕模式打开Kibana页面，排除前端缓存影响。

内容的提问来源于stack exchange，提问作者ebonybubbles