Solr向Zookeeper上报错误主机IP 导致外部工具无法连接Solr Leader

我非常理解你遇到的这个棘手问题——在同一机器用Docker部署Solr和ZooKeeper后，内部访问一切正常，但外部工具依赖ZK的/live_nodes获取Solr Leader地址时，拿到的始终是Docker内部IP或localhost，根本没法跨机器建立连接。结合你已经尝试的操作，我来梳理核心问题和可行的解决步骤：

问题根源 #

Solr向ZooKeeper注册自身节点地址的核心参数是SOLR_HOST，这个值才是最终写入ZK /live_nodes的地址。你之前尝试的-Djetty.host只是控制Jetty服务的绑定IP，和ZK注册的地址并非同一概念；另外，如果ZK中已经残留了旧的节点数据，哪怕你修改了新配置，重启后也可能优先读取旧数据。

具体解决步骤 #

1. 强制指定SOLR_HOST参数（核心操作） #

这个参数是Solr向ZK注册身份的关键，必须确保它被设置为机器的可访问IP（即你说的[SELF-IP]）。你可以通过两种方式配置：

方式一：在Docker Compose的Solr环境变量中直接设置

修改solr1服务的environment部分，添加SOLR_HOST：

solr1:
  image: solr:9.8
  container_name: solr1
  restart: always
  volumes:
    - ./conf/solr/solr.in.sh:/opt/solr/bin/solr.in.sh
  environment:
    ZK_HOST: [SELF-IP]:2181
    SOLR_HOST: [SELF-IP]  # 核心：指定Solr向ZK注册的地址
    SOLR_OPTS: >
      -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
      -Djetty.host=[SELF-IP]
      -Dsolr.host=[SELF-IP]  # JVM层面双重保险，确保参数生效
    SOLR_TIMEZONE: Europe/Berlin
  network_mode: host
  depends_on:
    - zoo1

方式二：在solr.in.sh中配置

如果你习惯用配置文件管理参数，确保./conf/solr/solr.in.sh中添加：

export SOLR_HOST="[SELF-IP]"
export SOLR_JETTY_HOST="[SELF-IP]"  # 同时确保Jetty绑定到正确IP

2. 清理ZooKeeper旧数据（避免残留干扰） #

ZK会持久化Solr的节点注册信息，旧的错误IP记录可能会干扰新配置的生效，需要彻底清理：

1. 先停止ZooKeeper容器：docker stop zoo1
2. 找到ZK的数据存储目录（host模式下默认是/var/lib/zookeeper），清空其中的version-2文件夹：rm -rf /var/lib/zookeeper/version-2
3. 重启ZooKeeper容器：docker start zoo1

3. 修复ZooKeeper的单节点配置隐患 #

你当前的ZK配置缺少ZOO_MY_ID参数，单节点ZK也需要这个参数标识自身身份，否则可能出现注册异常。修改zoo1服务的environment：

zoo1:
  image: zookeeper:3.9.3
  container_name: zoo1
  restart: always
  hostname: zoo1
  environment:
    ZOO_4LW_COMMANDS_WHITELIST: mntr, conf, ruok
    ZOO_MY_ID: 1  # 单节点固定设为1即可
    ZOO_SERVERS: server.1=0.0.0.0:2888:3888;2181  # 确保ZK绑定到所有可用IP
  network_mode: host

4. 验证配置是否生效 #

完成上述修改后，按「先启动ZK，再启动Solr」的顺序重启服务，然后做以下验证：

1. 用ZK客户端连接验证：
   进入ZK容器：docker exec -it zoo1 ./bin/zkCli.sh -server [SELF-IP]:2181
   执行命令查看live_nodes：ls /live_nodes
   正常情况下，返回结果应该是[ [SELF-IP]:8983_solr ]（如果你的Solr端口不是8983，会对应变化）
2. 查看Solr系统属性：
   访问Solr Admin页面：http://[SELF-IP]:8983/solr/admin/info/system
   在页面中搜索solr.host和jetty.host，确认它们的值都是[SELF-IP]

额外注意事项 #

• 确保[SELF-IP]是机器的局域网/公网可访问IP，绝对不能用127.0.0.1或Docker内部IP（比如172.17.0.1）
• 检查机器防火墙，开放2181（ZK端口）、8983（Solr端口）、5005（调试端口）的入站规则，确保外部工具能正常访问
• 重启服务时，一定要等ZK完全就绪后再启动Solr，避免Solr启动时连接ZK失败导致注册异常

内容来源于stack exchange