josuarcaya/kafdrop

Kafdrop Docker镜像文档

镜像概述

Kafdrop是一款用于监控Apache Kafka集群的Web UI工具。它能够直观展示Kafka集群的关键信息，包括brokers（代理节点）、topics（主题）、partitions（分区）等，并支持查看消息内容。该工具基于Spring Boot开发，具有轻量级特性，部署和配置过程简单，无需复杂的前期准备。

核心功能与特性

• 集群监控：实时展示Kafka集群中的brokers状态、topics列表及详细信息
• 分区管理：查看各topic的分区分布、副本状态及偏移量信息
• 消息查看：支持浏览指定topic和分区中的消息内容
• 轻量部署：基于Spring Boot框架，资源占用低，启动迅速
• 简单配置：仅需少量必要配置即可连接Kafka集群

使用场景

• 开发人员调试Kafka消息流
• 运维人员监控Kafka集群运行状态
• 测试环境中验证Kafka主题和消息传递
• 学习Kafka集群结构和消息流转过程

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动Kafdrop容器：

bash
docker run -d -p 9000:9000 -e ZOOKEEPER_CONNECT=<host:port,host:port> josuarcaya/kafdrop

参数说明：

• -p 9000:9000：将容器内9000端口映射到主机9000端口，用于访问Web UI
• -e ZOOKEEPER_CONNECT=<host:port,host:port>：指定ZooKeeper连接地址（必填），格式为主机:端口，多个地址用逗号分隔

Docker Compose部署

以下是包含Kafka、ZooKeeper和Kafdrop的完整docker-compose配置示例：

yaml
version: '2'
services:
  zookeeper:
    image: wurstmeister/zookeeper:3.4.6
    ports:
      - "2181:2181"  # ZooKeeper默认端口
  
  kafka:
    image: wurstmeister/kafka:2.11-2.0.0
    ports:
      - "9092:9092"  # Kafka默认端口
    environment:
      KAFKA_ADVERTISED_HOST_NAME: localhost  # 广告主机名
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181  # 连接ZooKeeper服务
      KAFKA_CREATE_TOPICS: "test:1:1"  # 自动创建测试主题（名称:分区数:副本数）
  
  kafdrop:
    image: josuarcaya/kafdrop:2.0.6
    ports:
      - "9000:9000"  # Kafdrop Web UI端口
    environment:
      - "ZOOKEEPER_CONNECT=zookeeper:2181"  # 连接同一网络中的ZooKeeper服务

启动命令：

bash
docker-compose up -d

访问UI

部署完成后，通过浏览器访问 http://<主机IP>:9000 即可打开Kafdrop Web界面，查看Kafka集群状态和消息数据。