温馨提示×

ubuntu kafka配置步骤是啥

小樊
37
2026-08-17 18:45:22
栏目: 智能运维

下面给你一份在 Ubuntu 上安装和配置 Kafka 的完整步骤(单机版,最常用),适合快速上手和测试。以 Kafka 3.x + Ubuntu 20.04/22.04 为例。


一、环境准备

1. 安装 Java(Kafka 依赖 JVM)

sudo apt update
sudo apt install openjdk-11-jdk -y

验证:

java -version

二、下载并安装 Kafka

2. 下载 Kafka

去官网复制最新下载地址,例如:

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

解压:

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

三、启动 Zookeeper(Kafka 依赖)

⚠️ Kafka 3.x 仍默认依赖 Zookeeper(KRaft 模式另说)

3. 启动 Zookeeper

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

✅ 看到 binding to port 2181 表示成功


四、启动 Kafka

4. 启动 Kafka Broker

新开一个终端:

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

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


五、创建 Topic(测试)

5. 创建 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

六、测试生产与消费

6. 启动生产者

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

输入消息:

hello kafka

7. 启动消费者

新开终端:

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

✅ 能收到消息说明 Kafka 配置成功


七、常用配置说明(重点)

8. server.properties 关键配置

broker.id=0
listeners=PLAINTEXT://localhost:9092
log.dirs=/tmp/kafka-logs
zookeeper.connect=localhost:2181

如果是远程访问,改成:

listeners=PLAINTEXT://0.0.0.0:9092
advertised.listeners=PLAINTEXT://服务器IP:9092

八、防火墙(如果有)

sudo ufw allow 9092
sudo ufw allow 2181

九、后台运行(推荐)

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

十、常见问题

1️⃣ Kafka 启动不了

  • Java 没装
  • 端口 9092 / 2181 被占用

2️⃣ 远程连不上

  • advertised.listeners 没配置
  • 防火墙没放行

十一、进阶(可选)

  • ✅ Kafka + KRaft(无 Zookeeper)
  • ✅ Kafka 集群
  • ✅ Kafka + systemd 服务
  • ✅ Kafka + Spring Boot

如果你需要 集群版 / KRaft 模式 / 生产环境配置 / systemd 自动启动,告诉我你的使用场景,我可以直接给你定制配置。

0