如何修复Docker环境下Kafka的‘无法连接到节点-1’问题

• Docker容器的网络隔离特性：每个容器都有独立的网络命名空间，AKHQ容器里的localhost指向的是容器自身，而非宿主机。当你把AKHQ的bootstrap.servers设为localhost:9092时，它会尝试连接自己容器内的9092端口，而Kafka运行在另一个容器里，自然连不上。
• Kafka的KAFKA_ADVERTISED_LISTENERS设为localhost:9092时，Kafka会告诉客户端（这里是AKHQ）用这个地址来连接，但AKHQ在容器内无法通过这个地址访问到Kafka容器。

办法1：保持用容器服务名通信（推荐） #

继续使用kafka:9092作为bootstrap.servers和KAFKA_ADVERTISED_LISTENERS的配置值。Docker Compose会自动为同一服务栈的容器创建内部DNS解析，kafka这个服务名可以直接映射到Kafka容器的IP，容器间通信顺畅。

办法2：配置Kafka多监听地址，兼顾容器内部和宿主机访问 #

如果需要同时支持容器内部通信和宿主机外部访问，给Kafka配置多个监听地址：

1. 修改Kafka的环境变量：

   KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:9092,PLAINTEXT_HOST://0.0.0.0:9093
   KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092,PLAINTEXT_HOST://localhost:9093
   KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT,PLAINTEXT_HOST:PLAINTEXT
   

2. AKHQ的bootstrap.servers保持设为kafka:9092（容器内部通信）；如果是宿主机上的外部客户端要连接Kafka，就用localhost:9093。

办法3：使用Docker主机网络模式（不推荐） #

把Kafka和AKHQ容器都配置为使用主机网络，这样容器内的localhost就和宿主机的localhost一致：
在docker-compose.yml里给两个服务加上network_mode: host，然后配置bootstrap.servers和KAFKA_ADVERTISED_LISTENERS为localhost:9092。但这种方式会破坏容器的网络隔离性，容易引发端口冲突，仅适合简单测试场景。

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