
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
用于运行https://github.com/apache/kafka/%E7%9A%84%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8F%E3%80%82%E6%94%AF%E6%8C%81%E4%BB%A5Kafka https://github.com/apache/kafka/blob/3.3.1/config/kraft/README.md%E8%BF%90%E8%A1%8C%E5%8D%95%E4%B8%AAApache Kafka实例。
镜像中包含的Kafka发行版直接从https://github.com/apache/kafka/%E6%9E%84%E5%BB%BA%E3%80%82
此独立容器镜像基于https://hub.docker.com/repository/docker/ueisele/apache-kafka-server%E3%80%82
容器镜像可在Docker Hub仓库https://hub.docker.com/repository/docker/ueisele/apache-kafka-server%E8%8E%B7%E5%8F%96%EF%BC%8C%E9%95%9C%E5%83%8F%E6%BA%90%E7%A0%81%E6%96%87%E4%BB%B6%E6%89%98%E7%AE%A1%E4%BA%8EGitLab%E4%BB%93%E5%BA%93ueisele/kafka-images%E3%80%82
RELEASE构建的最新标签:
3.5.0, 3.5.0-zulu20, 3.5.0-zulu20.0.1, 3.5.0-zulu20-alma9.2, 3.5.0-zulu20.0.1-alma9.2-202305123.4.1, 3.4.1-zulu17, 3.4.1-zulu17.0.7, 3.4.1-zulu17-alma9.2, 3.4.1-zulu17.0.7-alma9.2-20230512SNAPSHOT构建的最新标签:
3.6.0-SNAPSHOT, 3.6.0-SNAPSHOT-zulu20, 3.6.0-SNAPSHOT-zulu20.0.1, 3.6.0-SNAPSHOT-zulu20-alma9.2, 3.6.0-SNAPSHOT-zulu20.0.1-alma9.2-20230512此外,还会发布带有构建的Apache Kafka发行版关联Git-Sha的标签,例如ueisele/apache-kafka-server-standalone:3.6.0-SNAPSHOT-g09e8adb。
容器镜像基于https://hub.docker.com/repository/docker/ueisele/zulu-openjdk-micro%EF%BC%88%E5%B7%B2%E5%AE%89%E8%A3%85JRE%EF%BC%8C%E5%A6%8220-jre%E7%89%88%E6%9C%AC%EF%BC%89%E3%80%82
该OpenJDK镜像底层基于https://hub.docker.com/r/almalinux/9-micro%E3%80%82
OpenJDK使用Azul Zulu。Azul Zulu构建的OpenJDK是经过全面测试且符合TCK标准的OpenJDK构建版本。
要以KRaft模式启动单个Kafka服务器实例,只需运行:
bashpodman run --rm -p 19092:19092 ueisele/apache-kafka-server-standalone:3.5.0
如果使用Podman,容器网络无法从本地主机访问。可使用端口***,该端口将localhost:19092作为通告监听器暴露。
如果使用Docker,可直接使用端口9092并将其绑定到任何主机端口。原因是暴露了<container-ip>:9092,在使用Docker时可访问。
bashdocker run --rm -p 9092:9092 ueisele/apache-kafka-server-standalone:3.5.0
要以KRaft模式启动支持IPv6的单个Kafka实例,运行:
bashpodman network create --ipv6 --subnet fd01::/80 kafka-standalone podman run --rm -p 19092:19092 --net kafka-standalone -e STANDALONE_BROKER_IP_VERSION=ipv6 ueisele/apache-kafka-server-standalone:3.5.0
https://hub.docker.com/repository/registry-1.docker.io/ueisele/apache-kafka-server/%E9%95%9C%E5%83%8F%E4%BB%85%E8%AE%BE%E7%BD%AE%E7%8B%AC%E7%AB%8B%E6%89%A7%E8%A1%8C%E6%89%80%E9%9C%80%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%88%E5%8F%82%E8%A7%81Containerfile%EF%BC%89%E3%80%82
其配置与https://hub.docker.com/repository/docker/ueisele/apache-kafka-server%E9%95%9C%E5%83%8F%E5%AE%8C%E5%85%A8%E7%9B%B8%E5%90%8C%EF%BC%8C%E5%9B%A0%E6%AD%A4%E4%B9%9F%E4%B8%8EConfluent Docker镜像完全兼容。
对于Apache Kafka(https://hub.docker.com/repository/registry-1.docker.io/ueisele/apache-kafka-server-standalone/%EF%BC%89%E9%95%9C%E5%83%8F%EF%BC%8C%E9%9C%80%E6%8C%89%E4%BB%A5%E4%B8%8B%E6%96%B9%E5%BC%8F%E8%BD%AC%E6%8D%A2Apache Kafka代理配置属性并将其用作环境变量:
默认情况下,独立Kafka在所有接口的9092端口上打开监听器,并通告第一个找到的IP地址。
但可通过STANDALONE_BROKER_LISTENERS和STANDALONE_BROKER_ADVERTISED_LISTENERS覆盖代理的监听器和通告监听器。例如STANDALONE_BROKER_LISTENERS=PLAINTEXT://127.0.0.1:9092和STANDALONE_BROKER_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092。
代理的安全协议映射可通过STANDALONE_BROKER_LISTENER_SECURITY_PROTOCOL_MAP设置。
如果只想更改代理端口,可设置STANDALONE_BROKER_PORT。
除STANDALONE_BROKER_变量外,也可直接指定KAFKA_变量。STANDALONE_BROKER_变量是配置独立Kafka实例的便捷方式,无需同时设置控制器配置。
可通过以下环境变量调整日志配置:
KAFKA_LOG4J_PATTERN:设置日志格式(默认:[%d] (%t) %p %m (%c)%n)KAFKA_LOG4J_ROOT_LOGLEVEL:设置根日志级别(默认:INFO)KAFKA_LOG4J_LOGGERS:逗号分隔的日志器和日志级别键值对列表(默认:kafka=INFO,kafka.network.RequestChannel$=WARN,kafka.producer.async.DefaultEventHandler=DEBUG,kafka.request.logger=WARN,kafka.controller=TRACE,kafka.log.LogCleaner=INFO,state.change.logger=TRACE,kafka.authorizer.logger=WARN)可通过以下环境变量启用远程JMX:
propertiesKAFKA_JMX_PORT=6001 KAFKA_JMX_HOSTNAME=localhost
要调试Apache Kafka,设置以下环境变量:
propertiesKAFKA_DEBUG=y
此外,可通过以下环境变量配置调试行为:
propertiesJAVA_DEBUG_PORT=5005 DEBUG_SUSPEND_FLAG=y
要创建自己的Apache Kafka容器镜像,请克隆ueisele/kafka-image Git仓库并运行构建命令:
bashgit clone https://gitlab.com/ueisele/kafka-images.git cd kafka-images server-standalone/build.sh --build --tag 3.5.0 --openjdk-release 20
要创建具有特定OpenJDK版本的镜像,使用以下命令:
bashserver-standalone/build.sh --build --tag 3.5.0 --openjdk-release 20 --openjdk-version 20.0.1
要使用Java 17构建Apache Kafka 3.5.0的最新SNAPSHOT,运行:
bashserver-standalone/build.sh --build --branch trunk --openjdk-release 17
server-standalone/build.sh脚本提供以下选项:
Usage: server-standalone/build.sh [--build] [--push] [--registry docker.io] [--user ueisele] [--archs amd64,arm64] [--github-repo apache/kafka] [--commit-sha 09e8adb] [--tag 3.5.0] [--branch trunk] [--pull-request 9999] [--openjdk-release 20] [--openjdk-version 20.0.1]
此容器镜像根据Apache 2许可证授权。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务