5分钟快速启动 Kafka UI

通过 Docker 快速启动 Kafka UI,在浏览器中立即查看和管理你的 Kafka 集群

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Docker >= 20.10 必需

所需工具

Docker

运行 Kafka UI 容器

必需

操作步骤

1

启动 Docker 容器

使用 Docker 运行 Kafka UI 的演示版本,这是最快的方式

运行 Kafka UI 容器,映射端口 8080
docker run -p 8080:8080 -e KAFKA_CLUSTERS_0_NAME=local -e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=localhost:9092 provectuslabs/kafka-ui:latest

预期结果:容器启动日志,显示 Spring Boot 应用启动信息

如果本地没有 Kafka 集群,可以使用 localhost:9092 作为占位符,后续在 UI 中配置实际集群

2

访问 Web 界面

在浏览器中打开 Kafka UI

无需命令,直接在浏览器中输入地址
打开浏览器访问 http://localhost:8080

预期结果:看到 Kafka UI 的登录界面或仪表盘

默认情况下,演示版本不需要登录。如果看到登录界面,直接点击登录即可

验证成功运行

确认 Kafka UI 已正常启动并可访问

Docker 容器运行状态正常(使用 docker ps 查看)
浏览器中能正常显示 Kafka UI 界面
界面中能看到集群管理页面

快速提示

配置

要连接真实的 Kafka 集群,在 UI 的集群配置向导中修改 bootstrap servers 地址

配置

使用 docker-compose 可以更方便地管理容器和配置,项目提供了示例文件

调试

健康检查端点:http://localhost:8080/actuator/health

常见问题

1

端口 8080 被占用

修改命令中的端口映射,如 -p 8081:8080,然后访问 http://localhost:8081

2

Docker 容器启动后立即退出

检查 Docker 日志:docker logs <container_id>,通常是因为缺少必要的环境变量配置

3

无法访问 localhost:8080

确认 Docker 正在运行,且容器状态正常。在 Windows/macOS 上,可能需要使用 docker-machine ip 或 localhost

下一步

配置真实 Kafka 集群

在 UI 中添加你的实际 Kafka 集群连接信息

查看官方文档

了解高级配置选项和功能

尝试持久化安装

使用 docker-compose 或 Helm chart 进行生产环境部署

助手