CentOS单机部署ZooKeeper全流程指南

一、环境准备与前置条件

在CentOS 7/8系统上部署ZooKeeper单机版，需确保满足以下基础条件：

1. 系统资源：建议至少2核CPU、4GB内存、20GB磁盘空间（生产环境需更高配置）
2. Java环境：ZooKeeper 3.6+版本需JDK 11+支持，可通过java -version验证

   # 安装OpenJDK示例
   sudo yum install -y java-11-openjdk-devel
   export JAVA_HOME=/usr/lib/jvm/java-11-openjdk

3. 网络配置：关闭防火墙或开放2181端口（开发环境可临时禁用）

   sudo systemctl stop firewalld
   sudo systemctl disable firewalld

4. 依赖工具：安装wget、tar等基础工具

   sudo yum install -y wget tar

二、ZooKeeper安装与版本选择

2.1 版本选型建议

• 稳定版推荐：3.7.1（LTS版本）或3.8.1（最新稳定版）
• 避免版本：3.5.x系列存在已知的ZAB协议缺陷
• 下载验证：

  wget https://dlcdn.apache.org/zookeeper/zookeeper-3.8.1/apache-zookeeper-3.8.1-bin.tar.gz
  sha512sum apache-zookeeper-3.8.1-bin.tar.gz | grep '官方公布的哈希值'

2.2 标准化安装流程

1. 解压安装：

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

2. 创建数据目录：

   sudo mkdir -p /var/lib/zookeeper
   sudo chown -R $(whoami):$(whoami) /var/lib/zookeeper

3. 环境变量配置：

   echo 'export ZOOKEEPER_HOME=/opt/zookeeper' >> ~/.bashrc
   echo 'export PATH=$PATH:$ZOOKEEPER_HOME/bin' >> ~/.bashrc
   source ~/.bashrc

三、核心配置详解

3.1 配置文件优化

编辑/opt/zookeeper/conf/zoo.cfg（需从zoo_sample.cfg复制）：

# 基础配置
tickTime=2000
dataDir=/var/lib/zookeeper
clientPort=2181
# 单机模式特殊配置
standaloneEnabled=true
autopurge.snapRetainCount=3
autopurge.purgeInterval=24

关键参数说明：

• tickTime：基础时间单位（毫秒），影响心跳检测和会话超时
• dataDir：必须与数据目录权限匹配
• standaloneEnabled：3.5+版本新增的单机模式标识
• autopurge：自动清理旧快照和日志的配置

3.2 日志系统配置

1. 修改log4j配置：

   # 在conf/log4j.properties中调整
   log4j.appender.ROLLINGFILE.MaxFileSize=100MB
   log4j.appender.ROLLINGFILE.MaxBackupIndex=10

2. 日志目录权限：

   sudo mkdir -p /var/log/zookeeper
   sudo chown $(whoami):$(whoami) /var/log/zookeeper

四、服务管理与验证

4.1 系统服务封装

创建/etc/systemd/system/zookeeper.service：

[Unit]
Description=Apache ZooKeeper
After=network.target
[Service]
Type=forking
User=$(whoami)
Group=$(whoami)
Environment="ZOO_LOG_DIR=/var/log/zookeeper"
ExecStart=/opt/zookeeper/bin/zkServer.sh start-foreground
ExecStop=/opt/zookeeper/bin/zkServer.sh stop
Restart=on-failure
[Install]
WantedBy=multi-user.target

操作命令：

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

4.2 状态验证方法

1. 基础状态检查：

   echo stat | nc localhost 2181
   # 正常应返回：Zookeeper version: 3.8.1... Mode: standalone

2. 四字命令使用：

   # 查看服务器状态
   echo srvr | nc localhost 2181
   # 查看连接数
   echo cons | nc localhost 2181

3. JMX监控配置（可选）：
   在zoo.cfg中添加：

   jmx.enable=true
   jmx.port=1099

五、常见问题解决方案

5.1 启动失败排查

1. 端口冲突：

   netstat -tulnp | grep 2181
   # 冲突时修改clientPort或终止占用进程

2. 数据目录权限：

   ls -ld /var/lib/zookeeper
   # 确保属主为运行用户

3. 日志分析：

   tail -100f /var/log/zookeeper/zookeeper.out

5.2 性能优化建议

1. JVM参数调整：
   修改zkEnv.sh中的ZOO_JVM_FLAGS：

   ZOO_JVM_FLAGS="-Xms2g -Xmx2g -XX:+UseG1GC"

2. 快照策略优化：

   # 在zoo.cfg中添加
   snapCount=10000

六、生产环境注意事项

1. 数据备份：

   # 定时备份数据目录
   crontab -e
   # 添加：0 3 * * * tar -czf /backup/zk_data_$(date +\%Y\%m\%d).tar.gz /var/lib/zookeeper

2. 升级策略：
   • 小版本升级可直接替换二进制文件
   • 大版本升级需先停止服务，备份数据目录后升级
3. 监控集成：
   • 推荐使用Prometheus + JMX Exporter方案
   • 关键监控指标：zk_server_state, zk_outstanding_requests, zk_followers

七、进阶操作指南

7.1 动态配置（3.5+特性）

1. 启用动态配置：

   # 在zoo.cfg中添加
   dynamicConfigFile=/opt/zookeeper/conf/zoo.cfg.dynamic

2. 添加服务器节点（需重启生效）：

   echo "server.1=localhost3888;2181" >> /opt/zookeeper/conf/zoo.cfg.dynamic

7.2 CLI高级用法

1. 批量操作脚本：

   # 创建多个znode
   for i in {1..10}; do echo "create /test_node_$i data_$i" | zkCli.sh -server localhost:2181; done

2. ACL管理示例：

   # 添加digest认证
   echo "addauth digest user:password" | zkCli.sh -server localhost:2181
   echo "create /secure_node data authpassword:cdrwa" | zkCli.sh -server localhost:2181

通过以上详细步骤，开发者可在CentOS环境下快速构建稳定的ZooKeeper单机服务。建议在实际生产环境中结合监控系统和定期维护计划，确保服务的持续可用性。对于高可用场景，可进一步扩展为集群部署模式。