一、环境准备与依赖安装

1.1 系统版本选择与基础配置

推荐使用CentOS 7.9或CentOS 8.5 LTS版本，这两个版本在长期支持性和软件包兼容性上表现优异。部署前需完成以下基础配置：

# 关闭SELinux（临时生效）
sudo setenforce 0
# 永久关闭需修改配置文件
sudo sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config
# 配置防火墙放行2181端口（ZooKeeper默认端口）
sudo firewall-cmd --zone=public --add-port=2181/tcp --permanent
sudo firewall-cmd --reload

对于内存资源有限的测试环境，建议通过free -h确认可用内存，ZooKeeper单机运行建议至少保留2GB可用内存。

1.2 Java环境部署

ZooKeeper 3.7+版本要求Java 8或更高版本，推荐使用OpenJDK：

# 安装OpenJDK 11
sudo yum install -y java-11-openjdk-devel
# 验证安装
java -version
# 设置JAVA_HOME环境变量
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk' >> ~/.bashrc
source ~/.bashrc

对于生产环境，建议通过jstat -gcutil <pid>监控JVM内存使用情况，初始堆内存建议设置为物理内存的1/4。

二、ZooKeeper安装与配置

2.1 软件包获取与安装

从Apache官方仓库获取稳定版：

wget https://dlcdn.apache.org/zookeeper/zookeeper-3.8.1/apache-zookeeper-3.8.1-bin.tar.gz
tar -zxvf apache-zookeeper-3.8.1-bin.tar.gz -C /opt/
ln -s /opt/apache-zookeeper-3.8.1-bin /opt/zookeeper

创建专用用户组提升安全性：

sudo groupadd zkgroup
sudo useradd -g zkgroup -d /var/lib/zookeeper -s /bin/false zkuser
sudo chown -R zkuser:zkgroup /opt/zookeeper

2.2 核心配置文件解析

编辑/opt/zookeeper/conf/zoo.cfg：

# 基础配置项
tickTime=2000
dataDir=/var/lib/zookeeper/data
dataLogDir=/var/lib/zookeeper/logs
clientPort=2181
# 单机模式特殊配置
initLimit=10
syncLimit=5

关键参数说明：

• tickTime：基础时间单元（毫秒），影响心跳检测间隔
• dataDir：存储快照和事务日志的目录，建议使用独立磁盘
• initLimit：Leader与Follower初始连接超时倍数（tickTime为单位）

创建必要目录结构：

sudo mkdir -p /var/lib/zookeeper/{data,logs}
sudo chown -R zkuser:zkgroup /var/lib/zookeeper
# 创建myid文件（单机模式固定为1）
echo "1" | sudo tee /var/lib/zookeeper/data/myid

三、服务启动与验证

3.1 系统服务管理

创建systemd服务文件/etc/systemd/system/zookeeper.service：

[Unit]
Description=ZooKeeper Service
After=network.target
[Service]
Type=forking
User=zkuser
Group=zkgroup
Environment="ZOO_LOG_DIR=/var/lib/zookeeper/logs"
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 start zookeeper
sudo systemctl enable zookeeper

3.2 连接验证与状态检查

使用客户端工具验证服务：

/opt/zookeeper/bin/zkCli.sh -server 127.0.0.1:2181
# 在客户端执行状态查询
[zk: 127.0.0.1:2181(CONNECTED) 0] stat /

关键验证点：

1. 通过netstat -tulnp | grep 2181确认端口监听状态
2. 检查日志文件/var/lib/zookeeper/logs/zookeeper.out是否有ERROR级别记录
3. 使用echo stat | nc 127.0.0.1 2181快速获取服务状态

四、运维管理与优化

4.1 日志轮转配置

创建日志轮转配置/etc/logrotate.d/zookeeper：

/var/lib/zookeeper/logs/zookeeper.log {
    daily
    rotate 7
    missingok
    notifempty
    compress
    copytruncate
}

4.2 性能监控指标

关键监控项：

• 连接数：echo stat | nc localhost 2181 | grep "Connections"
• 延迟：通过Four Letter Words命令echo mntr | nc localhost 2181获取
• 磁盘I/O：使用iostat -x 1监控dataDir所在磁盘

4.3 常见问题处理

1. 端口冲突：通过ss -tulnp | grep 2181确认占用进程
2. 权限问题：检查dataDir和dataLogDir的权限设置
3. 内存溢出：在zkEnv.sh中调整JVM参数：

   export SERVER_JVMFLAGS="-Xms1g -Xmx2g -XX:+UseG1GC"

五、升级与迁移指南

5.1 版本升级流程

1. 备份配置文件和数据目录
2. 停止服务：systemctl stop zookeeper
3. 安装新版本并验证配置兼容性
4. 启动服务并执行zkServer.sh status确认版本

5.2 数据迁移方案

对于需要迁移数据的场景：

# 停止服务后执行
rsync -avz /var/lib/zookeeper/data/ /new_path/data/
# 修改zoo.cfg中的dataDir路径
# 启动服务前确保目录权限正确

本指南完整覆盖了CentOS环境下ZooKeeper单机部署的全生命周期管理，通过标准化配置和自动化脚本可显著提升部署效率。实际生产环境中，建议结合Prometheus+Grafana构建可视化监控体系，定期执行zkCleanup.sh清理旧快照文件。对于内存敏感型应用，可通过调整maxClientCnxns参数控制最大连接数，优化资源利用率。