Apache Kafka单节点极速部署指南及搭建开发单节点环境的操作步骤

 更新时间:2025年03月05日 09:51:22   作者:ζั͡山 ั͡有扶苏 ั͡✾  
本文介绍了如何在10分钟内快速部署Apache Kafka单节点开发环境,首先,简要介绍了Kafka的背景、特性和应用场景,然后,详细描述了环境准备、安装、配置文件详解、配置为系统服务、验证服务和关键配置项深度解析等内容,感兴趣的朋友一起看看吧

Apache Kafka单节点极速部署指南:10分钟搭建开发单节点环境

Kafka简介:

Apache Kafka是由LinkedIn开发并捐赠给Apache基金会的分布式流处理平台,现已成为实时数据管道和流应用领域的行业标准。它基于高吞吐、低延迟的设计理念,能够轻松处理每秒百万级消息传输,具备水平扩展、数据持久化、高容错等核心特性。Kafka广泛应用于日志聚合、实时监控、事件溯源、消息队列等场景,是大数据生态中连接传统数据库与流处理引擎(如Flink、Spark)的关键组件,被腾讯云、Netflix、Uber等顶级互联网企业深度应用于核心业务系统。

一、环境准备与安装

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

image-20250304151400265

三、配置为系统服务(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.idBroker 的唯一标识,集群中必须唯一数字递增(0,1,2…)
listenersBroker 监听的网络地址和协议使用服务器内网IP,如 PLAINTEXT://192.168.1.100:9092
log.dirsKafka 数据存储目录,多个目录用逗号分隔可提升性能挂载独立磁盘,如 /data/kafka-logs
zookeeper.connectZooKeeper 集群地址,格式为 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}

到此这篇关于Apache Kafka单节点极速部署指南及搭建开发单节点环境的操作步骤的文章就介绍到这了,更多相关Apache Kafka单节点部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 简析Linux网络编程函数

    简析Linux网络编程函数

    这篇文章主要介绍了Linux网络编程函数,利用这些基本函数,可以实现tcp协议通讯,可以实现通信。需要了解的小伙伴可以参考一下
    2021-08-08
  • 浅谈linux线程切换问题

    浅谈linux线程切换问题

    下面小编就为大家带来一篇浅谈linux线程切换问题。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-01-01
  • CentOS7.2安装MySql5.7并开启远程连接授权的教程

    CentOS7.2安装MySql5.7并开启远程连接授权的教程

    这篇文章主要介绍了CentOS7.2安装MySql5.7并开启远程连接授权的教程,本文图文并茂给大家介绍的非常详细,具有一定的参考借鉴价值 ,需要的朋友可以参考下
    2019-07-07
  • Linux文件操作新手指南之关于install命令的用法

    Linux文件操作新手指南之关于install命令的用法

    这篇文章主要介绍了Linux文件操作新手指南之关于install命令的用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-02-02
  • Linux中查看文本的小技巧(超实用!)

    Linux中查看文本的小技巧(超实用!)

    这篇文章主要给大家介绍了关于Linux中查看文本的小技巧,这些小技巧非常的实用,文中通过示例代码介绍的非常详细,对大家学习或者使用linux系统具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-08-08
  • centos8使用Docker部署Django项目的详细教程

    centos8使用Docker部署Django项目的详细教程

    这篇文章主要介绍了在centos8使用Docker部署Django项目的教程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-05-05
  • 解读现代Linux发行版为何忽略Shell脚本的SUID位

    解读现代Linux发行版为何忽略Shell脚本的SUID位

    现代Linux系统禁用Shell脚本的SUID权限,因内核执行模型差异导致权限无法传递至解释器进程,历史漏洞如环境变量中毒和命令注入促使安全设计转向编译型语言或sudo/setcap等更可控的权限管理方案
    2025-09-09
  • Linux下简易进度条的实现代码

    Linux下简易进度条的实现代码

    下面小编就为大家带来一篇Linux下简易进度条的实现代码。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-01-01
  • CentOS系统中PHP和MySQL的升级方法

    CentOS系统中PHP和MySQL的升级方法

    yum是CentOS系统自带的用于方便地添加/删除/更新RPM包的工具,它能自动解决包的倚赖性问题。
    2010-06-06
  • Ubuntu修改docker数据目录的实现方式

    Ubuntu修改docker数据目录的实现方式

    这篇文章主要介绍了Ubuntu修改docker数据目录的实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-03-03

最新评论