桥接网络下Kafka UI无法连接Bitnami Kafka Broker求助

核心问题 #

bridge网络下容器间通过内部域名/IP通信，Kafka的通告监听器配置必须匹配容器内部可访问的地址，否则Kafka UI无法正确发现Broker。

修正后的podman-compose配置 #

version: '3.8'

services:
  kafka1:
    image: bitnami/kafka:latest
    container_name: kafka1
    networks:
      - kafka-net
    environment:
      - KAFKA_ENABLE_KRAFT=yes
      - KAFKA_CFG_PROCESS_ROLES=broker,controller
      - KAFKA_CFG_CONTROLLER_LISTENER_NAMES=CONTROLLER
      # 定义三类监听器：内部通信、控制器通信、外部访问
      - KAFKA_CFG_LISTENERS=PLAINTEXT://:9092,CONTROLLER://:9093,EXTERNAL://:9094
      # 关键：通告地址要对应网络场景，容器内部用容器名，宿主机用localhost
      - KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://kafka1:9092,EXTERNAL://localhost:9094
      - KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP=PLAINTEXT:PLAINTEXT,CONTROLLER:PLAINTEXT,EXTERNAL:PLAINTEXT
      - KAFKA_CFG_CONTROLLER_QUORUM_VOTERS=1@kafka1:9093
      # 自定义集群ID，可自行修改
      - KAFKA_KRAFT_CLUSTER_ID=abcdefghijklmnopqrstuv
      - ALLOW_PLAINTEXT_LISTENER=yes
    volumes:
      - kafka1-data:/bitnami/kafka

  kafka-ui:
    image: provectuslabs/kafka-ui:latest
    container_name: kafka-ui
    networks:
      - kafka-net
    ports:
      - "8080:8080"
    environment:
      - KAFKA_CLUSTERS_0_NAME=local-kafka
      # 必须用Kafka容器的内部地址：容器名+内部端口
      - KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka1:9092
      - KAFKA_CLUSTERS_0_KRAFT=true

volumes:
  kafka1-data:

networks:
  kafka-net:
    driver: bridge

关键配置解析 #

• KAFKA_CFG_LISTENERS：声明Kafka监听的端口，PLAINTEXT://:9092供容器内部服务（比如Kafka UI）访问，CONTROLLER://:9093是KRaft控制器的通信端口，EXTERNAL://:9094用于宿主机外部客户端连接。
• KAFKA_CFG_ADVERTISED_LISTENERS：这是解决问题的核心！Kafka会把这个地址告诉客户端，所以容器内的Kafka UI必须拿到容器内部可访问的地址kafka1:9092，而不是宿主机的localhost。
• Kafka UI的BOOTSTRAPSERVERS：一定要配置成Kafka容器在bridge网络中的地址，不能写localhost——因为在UI容器里，localhost指的是它自己，不是Kafka容器。

排查要点 #

如果还是连接失败：

• 检查Kafka容器日志，确认监听器正常绑定，没有Address already in use或类似错误。
• 查看Kafka UI日志，若出现Failed to connect to bootstrap servers，说明地址配置错误，确保用的是容器名+9092端口。
• 确认两个容器都加入了同一个bridge网络（上面配置中都在kafka-net下）。

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