Apache Kafka 是一个分布式事件流平台,它支持高吞吐量、低延迟的实时数据流处理与传输,可广泛应用于消息传递、日志聚合、实时分析、数据集成等场景,其长期维护轨道由 Canonical 负责,以确保平台在稳定性、安全性及功能迭代方面获得持续支持,为企业级用户提供可靠的事件流处理解决方案。
收藏数: 60
下载次数: 2855533
类型:
ubuntu/kafka本文档介绍的 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 ubuntu/zookeeper:3.8-22.04_edge
bashdocker run --detach --name kafka --network kafka-network -p 9092:9092 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 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 一致。 |
bashdocker logs -f kafka-container
bashdocker exec -it kafka-container /bin/bash
若发现镜像 bug 或需请求功能,请在 Launchpad 提交工单:
[***]
工单标题格式:kafka: <问题摘要>,并附上镜像完整 digest(通过以下命令获取):
bashdocker images --no-trunc --quiet ubuntu/kafka:<tag>
以下通道(标签)不再更新,请升级至新版本;若无法升级,可 联系 Canonical。
| 通道 | 版本 | 停止维护日期 | 升级路径 |
|---|---|---|---|
track |
以下是 ubuntu/kafka 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 版本下载页面。





manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务