Linux下Zookeeper安装步骤是怎样的？详细教程看这里

Linux环境下ZooKeeper安装详解

ZooKeeper简介与环境准备

ZooKeeper是一个开源的分布式协调服务，广泛应用于分布式系统中，如配置管理、命名服务、分布式锁、集群成员管理等，其设计目标是简化分布式应用的开发，通过简单的API实现高效的数据同步和协调功能，在Linux系统中安装ZooKeeper需要满足一定的环境要求，包括操作系统版本、Java运行环境（JRE）等。

1. 操作系统要求
   ZooKeeper支持主流的Linux发行版，如CentOS、Ubuntu、Debian等，本文以CentOS 7为例进行说明，其他发行版的操作步骤基本类似。

2. Java环境依赖
   ZooKeeper基于Java开发，需要安装JDK（Java Development Kit）或JRE，推荐使用JDK 8或更高版本，可通过以下命令检查Java是否已安装：

   java -version

   若未安装，可通过yum（CentOS）或apt（Ubuntu）安装JDK，以CentOS为例：

   yum install java-1.8.0-openjdk-devel -y

3. 创建专用用户（可选）
   为安全起见，建议为ZooKeeper创建一个专用用户，避免使用root用户运行服务：

   useradd -r -s /bin/false zookeeper

下载与解压ZooKeeper

1. 下载安装包
   从ZooKeeper官方镜像站点下载最新稳定版本（如3.8.0），使用wget命令获取安装包：

   wget https://archive.apache.org/dist/zookeeper/zookeeper-3.8.0/apache-zookeeper-3.8.0-bin.tar.gz

2. 解压并移动至安装目录
   将下载的压缩包解压至/opt目录，并创建软链接方便管理：

   tar -zxvf apache-zookeeper-3.8.0-bin.tar.gz -C /opt/
   ln -s /opt/apache-zookeeper-3.8.0-bin /opt/zookeeper

3. 设置文件权限
   若创建了专用用户，需修改安装目录的所属用户：

   chown -R zookeeper:zookeeper /opt/zookeeper

配置ZooKeeper

ZooKeeper的配置文件位于conf目录，主要涉及zoo.cfg和zoo_sample.cfg。

1. 复制配置文件

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

2. 编辑核心配置文件
   使用vim或nano编辑zoo.cfg，关键参数说明如下：

   

   • dataDir：指定数据存储目录，需提前创建并设置权限：

     mkdir -p /var/lib/zookeeper
     chown zookeeper:zookeeper /var/lib/zookeeper

     修改配置：dataDir=/var/lib/zookeeper

   • dataLogDir：指定事务日志存储目录（可选，默认与dataDir相同）：
     dataLogDir=/var/lib/zookeeper/logs
   • clientPort：客户端连接端口，默认为2181，可根据需求修改。
   • initLimit：follower与leader初始连接时的超时时间（tickTime的倍数）。
   • syncLimit：follower与leader同步数据的超时时间（tickTime的倍数）。
   • server.X：集群模式下配置各节点信息，格式为server.X=IP:2888:3888，其中X为服务器ID。

   示例配置（单机模式）：

   tickTime=2000
   dataDir=/var/lib/zookeeper
   clientPort=2181
   initLimit=5
   syncLimit=2

3. 配置环境变量（可选）
   编辑/etc/profile，添加ZooKeeper的bin目录至PATH：

   export ZOOKEEPER_HOME=/opt/zookeeper
   export PATH=$PATH:$ZOOKEEPER_HOME/bin

   保存后执行source /etc/profile使配置生效。

启动与验证ZooKeeper

1. 启动服务
   切换至zookeeper用户（若创建了专用用户）：

   su - zookeeper

   使用zkServer.sh脚本启动服务：

   /opt/zookeeper/bin/zkServer.sh start

2. 检查服务状态

   /opt/zookeeper/bin/zkServer.sh status

   若输出“Mode: standalone”，表示单机模式启动成功。

3. 客户端连接测试
   使用zkCli.sh连接本地ZooKeeper：

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

   连接成功后，可执行基本命令，如ls /（查看根目录节点）、create /test "hello"（创建节点）、get /test（获取节点数据）等。

   

集群模式部署（可选）

若需搭建ZooKeeper集群，至少需要3个节点以实现奇数 majority 选举。

1. 修改各节点配置
   在每台服务器上修改zoo.cfg，添加集群节点信息，三节点集群配置：

   server.1=192.168.1.101:2888:3888
   server.2=192.168.1.102:2888:3888
   server.3=192.168.1.103:2888:3888

2. 创建myid文件
   在每台服务器的dataDir目录下创建myid与server.X中的X对应，节点1：

   echo "1" > /var/lib/zookeeper/myid

3. 启动与验证
   依次在各节点启动ZooKeeper，通过zkServer.sh status查看角色（leader/follower）。

常见问题与解决方案

1. 启动失败：端口占用
   检查2181或2888端口是否被占用：

   netstat -tulnp | grep 2181

   若被占用，修改zoo.cfg中的clientPort或server.X的端口。

2. 集群节点无法通信
   检查防火墙设置，确保节点间端口互通：

   firewall-cmd --permanent --add-port=2181/tcp
   firewall-cmd --permanent --add-port=2888/tcp
   firewall-cmd --permanent --add-port=3888/tcp
   firewall-cmd --reload

3. 数据目录权限问题
   确保ZooKeeper用户对dataDir和dataLogDir有读写权限：

   chown -R zookeeper:zookeeper /var/lib/zookeeper

通过以上步骤，您已成功在Linux系统中完成ZooKeeper的单机或集群部署，ZooKeeper的稳定运行依赖于合理的配置和日常维护，建议定期检查日志文件（位于dataDir目录下的zookeeper.out）以监控服务状态，在实际生产环境中，还需结合具体需求调整参数,并配合监控系统实现高可用性。