服务注册与分布式协调 / 系统课时
单机模式配置
单机模式配置
单机模式适合本地学习和功能验证。本节会建立可写的数据目录,配置客户端端口与 tickTime,再启动 ZooKeeper 并确认服务以 standalone 模式运行。
学习目标
- 能写出最小可用的
zoo.cfg,理解dataDir、clientPort与tickTime的职责 - 能启动单机 ZooKeeper,并通过官方脚本确认运行模式
- 能识别目录权限、端口占用和配置文件缺失这三类常见启动问题
准备数据目录与配置文件
ZooKeeper 默认由 bin/zkServer.sh 读取 conf/zoo.cfg。单机模式不需要配置 server.1 等成员列表;最小配置只需准备时间基准、数据目录和客户端端口。dataDir 必须是 ZooKeeper 进程可写的目录,正式环境还应放在持久化磁盘上。
先把 <PATH> 替换为 ZooKeeper 安装目录;本地实验把数据放在其 zk-data 子目录:
cd <PATH>
mkdir -p <PATH>/zk-data
cat > conf/zoo.cfg <<'EOF'
tickTime=2000
dataDir=<PATH>/zk-data
clientPort=2181
EOF
grep -E '^(tickTime|dataDir|clientPort)=' conf/zoo.cfg预期输出
tickTime=2000
dataDir=<PATH>/zk-data
clientPort=2181tickTime 的单位是毫秒,它是 ZooKeeper 内部超时计算的基础时间单位。这里设为 2000 ms 足以用于常规实验。initLimit 和 syncLimit 主要约束集群成员之间的初始化与同步,单机模式不依赖它们,因此不必为了“配置完整”而额外添加。
启动并验证单机服务
配置完成后,用官方脚本启动服务,再查询状态。status 会读取同一份配置并连接客户端端口,因此既能检查进程是否存在,也能验证服务是否真正响应。
bin/zkServer.sh start
bin/zkServer.sh status预期结果(关键行)
Starting zookeeper ... STARTED
Mode: standalone不同 ZooKeeper 版本可能额外输出 JMX、配置文件路径或客户端地址,因此中间行会有差异;关键验收信号是启动结果为 STARTED,状态中出现 Mode: standalone。
处理启动失败
如果脚本没有进入 STARTED,先按“配置、目录、端口”的顺序排查。配置文件缺失或语法错误时,日志通常会直接指出 zoo.cfg 或具体参数;dataDir 不可写会导致快照、事务日志或 PID 文件创建失败;2181 被占用则会在绑定客户端端口时失败。
可以先做三项快速检查:
test -f conf/zoo.cfg && echo "config ok"
test -w <PATH>/zk-data && echo "dataDir writable"
ss -ltn | grep ':2181 ' || echo "2181 is free"预期输出
config ok
dataDir writable
2181 is free如果第三行显示的是监听记录而不是 2181 is free,说明已有进程占用了该端口,应停止冲突进程或修改 clientPort。完成修正后重新执行 bin/zkServer.sh start 和 bin/zkServer.sh status,直到状态明确为 standalone。