安装Docker

确保你的电脑（Windows/Mac/Linux）上已安装并运行Docker Desktop或Docker Engine。这是运行Kafka-UI的前提。

可访问Docker官网下载安装包。安装后，在终端输入 `docker --version` 验证是否成功。

一键启动Demo环境

按照README的“Quick start (Demo run)”部分，复制提供的Docker命令到终端执行。该命令会同时启动一个Kafka-UI容器和一个内置的Kafka集群用于演示。

命令类似 `docker run -p 8080:8080 ...`。执行后，访问 http://localhost:8080 即可看到UI界面。这是最快体验项目的方式。

浏览界面与核心模块

在浏览器中打开Kafka-UI，花几分钟熟悉左侧导航栏：Clusters（集群）、Topics（主题）、Consumers（消费者）、Schema Registry（模式注册表）等主要功能区域。

重点关注“Clusters”页面，这里会显示你刚启动的演示集群状态。

准备你的Kafka集群连接信息

你需要知道目标Kafka集群的Bootstrap Server地址（例如：`localhost:9092`）。确保你的网络能够访问该集群。

如果你本地没有Kafka，可以先用Docker快速启动一个单节点Kafka进行练习。

通过UI向导添加集群

在Kafka-UI界面中，找到添加集群的按钮或向导（通常在Clusters页面）。按照提示，输入集群名称和Bootstrap Server地址，完成添加。

这是最直观的方式。如果向导未自动弹出，检查页面右上角或设置菜单。

通过配置文件持久化连接（可选但推荐）

学习README中“Persistent installation”和“Configuration file explanation”部分。创建一个配置文件（如`application.yml`），在其中定义你的集群连接信息，然后使用该配置文件重新启动Kafka-UI容器。

这样做的好处是重启容器后配置不会丢失。参考官方文档中的Docker Compose例子是个好起点。

主题（Topics）管理

1. 在Topics页面，查看现有主题列表、分区详情和配置。 2. 尝试使用“Create Topic”功能，创建一个新主题，并设置分区数、副本因子等参数。 3. 点击进入一个主题，查看其详细信息、消息浏览和配置。

注意“Configuration Wizard”功能，它可以帮助你动态调整主题配置。

消息（Messages）浏览与生产

1. 进入一个主题的“Messages”标签页。 2. 尝试浏览现有消息，并切换消息格式（如JSON、Plain text）进行查看。 3. 使用“Produce Message”功能，向该主题手动发送几条测试消息。

可以尝试使用“Live mode”实时查看消息流入，并体验CEL过滤器进行消息筛选。

监控消费者组（Consumer Groups）

1. 切换到Consumers页面，查看当前活跃的消费者组列表。 2. 点击一个消费者组，查看其详情，包括消费滞后（Lag）情况、每个分区的偏移量（Offset）等关键指标。

“Lag”图表是监控消费是否延迟的重要工具，运维时需重点关注。

探索Broker与集群仪表盘

回到Clusters页面，点击进入集群详情。查看Brokers列表的状态、控制器（Controller）信息，以及仪表盘上的各种实时监控指标。

仪表盘帮助你快速掌握集群的整体健康状态。