下面给你一份在 Debian 系统上部署 Apache Kafka 的完整实战指南,适用于 Debian 11 / 12,包含 单机部署 和 基础生产建议。
sudo apt update && sudo apt upgrade -y
Kafka 依赖 JVM,推荐 Java 17 或 11
sudo apt install -y openjdk-17-jdk
验证:
java -version
sudo useradd -r -m -s /bin/bash 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
sudo chown -R kafka:kafka kafka
Kafka 3.x 仍支持 Zookeeper(新版本推荐 KRaft,后面会讲)
sudo -u kafka /opt/kafka/bin/zookeeper-server-start.sh \
/opt/kafka/config/zookeeper.properties
后台运行:
sudo -u kafka nohup /opt/kafka/bin/zookeeper-server-start.sh \
/opt/kafka/config/zookeeper.properties > zookeeper.log 2>&1 &
sudo -u kafka /opt/kafka/bin/kafka-server-start.sh \
/opt/kafka/config/server.properties
后台运行:
sudo -u kafka nohup /opt/kafka/bin/kafka-server-start.sh \
/opt/kafka/config/server.properties > kafka.log 2>&1 &
/opt/kafka/bin/kafka-topics.sh \
--create \
--topic test \
--bootstrap-server localhost:9092 \
--partitions 1 \
--replication-factor 1
/opt/kafka/bin/kafka-topics.sh \
--list \
--bootstrap-server localhost:9092
/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
✅ 成功说明 Kafka 正常运行
server.propertiessudo vim /opt/kafka/config/server.properties
常见调整:
broker.id=1
listeners=PLAINTEXT://0.0.0.0:9092
advertised.listeners=PLAINTEXT://服务器IP:9092
log.dirs=/var/lib/kafka-logs
num.partitions=3
offsets.topic.replication.factor=1
重启 Kafka:
sudo -u kafka /opt/kafka/bin/kafka-server-stop.sh
sudo -u kafka nohup /opt/kafka/bin/kafka-server-start.sh \
/opt/kafka/config/server.properties > kafka.log 2>&1 &
sudo vim /etc/systemd/system/zookeeper.service
[Unit]
Description=Zookeeper
After=network.target
[Service]
Type=simple
User=kafka
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 vim /etc/systemd/system/kafka.service
[Unit]
Description=Apache Kafka
After=zookeeper.service
[Service]
Type=simple
User=kafka
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 zookeeper kafka
sudo systemctl start zookeeper
sudo systemctl start kafka
Kafka 3.x 支持 KRaft
/opt/kafka/bin/kafka-storage.sh random-uuid
/opt/kafka/bin/kafka-storage.sh format \
-t <UUID> \
-c /opt/kafka/config/kraft/server.properties
/opt/kafka/bin/kafka-server-start.sh \
/opt/kafka/config/kraft/server.properties
✅ 不再需要 Zookeeper
| 问题 | 解决 |
|---|---|
| 9092 端口无法访问 | 检查 advertised.listeners |
| 内存不足 | 修改 kafka-server-start.sh 中 -Xmx |
| systemd 启动失败 | 查看 journalctl -u kafka |
如果你愿意,可以告诉我:
✅ 单节点还是集群?
✅ 是否用 Docker?
✅ Debian 版本?
我可以给你 定制部署方案。