ZooKeeper 是一个分布式的、开放源码的分布式应用程序协调服务，它为分布式应用提供了高性能、高可用、且具有严格顺序访问控制能力的服务，在 ZooKeeper 的使用过程中，掌握其启动命令行是非常重要的，这涉及到服务的正常运行、配置调整以及问题排查等多个方面，ZooKeeper 的启动命令主要通过 zkServer.sh 脚本（在 Linux/Unix 环境下）或 zkServer.cmd 脚本（在 Windows 环境下）来执行，该脚本通常位于 ZooKeeper 的 bin 目录下。
要启动 ZooKeeper 服务，首先需要确保已经正确安装了 ZooKeeper，并且配置了必要的配置文件，主要是 zoo.cfg。zoo.cfg 文件定义了 ZooKeeper 的基本运行参数，如数据目录（dataDir）、日志目录（dataLogDir）、客户端端口（clientPort）、集群成员列表（如果是集群模式）等，在启动之前，需要确保 dataDir 指定的目录存在，并且在该目录下有一个名为 myid 的文件，该文件的内容对应于当前服务器在集群中的唯一 ID（一个数字）。
基本的启动命令非常简单，在 bin 目录下执行 ./zkServer.sh start（Linux/Unix）或 zkServer.cmd start（Windows）即可，在 Linux 系统中，ZooKeeper 安装在 /opt/zookeeper-3.7.0 目录下，那么进入 /opt/zookeeper-3.7.0/bin 目录后，执行 ./zkServer.sh start，脚本会读取默认的配置文件路径（通常是 conf/zoo.cfg）来启动服务，启动成功后，脚本会输出类似 "ZooKeeper JMX enabled by default" 以及 "Using config: /opt/zookeeper-3.7.0/bin/../conf/zoo.cfg" 以及 "Starting zookeeper ... STARTED" 的信息。
除了基本的启动命令，zkServer.sh 脚本还提供了其他常用的选项，以便在不同的场景下使用，可以通过 ./zkServer.sh 命令本身查看所有可用的选项,这些选项包括：
| 命令选项 | 描述 |
|---|---|
start |
启动 ZooKeeper 服务器进程。 |
stop |
停止 ZooKeeper 服务器进程。 |
restart |
重启 ZooKeeper 服务器进程（先停止再启动）。 |
status |
查看 ZooKeeper 服务器的当前状态，包括是否运行、模式（ standalone 或 cluster）以及运行时间等。 |
version |
显示 ZooKeeper 服务器的版本信息。 |
help |
显示帮助信息。 |
在实际运维中，有时可能需要指定非默认的配置文件路径，例如在测试环境或多个 ZooKeeper 实例部署在同一台机器上时，可以使用 config 选项来指定配置文件，启动命令可以写为 ./zkServer.sh start /path/to/custom/zoo.cfg，这种方式非常灵活，允许在不修改默认配置文件的情况下,使用不同的配置启动多个实例。
zkServer.sh 脚本还支持通过环境变量来配置一些关键参数，ZOOCFGDIR 可以指定配置文件所在的目录，ZOOCFG 可以指定配置文件的名称，可以通过设置 export ZOOCFG=my-zoo.cfg 来使用 conf/my-zoo.cfg 作为配置文件，然后执行 ./zkServer.sh start。
对于集群部署，启动命令本身与单机模式没有区别，关键在于 zoo.cfg 文件中的 server.N 配置项是否正确配置了集群中各个服务器的 IP 地址、选举端口和通信端口，每个服务器启动时，会根据其 myid 文件中的 ID 来加载对应的 server.N 配置，并与集群中的其他服务器进行通信,最终形成一个一致的集群。
在启动过程中，如果遇到问题，可以通过查看日志文件来排查，日志文件通常位于 dataLogDir 指定的目录下，默认文件名为 zookeeper.out，日志中会包含启动过程中的详细信息，如配置加载情况、端口绑定是否成功、集群成员的发现和连接状态等，如果 clientPort 被占用，日志中会提示 "Address already in use" 错误；myid 文件不存在或内容不正确，日志中会提示 "File does not exist" 或 "Invalid myid" 等错误。
ZooKeeper 的启动命令行虽然简单，但理解其背后的配置选项和环境变量对于高效管理和运维 ZooKeeper 集群至关重要，通过灵活运用 start、stop、status 等基本命令，并结合 config 选项和环境变量，可以满足各种复杂的部署和运行需求,熟练查看和分析日志是解决启动和运行中问题的关键技能。
相关问答FAQs
问题1：在启动 ZooKeeper 时，提示 "Error contacting service. It is probably not running."，可能的原因是什么？如何解决？
解答：这个错误通常表示客户端或管理工具无法连接到 ZooKeeper 服务器，可能的原因有：1. ZooKeeper 服务器进程未成功启动；2. 防火墙阻止了客户端访问 ZooKeeper 的 clientPort（默认为 2181）；3. clientPort 配置错误或被其他进程占用；4. 网络问题导致客户端无法到达服务器，解决方法：首先使用 ./zkServer.sh status 命令检查服务器进程状态，确认是否正在运行；如果未运行，检查 zoo.cfg 配置是否正确，特别是 dataDir 和 myid 文件；检查服务器防火墙设置，确保 clientPort 端口开放；使用 netstat -tuln | grep 2181（假设 clientPort 为 2181）检查端口是否被正确监听；检查网络连通性。
问题2：如何在不停止当前 ZooKeeper 服务的情况下，重新加载配置文件？
解答：ZooKeeper 本身不直接提供 "reload config" 的命令来动态加载新的 zoo.cfg 配置，大多数配置项（如 dataDir、clientPort、server.N 等）都需要在服务器重启后才能生效，对于某些动态配置项（如通过 addauth、create -e 等命令创建的临时节点或某些四字命令（four-letter commands）可以调整的参数），可以通过客户端连接后进行动态修改，但对于 zoo.cfg 文件本身的更改，标准的做法是重启 ZooKeeper 服务，在重启前，确保新的配置文件是正确的，以避免服务无法启动，如果希望平滑过渡,可以考虑在维护窗口期进行重启操作。
