luode0320/kafka-ui

Kafka及Kafka-UI Docker镜像文档

镜像概述

本镜像包含两个组件：luode0320/kafka（Kafka消息队列服务）和luode0320/kafka-ui（Kafka网页端可视化管理工具）。适用于快速部署Kafka服务及通过Web界面进行集群管理，支持Kraft模式（无需ZooKeeper），提供数据持久化和灵活的配置选项。

核心功能与特性

• Kafka服务：基于Kraft模式运行，集成控制器与代理角色，支持数据持久化和集群配置
• 可视化管理：通过Kafka-UI提供Web界面，支持主题管理、消息查看、集群监控等操作
• 灵活配置：通过环境变量自定义节点ID、监听器、日志保留策略等核心参数
• 数据持久化：支持挂载本地目录存储Kafka数据，确保服务重启后数据不丢失

使用场景

• 开发环境快速搭建Kafka服务进行功能测试
• 测试环境验证Kafka消息传递机制
• 小型生产环境部署轻量级Kafka集群并通过UI进行管理

使用方法

1. 拉取镜像

sh
docker pull luode0320/kafka:latest
docker pull luode0320/kafka-ui:latest

2. 创建工作目录

sh
mkdir -p /usr/local/src/kafka
cd /usr/local/src/kafka

3. 首次启动Kafka（初始化隐藏数据文件）

由于镜像需初始化必要的隐藏数据文件，需先临时启动容器：

sh
docker run -d \
  --restart=always \
  --name kafka \
  -e KAFKA_CFG_NODE_ID=1 \
  -e KAFKA_CFG_PROCESS_ROLES=controller,broker \
  -e KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://192.168.1.16:9092 \
  -e KAFKA_CFG_CONTROLLER_LISTENER_NAMES=CONTROLLER \
  -e KAFKA_CFG_LISTENERS=PLAINTEXT://0.0.0.0:9092,CONTROLLER://0.0.0.0:9093 \
  -e KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP=CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT \
  -e KAFKA_CFG_CONTROLLER_QUORUM_VOTERS=1@0.0.0.0:9093 \
  -e KAFKA_KRAFT_CLUSTER_ID=abcdefghijklmnopqrstuv \
  -e KAFKA_CFG_LOG_RETENTION_BYTES=524288000 \
  -e KAFKA_LOG_DIRS=/bitnami/kafka/data \
  -p 9092:9092 \
  -p 9093:9093 \
  luode0320/kafka:latest

4. 拷贝基础数据文件

从临时容器中拷贝初始化数据（包含隐藏文件）：

sh
docker cp kafka:/bitnami/kafka/data /usr/local/src/kafka/

5. 删除临时容器

sh
docker rm -f kafka

6. 正式启动Kafka服务

挂载本地数据目录启动Kafka：

sh
docker run -d \
  --restart=always \
  --name kafka \
  -e KAFKA_CFG_NODE_ID=1 \
  -e KAFKA_CFG_PROCESS_ROLES=controller,broker \
  -e KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://192.168.1.16:9092 \
  -e KAFKA_CFG_CONTROLLER_LISTENER_NAMES=CONTROLLER \
  -e KAFKA_CFG_LISTENERS=PLAINTEXT://0.0.0.0:9092,CONTROLLER://0.0.0.0:9093 \
  -e KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP=CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT \
  -e KAFKA_CFG_CONTROLLER_QUORUM_VOTERS=1@0.0.0.0:9093 \
  -e KAFKA_KRAFT_CLUSTER_ID=abcdefghijklmnopqrstuv \
  -e KAFKA_CFG_LOG_RETENTION_BYTES=524288000 \
  -e KAFKA_LOG_DIRS=/bitnami/kafka/data \
  -v /usr/local/src/kafka/data:/bitnami/kafka/data \
  -p 9092:9092 \
  -p 9093:9093 \
  luode0320/kafka:latest

7. 启动Kafka-UI可视化工具

sh
docker run -d \
  --name kafka-ui \
  --link kafka \
  -e DEFAULT_USERNAME=admin \
  -e DEFAULT_PASSWORD=admin \
  -v /usr/local/src/kafkaMap/data:/usr/local/kafka-map/data \
  -p 9091:8080 \
  luode0320/kafka-ui:latest

配置参数说明