ubuntu kafka怎么改配置

ubuntu

小樊

2026-10-08 11:33:37

栏目: 智能运维

在 Ubuntu 上修改 Kafka 配置，通常分为修改配置文件和重启 Kafka 服务两部分。下面以最常见的 Kafka 3.x + Zookeeper（或 KRaft） 为例说明。

一、找到 Kafka 配置文件位置

如果你是用官方二进制包安装的（最常见）：

cd /opt/kafka/config        # 或 /usr/local/kafka/config
ls

常见配置文件：

server.properties —— 最核心的 Kafka 配置
zookeeper.properties —— Zookeeper 配置（如果用 ZK）
producer.properties
consumer.properties

如果是 apt 安装：

/etc/kafka/server.properties

二、修改 Kafka 配置（以 server.properties 为例）

编辑配置：

sudo vim /opt/kafka/config/server.properties

常见需要改的配置

# broker 唯一 ID
broker.id=0

# 监听地址（非常重要）
listeners=PLAINTEXT://0.0.0.0:9092
advertised.listeners=PLAINTEXT://你的IP:9092

# 日志存储目录
log.dirs=/data/kafka-logs

# Zookeeper 地址（ZK 模式）
zookeeper.connect=localhost:2181

# 分区副本
offsets.topic.replication.factor=1
default.replication.factor=1

改完后 :wq 保存。

三、重启 Kafka 使配置生效

1️⃣ 如果是手动启动（非 systemd）

先停掉：

# 如果有 zookeeper
bin/zookeeper-server-stop.sh
bin/kafka-server-stop.sh

再启动：

bin/zookeeper-server-start.sh -daemon config/zookeeper.properties
bin/kafka-server-start.sh -daemon config/server.properties

2️⃣ 如果是 systemd 管理的 Kafka

sudo systemctl restart kafka
# 或
sudo systemctl restart confluent-kafka

查看状态：

sudo systemctl status kafka

四、验证配置是否生效

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

或看日志：

tail -f logs/server.log

五、常见坑提醒 ⚠️

改了 listeners 一定要改 advertised.listeners
端口被占用 → netstat -tunlp | grep 9092
配置改错 Kafka 起不来 → 看 logs/server.log
KRaft 模式用的是 kraft/server.properties，不是 server.properties

如果你能告诉我：

✅ Kafka 安装方式（二进制 / apt / docker）
✅ Kafka 版本
✅ 想改哪一项配置

我可以直接给你精确命令。