Ubuntu 22 安装 ZooKeeper 3.9.3 记录

黑风风2025-07-22 14:08

Ubuntu 22 安装 ZooKeeper 3.9.3 记录

本文记录在 Ubuntu 22.04 系统上安装 ZooKeeper 3.9.3 的过程，包含 Java 环境准备、配置文件调整、启动与停机操作、以及如何将 ZooKeeper 注册为系统服务。

一、准备环境

ZooKeeper 3.9.x 要求 Java 11 或更高版本，这里选择安装 Java 17：

bash 复制代码

sudo apt update
sudo apt install openjdk-17-jdk -y
java -version

二、下载 ZooKeeper

前往 Apache 官网下载最新版 3.9.3，或使用命令行下载：

bash 复制代码

wget https://dlcdn.apache.org/zookeeper/zookeeper-3.9.3/apache-zookeeper-3.9.3-bin.tar.gz
tar -xzf apache-zookeeper-3.9.3-bin.tar.gz
mv apache-zookeeper-3.9.3-bin /root/zookeeper
cd /root/zookeeper

三、配置文件

ZooKeeper 提供了一个示例配置文件 zoo_sample.cfg，需要将其重命名为默认读取的 zoo.cfg：

bash 复制代码

cd /root/zookeeper/conf
cp zoo_sample.cfg zoo.cfg

简单修改内容（如 dataDir、端口等）可视情况调整。

四、启动 ZooKeeper

使用内置脚本启动：

bash 复制代码

/root/zookeeper/bin/zkServer.sh start

验证状态：

bash 复制代码

/root/zookeeper/bin/zkServer.sh status

或者进入 CLI 测试连接：

bash 复制代码

/root/zookeeper/bin/zkCli.sh -server 127.0.0.1:2181

五、停机操作

优雅停机：

bash 复制代码

/root/zookeeper/bin/zkServer.sh stop

六、系统服务化

创建 systemd 服务配置文件：

bash 复制代码

sudo nano /etc/systemd/system/zookeeper.service

内容如下：

ini 复制代码

[Unit]
Description=Apache Zookeeper
After=network.target

[Service]
Type=forking
ExecStart=/root/zookeeper/bin/zkServer.sh start
ExecStop=/root/zookeeper/bin/zkServer.sh stop
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用并启动服务：

bash 复制代码

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl enable zookeeper
sudo systemctl start zookeeper

查看状态：

bash 复制代码

sudo systemctl status zookeeper

参考链接

Zookeeper 官网安装说明