Docker部署的ksqlDB Server无法被同版本CLI识别运行状态咨询

• 容器网络访问目标错误：容器化ksqlDB CLI默认的网络栈独立于宿主机，你传入的连接地址http://127.0.0.1:8088指向的是CLI容器自身的环回地址，而非Windows宿主机上运行的ksqlDB Server服务，CLI无法建立有效连接所以无法读取服务版本与状态信息。
• Windows网络策略拦截：Docker容器内部访问宿主机端口的请求被Windows Defender防火墙或本地网络规则拦截，导致CLI请求超时或被拒绝。
• ksqlDB Server配置异常：ksql.advertised.listeners参数配置为非对外可访问的地址，CLI请求元信息时被重定向到不可达地址。

1. 首先修正连接地址测试
   Windows Docker环境下默认提供了域名host.docker.internal指向宿主机，先执行命令验证连通性：

docker run --rm confluentinc/ksqldb-cli:0.20.0 curl http://host.docker.internal:8088/info

如果命令正常返回和浏览器访问一致的服务信息，直接使用该地址启动CLI即可：

docker run --rm confluentinc/ksqldb-cli:0.20.0 ksql http://host.docker.internal:8088

2. 连通性异常时排查网络规则
   如果上述curl命令无法返回结果，先临时关闭Windows Defender防火墙测试，如果关闭后可正常访问，给8088端口、Docker相关进程添加防火墙放行规则即可。

3. 验证ksqlDB配置
   检查ksqlDB Server的启动配置，确认如下参数配置正确：

• ksql.listeners 值为 http://0.0.0.0:8088，允许所有地址访问服务
• ksql.advertised.listeners 值为 http://host.docker.internal:8088，对外广播的地址可被容器正常访问

4. 备用方案：使用host网络模式启动CLI
   如果你的Docker使用WSL2后端，可直接共享宿主机网络栈启动CLI，无需修改连接地址：

docker run --rm --net=host confluentinc/ksqldb-cli:0.20.0 ksql http://127.0.0.1:8088

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