1. 安装并配置Java环境
Kafka依赖Java运行环境(JRE/JDK),推荐安装OpenJDK 8或更高版本(如OpenJDK 11)。安装后需通过java -version验证是否成功,确保Kafka能正常启动。
2. 正确安装与配置Zookeeper
Kafka通过Zookeeper实现集群管理、元数据存储和Leader选举。需先下载并解压Zookeeper,编辑zoo.cfg文件设置dataDir(数据目录,如/var/lib/zookeeper)和clientPort(客户端连接端口,默认2181);启动Zookeeper后需验证其状态(netstat -nap | grep 2181),确保Kafka能连接到Zookeeper。
3. 关键Kafka配置项检查
编辑server.properties文件时,需重点确认以下配置:
PLAINTEXT://0.0.0.0:9092,允许所有IP访问;若为单机测试,可使用PLAINTEXT://localhost:9092);PLAINTEXT://your_server_ip:9092);/tmp/kafka-logs,需确保目录存在且有写入权限);localhost:2181,集群中需列出所有Zookeeper节点,用逗号分隔)。4. 防火墙与端口放行
Ubuntu默认使用ufw防火墙,需开放Kafka和Zookeeper的端口:
sudo ufw allow 2181和sudo ufw allow 9092放行端口,然后通过sudo ufw reload重新加载防火墙规则。5. 环境变量配置
为方便使用Kafka命令,需将Kafka的bin目录添加到系统PATH环境变量中。编辑/etc/profile或~/.bashrc文件,添加以下内容:
export KAFKA_HOME=/usr/local/kafka # Kafka安装目录 export PATH=$PATH:$KAFKA_HOME/bin # 添加Kafka命令路径 保存后执行source /etc/profile(或source ~/.bashrc)使配置生效。
6. 文件与目录权限设置
确保Kafka安装目录(如/usr/local/kafka)、日志目录(如/tmp/kafka-logs)和Zookeeper数据目录(如/var/lib/zookeeper)的权限正确,避免因权限不足导致启动失败。通常将目录所有者设置为运行Kafka的用户(如root或当前用户),执行sudo chown -R your_user:your_group /usr/local/kafka(替换为实际用户和组)。
7. 集群配置注意事项(可选)
若需部署Kafka集群,需在多台Ubuntu节点上重复上述步骤,并确保:
broker.id唯一;listeners和advertised.listeners配置正确(advertised.listeners需指向节点的实际IP或域名);zookeeper.connect配置一致(包含集群中所有Zookeeper节点的地址);zoo.cfg中配置server.X(如server.1=node1_ip:2888:3888,server.2=node2_ip:2888:3888等)。8. 版本兼容性与资源分配
选择Kafka版本时,需考虑与Zookeeper版本的兼容性(如Kafka 3.5.x推荐搭配Zookeeper 3.5.x及以上版本);同时确保服务器有足够的内存(建议至少4GB)、磁盘空间(日志目录需预留充足空间)和CPU资源,避免因资源不足导致Kafka性能下降或启动失败。