
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本文档介绍的 Kafka Docker 镜像由 Canonical 提供,基于 Ubuntu 系统构建。该镜像会持续接收安全更新,并同步升级至较新版本的 Kafka 或 Ubuntu。此仓库可免费使用,且不受每用户速率限制。
Apache Kafka 是一款开源的分布式事件流平台,适用于高性能数据管道、流处理分析及系统集成场景。详情可访问 [Apache Kafka 官网] 。
使用此镜像时,需配合 [Apache Zookeeper 镜像] 运行。
注意:版本号 ≤3.1 的镜像基于 Dockerfile 构建;从 3.6.1 版本开始,镜像改为基于 Rocks 构建,入口点变更为 Pebble。更多信息可参考 [Rockcraft 文档] 。
部署单节点 Kafka 容器前,需先部署 ZooKeeper 服务并确保 Kafka 可与其通信。步骤如下:
bashdocker network create -d bridge kafka-network
bashdocker run --detach --name zookeeper --network kafka-network docker.xuanyuan.run/ubuntu/zookeeper:3.8-22.04_edge
bashdocker run --detach --name kafka --network kafka-network -p 9092:9092 docker.xuanyuan.run/ubuntu/kafka:3.9.1-22.04_edge
![LTS]
LTS 通道提供长达 5 年的免费安全维护。
![ESM]
通过 Canonical 受限仓库,ESM 可提供长达 10 年的客户安全维护([详情] )。
| 通道标签 | 支持截止日期 | 当前版本 | 支持架构 |
|---|---|---|---|
3.1-22.04_beta | - | Kafka 3.1 on Ubuntu 22.04 LTS | amd64, ppc64le, s390x, arm64 |
3.1-22.04_edge, edge, latest | - | 同上 | 同上 |
3.6-22.04_edge | - | Kafka 3.6 on Ubuntu 22.04 LTS | amd64 |
3.9.1-22.04_edge | 2027-02 | Kafka 3.9.1 on Ubuntu 22.04 LTS | amd64 |
通道标签按稳定性排序:stable(最稳定)、candidate、beta、edge(风险较高)。若列出 beta,则 edge 也可用;若列出 candidate,则 beta 和 edge 可用;stable 则包含所有通道。镜像会按 edge → beta → candidate → stable 顺序更新。
若涉及商业分发,或需使用 ESM 通道/未列出的版本,请联系 Canonical 团队([官网] 或*** [***已删除])。
bashdocker run -d --name kafka-container -e TZ=UTC -p 9092:9092 docker.xuanyuan.run/ubuntu/kafka:3.1-22.04_beta
启动后,可通过 `[] 访问 Kafka 服务。
| 参数 | 描述 |
|---|---|
-e TZ=UTC | 设置时区(示例为 UTC)。 |
-e ZOOKEEPER_HOST=<zookeeper> | 指定关联的 ZooKeeper 实例主机名(如 zookeeper)。 |
-e ZOOKEEPER_PORT=2181 | 指定关联的 ZooKeeper 实例端口(默认 2181)。 |
-p 9092:9092 | 将 Kafka 服务暴露在本地 9092 端口。 |
-v /path/to/config/file:/etc/kafka/server.properties | 挂载本地 Kafka 配置文件(替换默认配置)。 |
-v kafkaData:/var/lib/kafka | 将数据持久化到 Docker 卷 kafkaData,需确保与配置 logs.dirs 一致。 |
查看容器日志
CODE_TOKEN_4
进入容器终端
CODE_TOKEN_5
若发现镜像 bug 或需请求功能,请在 Launchpad 提交工单:
[[]]
工单标题格式:kafka: <问题摘要>,并附上镜像完整 digest(通过以下命令获取):
CODE_TOKEN_6
以下通道(标签)不再更新,请升级至新版本;若无法升级,可 [联系 Canonical] 。
| 通道 | 版本 | 停止维护日期 | 升级路径 |
|---|---|---|---|
track |
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务
以下是 ubuntu/kafka 相关的常用 Docker 镜像,适用于 不同场景 等不同场景: