温馨提示×

ubuntu怎么搭建kafka

小樊
34
2026-08-17 19:11:23
栏目: 智能运维

下面给你一个在 Ubuntu 上从零搭建 Kafka(单机版)的完整实操教程,适合学习 / 开发 / 测试环境
我默认你用的是 Ubuntu 20.04 / 22.04,Kafka 版本以 3.x(配合 Kafka 自带 Zookeeper) 为例。


一、准备工作

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java(Kafka 依赖 JDK)

Kafka 需要 Java 8 或以上:

sudo apt install openjdk-11-jdk -y

验证:

java -version

二、下载并安装 Kafka

1. 下载 Kafka

可以去官网复制最新链接,这里用稳定版本示例:

cd /opt
sudo wget https://downloads.apache.org/kafka/3.6.1/kafka_2.13-3.6.1.tgz

2. 解压

sudo tar -zxvf kafka_2.13-3.6.1.tgz
sudo mv kafka_2.13-3.6.1 kafka

三、启动 Kafka(使用自带 Zookeeper)

⚠️ 新版本 Kafka 已支持 KRaft 模式(无 Zookeeper),但学习阶段建议先用 Zookeeper,更稳定。

1. 启动 Zookeeper

cd /opt/kafka
bin/zookeeper-server-start.sh config/zookeeper.properties

✅ 看到 binding to port 2181 表示成功

建议开一个新终端继续操作


2. 启动 Kafka

cd /opt/kafka
bin/kafka-server-start.sh config/server.properties

✅ 看到 started (kafka.server.KafkaServer) 表示成功


四、测试 Kafka 是否可用

1. 创建 Topic

bin/kafka-topics.sh \
--create \
--topic test-topic \
--bootstrap-server localhost:9092 \
--partitions 1 \
--replication-factor 1

查看 Topic:

bin/kafka-topics.sh --list --bootstrap-server localhost:9092

2. 发送消息(生产者)

bin/kafka-console-producer.sh \
--topic test-topic \
--bootstrap-server localhost:9092

输入内容:

hello kafka

3. 消费消息(消费者)

另开一个终端:

bin/kafka-console-consumer.sh \
--topic test-topic \
--from-beginning \
--bootstrap-server localhost:9092

✅ 能看到 hello kafka 说明 Kafka 正常运行


五、后台运行(推荐)

1. Zookeeper 后台启动

nohup bin/zookeeper-server-start.sh config/zookeeper.properties > zookeeper.log 2>&1 &

2. Kafka 后台启动

nohup bin/kafka-server-start.sh config/server.properties > kafka.log 2>&1 &

查看进程:

jps

六、关闭 Kafka

bin/kafka-server-stop.sh
bin/zookeeper-server-stop.sh

七、常见问题

1. Kafka 启动失败

检查:

java -version
netstat -tunlp | grep 9092

2. 内存不足

编辑:

bin/kafka-server-start.sh

修改:

export KAFKA_HEAP_OPTS="-Xmx256M -Xms128M"

八、进阶(可选)

KRaft 模式(无 Zookeeper)
Kafka 集群搭建
Kafka + Spring Boot
Kafka 配置文件详解

如果你告诉我:

  • ✅ 单机还是集群?
  • ✅ 学习还是生产?
  • ✅ 是否要连 Spring / Python / Go?

我可以给你更贴合你场景的 Kafka 方案

0