🚀 Zookeeper 单节点部署指南

这是一个简洁的 Zookeeper 单节点部署指南，适用于 Linux 和 Windows 系统。Zookeeper 是分布式协调服务，常用于 Kafka、Dubbo 等系统。让我们快速搭建吧！📜

---

1️⃣ 准备工作

1.1 下载 Zookeeper 安装包

• 文件名：apache-zookeeper-3.8.0-bin.tar.gz
• 下载地址：Zookeeper 官网

💡 提示：选择 bin 版本，包含预编译二进制文件，免去编译步骤。

1.2 安装 JDK 并配置环境变量

• 要求：JDK 8 或更高版本（Zookeeper 3.8.0 支持 JDK 11+ 更佳）。
• Linux 示例：

  sudo yum install -y java-11-openjdk
  export JAVA_HOME=/usr/lib/jvm/java-11-openjdk
  export PATH=$JAVA_HOME/bin:$PATH
  echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk' >> ~/.bashrc
  echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
  source ~/.bashrc
  

• Windows 示例：
  1. 下载并安装 JDK（Oracle JDK 或 OpenJDK）。
  2. 配置环境变量：
     • 变量名：JAVA_HOME，值：C:\Program Files\Java\jdk-11
     • 添加到 Path：%JAVA_HOME%\bin

✅ 验证：运行 java -version 检查 JDK 是否正常。

---

2️⃣ 环境搭建

2.1 解压 Zookeeper 安装包

tar -zvxf apache-zookeeper-3.8.0-bin.tar.gz -C /app

📦 结果：解压到 /app/apache-zookeeper-3.8.0-bin。

2.2 创建 Zookeeper 数据目录

mkdir -p /app/apache-zookeeper-3.8.0-bin/data

📌 说明：数据目录用于存储 Zookeeper 的快照和日志。

2.3 创建 myid 文件

为单节点分配唯一 ID（单节点通常设为 1）：

echo 1 > /app/apache-zookeeper-3.8.0-bin/data/myid

⚠️ 注意：myid 文件内容为纯数字，无空格或换行。

2.4 修改配置文件 zoo.cfg

1. 进入配置目录并重命名样例文件：

   cd /app/apache-zookeeper-3.8.0-bin/conf
   mv zoo_sample.cfg zoo.cfg
   

2. 编辑 zoo.cfg：

   vim zoo.cfg
   

   配置关键参数（其他保持默认）：

   dataDir=/app/apache-zookeeper-3.8.0-bin/data
   # 默认客户端端口
   clientPort=2181
   

💡 提示：确保 dataDir 路径与步骤 2.2 一致。

2.5 启动 Zookeeper

• Linux（后台运行）：

  /app/apache-zookeeper-3.8.0-bin/bin/zkServer.sh start
  

  输出示例：

  ZooKeeper JMX enabled by default
  Using config: /app/apache-zookeeper-3.8.0-bin/conf/zoo.cfg
  Starting zookeeper ... STARTED
  

• Windows：
  在 Zookeeper 根目录下双击 bin\zkServer.cmd，或通过命令行：

  .\bin\zkServer.cmd
  

🌟 提示：Windows 启动后会打开一个命令行窗口，关闭窗口即停止服务。

---

3️⃣ 环境验证

检查 Zookeeper 状态：

/app/apache-zookeeper-3.8.0-bin/bin/zkServer.sh status

输出示例：

ZooKeeper JMX enabled by default
Using config: /app/apache-zookeeper-3.8.0-bin/conf/zoo.cfg
Mode: standalone

✅ 成功标志：显示 Mode: standalone 表示单节点运行正常。

额外验证

使用 Zookeeper 客户端连接测试：

/app/apache-zookeeper-3.8.0-bin/bin/zkCli.sh -server 127.0.0.1:2181

📌 结果：进入 Zookeeper 命令行，输入 ls / 可查看根节点。

---

🔧 使用技巧

1. 查看日志：
   • Linux：tail -f /app/apache-zookeeper-3.8.0-bin/logs/zookeeper*.out
   • Windows：检查 logs 目录下的日志文件。
2. 停止 Zookeeper：
   • Linux：/app/apache-zookeeper-3.8.0-bin/bin/zkServer.sh stop
   • Windows：Ctrl+C 或关闭命令行窗口。
3. 测试客户端命令：

   /app/apache-zookeeper-3.8.0-bin/bin/zkCli.sh -server 127.0.0.1:2181
   create /test "testdata"
   get /test
   

4. 持久化配置：
   将环境变量写入 ~/.bashrc（Linux）或系统变量（Windows），避免每次手动设置。

---

📌 注意事项

• 端口冲突：确保 2181 端口未被占用（netstat -tuln | grep 2181）。
• 权限：Linux 下确保 data 目录有写权限（chmod -R 777 /app/apache-zookeeper-3.8.0-bin/data）。
• 版本兼容：Zookeeper 3.8.0 推荐搭配 Kafka 2.8+ 或更高版本。
• 日志清理：定期清理 data 目录下的快照和日志文件，避免磁盘占满。