如何将Python Elasticsearch客户端连接至Bitnami ELK虚拟机

第一步：验证Elasticsearch服务本身状态与端口监听 #

• 登录ELK虚拟机，执行ss -tulnp | grep 9200，确认ES进程是否监听在0.0.0.0而非127.0.0.1，如果只监听本地环回地址，外部设备无法访问
• 虚拟机本地执行curl http://<虚拟机IP>:9200，验证ES是否能正常返回节点信息，排除服务本身启动异常的问题
• 检查ES配置文件elasticsearch.yml，确认network.host配置为0.0.0.0或者你本地宿主机所在的网段，discovery.type是否设置为single-node（单节点场景下）

第二步：验证网络连通性与防火墙配置 #

• 宿主机执行telnet <虚拟机IP> 9200或者nc -zv <虚拟机IP> 9200，确认9200端口是否可达，ping通只代表ICMP协议可达，不代表TCP 9200端口放通
• 登录ELK虚拟机，检查系统防火墙规则：执行iptables -L -n或者ufw status，确认是否放通了9200端口的入站请求，Bitnami镜像默认可能会有预设的防火墙规则限制外部访问
• 检查VMWare的网络配置：确认虚拟机的网络模式是桥接/NAT而非仅主机模式，如果是NAT模式需要确认是否做了9200端口的端口转发

第三步：验证Elasticsearch访问权限配置 #

• 检查ES是否开启了身份认证，Bitnami ELK默认是开启基础认证的，连接时需要携带用户名密码，默认用户名为elastic，密码可以在虚拟机中执行cat /home/bitnami/bitnami_credentials查看
• 检查ES的elasticsearch.yml中是否配置了xpack.security.enabled: true，如果开启了安全模块，Python客户端初始化时必须传入auth参数，示例代码如下：

from elasticsearch import Elasticsearch
es = Elasticsearch("http://<虚拟机IP>:9200", basic_auth=("elastic", "你的ES密码"))

• 检查是否配置了IP白名单或者CORS规则，如果有跨域配置要求，确认http.cors.allow-origin包含了宿主机的地址

第四步：验证Python客户端配置 #

• 确认Python客户端的大版本和ES服务的大版本一致，比如ES是7.x版本，客户端也要安装7.x版本，版本跨度过大可能会出现兼容性连接失败的问题
• 开启Python客户端的debug日志，查看具体的报错信息：

import logging
logging.basicConfig(level=logging.DEBUG)

• 检查是否配置了错误的协议，比如ES没有开启SSL，但是客户端用了https前缀访问，导致握手失败

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