下面给你一个在 Debian(如 Debian 11/12)上从零配置 Kafka 的实用指南,包含 单节点最小可用配置,以及常见可调参数。
Kafka 3.x 推荐使用 Java 8 / 11 / 17
sudo apt update
sudo apt install -y openjdk-17-jdk
验证:
java -version
以 Kafka 3.6 为例:
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
说明:
2.13是 Scala 版本,不影响使用
/opt/kafka
├── config
│ ├── server.properties
│ ├── zookeeper.properties
├── bin
✅ Kafka 3.x 支持 KRaft(无 Zookeeper),但新手建议先用 Zookeeper
编辑:
sudo nano /opt/kafka/config/zookeeper.properties
最小配置:
dataDir=/var/lib/zookeeper
clientPort=2181
创建数据目录:
sudo mkdir -p /var/lib/zookeeper
sudo nano /opt/kafka/config/server.properties
broker.id=0
listeners=PLAINTEXT://:9092
advertised.listeners=PLAINTEXT://localhost:9092
log.dirs=/var/lib/kafka-logs
num.partitions=1
default.replication.factor=1
zookeeper.connect=localhost:2181
创建日志目录:
sudo mkdir -p /var/lib/kafka-logs
/opt/kafka/bin/zookeeper-server-start.sh /opt/kafka/config/zookeeper.properties
/opt/kafka/bin/kafka-server-start.sh /opt/kafka/config/server.properties
建议分别用两个终端测试
/opt/kafka/bin/kafka-topics.sh \
--create \
--topic test \
--bootstrap-server localhost:9092 \
--partitions 1 \
--replication-factor 1
/opt/kafka/bin/kafka-console-producer.sh \
--topic test \
--bootstrap-server localhost:9092
/opt/kafka/bin/kafka-console-consumer.sh \
--topic test \
--from-beginning \
--bootstrap-server localhost:9092
sudo nano /etc/systemd/system/zookeeper.service
[Unit]
Description=Zookeeper
After=network.target
[Service]
Type=simple
ExecStart=/opt/kafka/bin/zookeeper-server-start.sh /opt/kafka/config/zookeeper.properties
ExecStop=/opt/kafka/bin/zookeeper-server-stop.sh
Restart=on-failure
[Install]
WantedBy=multi-user.target
sudo nano /etc/systemd/system/kafka.service
[Unit]
Description=Kafka
After=zookeeper.service
[Service]
Type=simple
ExecStart=/opt/kafka/bin/kafka-server-start.sh /opt/kafka/config/server.properties
ExecStop=/opt/kafka/bin/kafka-server-stop.sh
Restart=on-failure
[Install]
WantedBy=multi-user.target
启用:
sudo systemctl daemon-reload
sudo systemctl enable --now zookeeper
sudo systemctl enable --now kafka
| 配置项 | 说明 |
|---|---|
num.partitions |
默认分区数 |
log.retention.hours |
日志保留时间 |
offsets.retention.minutes |
消费位移保留 |
auto.create.topics.enable |
是否自动建 Topic |
delete.topic.enable |
是否允许删除 Topic |
示例:
log.retention.hours=168
auto.create.topics.enable=false
delete.topic.enable=true
如果你告诉我:
我可以给你更精确的生产级配置。