itzg/kafka Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

镜像概述

该Docker镜像为多架构设计，提供Apache Kafka服务，且与testcontainers兼容。镜像的文档、源代码及问题跟踪均在GitHub仓库维护。

核心功能与特性

• 多架构支持：适配多种硬件架构（如amd64、arm64等），满足跨平台部署需求
• testcontainers兼容：支持在测试环境中通过testcontainers框架便捷集成Kafka服务
• 简化部署：提供开箱即用的配置，降低Kafka服务搭建复杂度
• 灵活配置：支持通过环境变量自定义Kafka参数，适应不同场景需求

使用场景与适用范围

• 开发环境：本地开发时快速搭建独立Kafka服务，无需复杂配置
• 测试环境：结合testcontainers进行集成测试，确保应用与Kafka的交互正确性
• 跨架构部署：在不同架构的设备（如x86服务器、ARM开发板）上统一部署Kafka服务
• 临时环境：快速创建短期使用的Kafka实例，用于功能验证或演示

使用方法与配置说明

基本使用（docker run）

通过以下命令快速启动Kafka容器（需配合Zookeeper使用）：

bash
docker run -d \
  --name kafka \
  -p 9092:9092 \
  -e KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092 \
  -e KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181 \
  itzg/kafka-multiarch

Docker Compose配置

推荐使用Docker Compose同时部署Kafka和Zookeeper：

yaml
version: '3'
services:
  zookeeper:
    image: itzg/zookeeper
    ports:
      - "2181:2181"
    environment:
      - ZOO_MY_ID=1
      - ZOO_PORT=2181
  
  kafka:
    image: itzg/kafka-multiarch
    ports:
      - "9092:9092"
    environment:
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092
      - KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181
      - KAFKA_BROKER_ID=1
      - KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1
    depends_on:
      - zookeeper

主要配置参数

核心环境变量

高级配置

可通过KAFKA_前缀添加任意Kafka配置参数，例如：

• KAFKA_NUM_PARTITIONS=3：设置默认主题分区数
• KAFKA_DEFAULT_REPLICATION_FACTOR=2：设置默认副本因子

文档与资源

• 完整文档、源代码及问题反馈：GitHub仓库