Kafka 单机部署

### Kafka 单机部署指南 (KRaft 模式) #### 准备工作 为了在单机环境中成功安装并运行基于 KRaft 模式的 Apache Kafka，需先下载对应版本的 Kafka 安装包。确保已正确解压至目标位置。 #### 修改配置文件 编辑 `config/kraft/server.properties` 文件以适应单节点环境的需求： ```properties node.id=1 controller.quorum.voters=1@localhost:9093 advertised.listeners=PLAINTEXT://localhost:9092 log.dirs=/tmp/kraft-combined-logs ``` 以上设置指定了唯一的节点 ID 和控制器投票者列表，在本例中仅有一个实例参与；同时定义了外部访问所需的监听地址以及日志存储的位置[^2]。 #### 初始化元数据 利用 `kafka-storage.sh` 命令行工具初始化本地磁盘上的元数据分区结构，并指定要使用的最高支持元数据版本号: ```bash bin/kafka-storage.sh format -t <cluster_id> -c $KAFKA_HOME/config/kraft/server.properties ``` 这里 `<cluster_id>` 应替换为实际生成或自定义的一个字符串标识符，而 `$KAFKA_HOME` 则指向 Kafka 的根目录所在路径[^4]。 #### 启动服务 通过如下命令启动 Kafka Broker 进程： ```bash bin/kafka-server-start.sh config/kraft/server.properties & ``` 这一步骤将会激活之前所配置的各项参数，并使 Kafka 实例处于待命状态准备接收生产者的写入请求或是消费者的读取操作[^3]。 #### 测试连接性 可以创建测试主题并通过控制台消费者验证整个流程是否正常运作： ```bash # 创建名为 'test' 的新主题 bin/kafka-topics.sh --create --topic test --partitions 1 --replication-factor 1 --bootstrap-server localhost:9092 # 使用控制台生产者发送消息到该主题 bin/kafka-console-producer.sh --broker-list localhost:9092 --topic test # 开启另一个终端窗口作为消费者来查看接收到的消息 bin/kafka-console-consumer.sh --bootstrap-server localhost:9092 --from-beginning --topic test ``` 上述指令展示了如何建立简单的发布/订阅机制用于初步的功能检验。