Kafka配置Ubuntu时需注意哪些端口

Kafka 在 Ubuntu 配置的端口要点

一、核心端口与作用

• 9092/TCP：Kafka Broker 的客户端通信端口，生产者和消费者默认通过该端口接入。常见于 listeners 配置为 PLAINTEXT://:9092 或 PLAINTEXT://0.0.0.0:9092。
• 2181/TCP：ZooKeeper 客户端端口（仅在使用 ZooKeeper 模式时）。Kafka 通过 zookeeper.connect=host:2181 连接。
• 9093/TCP：KRaft 模式下用于控制器通信与内部复制的端口，常与 controller.quorum.voters 配合使用。
• 说明：若部署在云服务器或容器环境，还需确保云厂商安全组/宿主机防火墙对相应端口放通。

二、防火墙与安全组放通示例

• UFW（Ubuntu 常用）
  • 放通客户端端口：sudo ufw allow 9092/tcp
  • 如使用 ZooKeeper：sudo ufw allow 2181/tcp
• firewalld
  • 放通端口：sudo firewall-cmd --add-port=9092/tcp --permanent（按需添加 2181、9093）
  • 使配置生效：sudo firewall-cmd --reload
• 云环境：在控制台安全组规则中放行对应 TCP 端口 与来源网段。

三、关键配置与端口映射

• 监听器与对外地址
  • 明确 listeners（Broker 实际监听地址与端口），如：PLAINTEXT://0.0.0.0:9092
  • 正确设置 advertised.listeners（客户端实际连接的地址），对跨主机/公网访问尤为重要，避免写成 localhost/127.0.0.1。
• KRaft 模式
  • 配置 controller.quorum.voters 指定控制器节点，并确保 9093/TCP 在节点间可达。
• 端口冲突排查
  • 启动失败并出现 “Address already in use” 时，检查端口占用：sudo netstat -tulnp | grep 9092 或使用 lsof -i :9092，必要时更换端口或终止占用进程。

四、快速验证

• 本机监听检查：netstat -tulnp | grep 9092（确认 Broker 已在 9092 监听）
• 连通性测试（ZooKeeper）：echo stat | nc localhost 2181（能返回状态信息说明 ZooKeeper 端口可达）
• 客户端连通性：使用控制台生产者/消费者脚本指定 –bootstrap-server host:9092 进行收发测试，验证网络和 advertised 地址是否配置正确。