Apache Kafka单节点极速部署指南：10分钟搭建开发单节点环境
Kafka简介：
Apache Kafka是由LinkedIn开发并捐赠给Apache基金会的分布式流处理平台，现已成为实时数据管道和流应用领域的行业标准。它基于高吞吐、低延迟的设计理念，能够轻松处理每秒百万级消息传输，具备水平扩展、数据持久化、高容错等核心特性。Kafka广泛应用于日志聚合、实时监控、事件溯源、消息队列等场景，是大数据生态中连接传统数据库与流处理引擎（如Flink、Spark）的关键组件，被腾讯云、Netflix、Uber等顶级互联网企业深度应用于核心业务系统。
文章目录
- **Apache Kafka单节点极速部署指南：10分钟搭建开发单节点环境**
- Kafka简介：
- **一、环境准备与安装**
- 1. 安装 Java（详细步骤）
- 2. 下载并解压 Kafka
- **二、配置文件详解**
- 1. ZooKeeper 配置
- 2. Kafka Broker 配置
- **三、配置为系统服务（Systemd）**
- 1. 创建 `ZooKeeper` 服务文件
- 2. 创建 Kafka 服务文件
- 3. 创建专用用户和目录（增强安全性）
- 4. 修改配置文件中的持久化路径
- 5. 启用服务
- **四、验证服务*
- 1. 功能测试（详细命令）
- **五、关键配置项深度解析**
- **六、故障排查指南**
- 1. 查看服务日志
- 2. 端口占用检查
- 3. 文件权限修复
一、环境准备与安装
1. 安装 Java（详细步骤）
# CentOS
sudo yum install -y java-1.8.0-openjdk-devel
# Ubuntu
sudo apt update && sudo apt install -y openjdk-8-jdk
# 验证安装
java -version # 应输出类似 "openjdk version 1.8.0_382"
2. 下载并解压 Kafka
wget https://downloads.apache.org/kafka/3.6.1/kafka_2.13-3.6.1.tgz
tar -xzf kafka_2.13-3.6.1.tgz
mv kafka_2.13-3.6.1 /opt/kafka # 建议移动到标准化目录
cd /opt/kafka
如果服务器网络不佳可在Kafka官网手动下载并上传至服务器:
下载地址：Apache Kafka
二、配置文件详解
1. ZooKeeper 配置
config/zookeeper.properties
# 数据存储目录（重要：生产环境需改为持久化路径，如 /var/lib/zookeeper）
dataDir=/tmp/zookeeper
# 客户端连接端口
clientPort=2181
# 最大客户端连接数（0 表示无限制）
maxClientCnxns=0
# 集群配置（单节点无需配置）
# server.1=zk-node1:2888:3888
# server.2=zk-node2:2888:3888
2. Kafka Broker 配置
config/server.properties
# Broker 的唯一标识（集群中每个节点必须不同）
broker.id=0
# 监听地址和协议（生产环境建议用具体IP，如 PLAINTEXT://192.168.1.100:9092）
listeners=PLAINTEXT://:9092
# Kafka 日志存储目录（生产环境需改为持久化路径，如 /var/lib/kafka-logs）
log.dirs=/tmp/kafka-logs
# 每个 Topic 的默认分区数（影响并行度）
num.partitions=1
# ZooKeeper 连接地址（集群用逗号分隔，如 zk1:2181,zk2:2181）
zookeeper.connect=localhost:2181
# 其他重要参数（可选）
# 日志保留时间（小时）
log.retention.hours=168
# 单个日志文件最大大小（字节）
log.segment.bytes=1073741824
# 网络线程数
num.network.threads=3
# IO 线程数
num.io.threads=8
三、配置为系统服务（Systemd）
1. 创建 ZooKeeper 服务文件
sudo vim /etc/systemd/system/zookeeper.service
内容如下：
[Unit]
Description=Apache ZooKeeper Service
After=network.target
[Service]
Type=simple
User=kafka # 建议创建专用用户（见下方说明）
Group=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
RestartSec=10s
[Install]
WantedBy=multi-user.target
2. 创建 Kafka 服务文件
sudo vim /etc/systemd/system/kafka.service
内容如下：
[Unit]
Description=Apache Kafka Service
After=zookeeper.service
[Service]
Type=simple
User=kafka
Group=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
RestartSec=10s
[Install]
WantedBy=multi-user.target
3. 创建专用用户和目录（增强安全性）
sudo useradd -r -s /bin/false kafka
sudo mkdir -p /var/lib/{zookeeper,kafka-logs}
sudo chown -R kafka:kafka /var/lib/{zookeeper,kafka-logs} /opt/kafka
4. 修改配置文件中的持久化路径
-
修改
zookeeper.properties：dataDir=/var/lib/zookeeper -
修改
server.properties：log.dirs=/var/lib/kafka-logs
5. 启用服务
sudo systemctl daemon-reload
sudo systemctl enable --now zookeeper
sudo systemctl enable --now kafka
# 检查状态
sudo systemctl status zookeeper kafka
*四、验证服务
1. 功能测试（详细命令）
# 创建 Topic（明确指定分区和副本）
/opt/kafka/bin/kafka-topics.sh --create \
--topic test-topic \
--bootstrap-server localhost:9092 \
--partitions 3 \
--replication-factor 1
# 生产消息（输入多行消息后按 Ctrl+C 退出）
/opt/kafka/bin/kafka-console-producer.sh \
--topic test-topic \
--bootstrap-server localhost:9092
# 消费消息（新终端执行）
/opt/kafka/bin/kafka-console-consumer.sh \
--topic test-topic \
--bootstrap-server localhost:9092 \
--from-beginning
测试效果如图：
五、关键配置项深度解析
| 配置项 | 作用说明 | 生产环境建议值 |
|---|---|---|
broker.id | Broker 的唯一标识，集群中必须唯一 | 数字递增（0,1,2…） |
listeners | Broker 监听的网络地址和协议 | 使用服务器内网IP，如 PLAINTEXT://192.168.1.100:9092 |
log.dirs | Kafka 数据存储目录，多个目录用逗号分隔可提升性能 | 挂载独立磁盘，如 /data/kafka-logs |
zookeeper.connect | ZooKeeper 集群地址，格式为 host1:port1,host2:port2 | 至少3节点集群 |
num.partitions | 新建 Topic 的默认分区数（影响并行处理能力） | 根据业务需求设置（通常3-10） |
log.retention.hours | 消息保留时间 | 按业务需求（如 168=7天） |
default.replication.factor | 新建 Topic 的默认副本数（高可用关键） | 至少2，集群节点数≥副本数 |
六、故障排查指南
1. 查看服务日志
# ZooKeeper 日志
journalctl -u zookeeper -f
# Kafka 日志
journalctl -u kafka -f
2. 端口占用检查
sudo netstat -tlnp | grep -E '2181|9092'
3. 文件权限修复
sudo chown -R kafka:kafka /var/lib/{zookeeper,kafka-logs}
