Apache ZooKeeper™ 版本

Apache ZooKeeper 分布式协调系统是一项高性能服务，用于构建分布式应用程序。

版本策略

Apache ZooKeeper 社区一次支持两个版本分支：稳定版和当前版。ZooKeeper 的稳定版是 3.8.x，当前版是 3.9.x。一旦发布新的次要版本，稳定版预计很快将被废弃，并在大约半年后宣布终止生命周期。在半年的宽限期内，预计只会为该版本发布安全和关键修复程序。在宣布终止生命周期后，社区将不再提供任何补丁程序。所有 ZooKeeper 版本都将继续在官方 Apache 存档中提供。

下载

Apache ZooKeeper 3.9.2 是我们的当前版本，3.8.4 是我们的最新稳定版本。

Apache ZooKeeper 3.9.2

Apache ZooKeeper 3.9.2(asc, sha512)

Apache ZooKeeper 3.9.2 源代码版本(asc, sha512)

Apache ZooKeeper 3.8.4（最新稳定版本）

Apache ZooKeeper 3.8.4(asc, sha512)

Apache ZooKeeper 3.8.4 源代码版本(asc, sha512)

Apache ZooKeeper 3.7.2

Apache ZooKeeper 3.7.2(asc, sha512)

Apache ZooKeeper 3.7.2 源代码版本(asc, sha512)

Apache ZooKeeper 3.6.4（3.6 已于 2022 年 12 月 30 日终止生命周期）

Apache ZooKeeper 3.6.4(asc, sha512)

Apache ZooKeeper 3.6.4 源代码版本(asc, sha512)

较早的版本可在 存档 中获得。

验证哈希值和签名

你可以使用版本签名 KEYS 来验证下载的版本完整性。有关其他信息，请参阅 Apache 文档以 验证 Apache 项目版本的完整性。

新闻

2024 年 3 月 12 日：发布 3.9.2 版本

这是 3.9 分支的错误修复版本。

有关详细信息，请参阅 ZooKeeper 3.9.2 发行说明。

2024 年 3 月 5 日：发布 3.8.4 版本

这是 3.8 分支的错误修复版本。

有关详细信息，请参阅 ZooKeeper 3.8.4 发行说明。

2023 年 10 月 9 日：发布 3.9.1 版本

这是 3.9 分支的错误修复版本。

有关详细信息，请参阅 ZooKeeper 3.9.1 发行说明。

2023 年 10 月 9 日：发布 3.8.3 版本

这是 3.8 分支的错误修复版本。

有关详细信息，请参阅 ZooKeeper 3.8.3 发行说明。

2023 年 10 月 9 日：发布 3.7.2 版本

这是 3.7 分支的错误修复版本。

有关详细信息，请参阅 ZooKeeper 3.7.2 发行说明。

2023 年 8 月 3 日：发布 3.9.0 版本

这是 3.9 分支的第一个版本。
这是一个主要版本，它引入了许多新功能，最值得注意的是

3.5.x 及更高版本的 ZooKeeper 客户端与 3.9.x 服务器完全兼容。
从 3.7.x 和 3.8.x 升级可以照常执行，无需任何特殊的附加升级过程。
只要您不使用这些版本中不存在的新 API，ZooKeeper 3.9.x 客户端与 3.5.x、3.6.x、3.7.x 和 3.8.x 服务器兼容。

有关详细信息，请参见ZooKeeper 3.9.0 发行说明。

ZooKeeper 的最新稳定版本现为 3.8.2。

2023 年 7 月 18 日：发布 3.8.2 版本

这是 3.8 分支的错误修复版本。

有关详细信息，请参见ZooKeeper 3.8.2 发行说明。

2023 年 1 月 30 日：发布 3.8.1 版本

这是 3.8 分支的错误修复版本。

有关详细信息，请参见ZooKeeper 3.8.1 发行说明。

2022 年 12 月 30 日：发布 3.6.4 版本

这是 3.6 分支的最后一个错误修复版本，因为 3.6 自 2022 年 12 月 30 日起已达到生命周期终点。
它修复了 42 个问题，包括 CVE 修复、log4j1 删除（从现在开始使用 reload4j）
以及其他各种错误修复（例如快照、SASL 和 C 客户端相关修复）。

有关详细信息，请参见ZooKeeper 3.6.4 发行说明。

2022 年 12 月 30 日：Apache ZooKeeper 3.6 生命周期终点

Apache ZooKeeper 社区谨此正式宣布 3.6 发行版生命周期终点。它将于 2022 年 12 月 30 日凌晨 00:01（太平洋时间）生效。从那天起，Apache ZooKeeper 的 3.6 版本将不再受到社区支持，这意味着我们不会

Apache ZooKeeper 3.6 的最新发布版本（目前为 3.6.4）将在下载页面上再提供一年（直到 2023 年 12 月 30 日），之后它将从 Apache Archives 中的其他历史版本中访问。

=== 升级 ===

我们建议 Apache ZooKeeper 3.6 的用户根据以下受支持的升级路径规划您的生产升级

1) 升级到最新的 3.7.x 版本
2) 升级到最新的 3.8.x 版本
3)（可选）升级到最新的 3.9.x 版本。

请在以下 wiki 页面上找到已知的升级问题和解决方法：升级常见问题解答

此外，user@ 邮件列表全天候开放，以帮助和解答您的问题，如常。

=== 兼容性 ===

我们的向后兼容性规则仍然适用，可以在此处找到：向后兼容性规则

按照推荐的升级路径进行滚动升级过程，只要客户端不开始使用新功能，ZooKeeper 仲裁组将始终可用。

2022 年 6 月 4 日：发布 3.5.10

这是 3.5 分支的最后一个错误修复版本，因为 3.5 自 2022 年 6 月 1 日起已结束生命周期。
它修复了 44 个问题，包括 CVE 修复、log4j1 删除（从现在开始使用 reload4j）
以及其他各种错误修复（线程泄漏、数据损坏、快照和 SASL 相关修复）。

有关详细信息，请参阅ZooKeeper 3.5.10 发行说明。

2022 年 6 月 1 日：Apache ZooKeeper 3.5 生命周期结束

Apache ZooKeeper 社区谨此正式宣布 3.5 版本的生命周期结束。它将于 2022 年 6 月 1 日 00:01 AM（太平洋夏令时间）生效。从那天起，Apache ZooKeeper 的 3.5 版本将不再得到社区的支持，这意味着我们不会

Apache ZooKeeper 3.5 的最新发布版本（目前为 3.5.9）将在下载页面上再提供一年（直到 2023 年 6 月 1 日），之后它将从 Apache Archives 中的其他历史版本中访问。

=== 升级 ===

我们建议 Apache ZooKeeper 3.5 的用户根据以下受支持的升级路径规划您的生产升级

1) 升级到最新的 3.5.x 版本
2) 升级到最新的 3.6.x 版本
3)（可选）升级到最新的 3.7.x 版本。

请在以下 wiki 页面上找到已知的升级问题和解决方法：升级常见问题解答

此外，user@ 邮件列表全天候开放，以帮助和解答您的问题，如常。

=== 兼容性 ===

我们的向后兼容性规则仍然适用，可以在此处找到：向后兼容性规则

按照推荐的升级路径进行滚动升级过程，只要客户端不开始使用新功能，ZooKeeper 仲裁组将始终可用。

2022 年 5 月 12 日：发布 3.7.1 版本

这是 3.7 分支的错误修复版本。
修复了 64 个问题，包括多个 CVE 修复。

有关详细信息，请参阅 ZooKeeper 3.7.1 发行说明。

2022 年 3 月 7 日：发布 3.8.0 版本

这是 3.8 分支的第一个版本。
这是一个主要版本，它引入了许多新功能，最值得注意的是

3.5.x 及更高版本的 ZooKeeper 客户端与 3.8.x 服务器完全兼容。
从 3.6.x 和 3.7.x 升级可以照常执行，无需任何特殊的附加升级过程。
只要您不使用这些版本中不存在的新 API，ZooKeeper 3.8.x 客户端就与 3.5.x、3.6.x 和 3.7.x 服务器兼容。

有关详细信息，请参阅 ZooKeeper 3.8.0 发行说明。

2021 年 4 月 13 日：发布 3.6.3 版本

这是 3.6 分支的错误修复版本。
修复了 52 个问题，包括多个 CVE 修复。

有关详细信息，请参阅 ZooKeeper 3.6.3 发行说明。

2021 年 3 月 27 日：发布 3.7.0 版本

这是 3.7 分支的第一个版本。
它引入了一些新特性，特别是

来自 3.5 和 3.6 分支的 ZooKeeper 客户端与 3.7 服务器完全兼容。
从 3.6.x 升级到 3.7.0 可以像往常一样执行，不需要任何特殊的附加升级过程。
只要您不使用这些版本中不存在的新 API，ZooKeeper 3.7.0 客户端就与 3.5 和 3.6 服务器兼容。

有关详细信息，请参见 ZooKeeper 3.7.0 发行说明。

2021 年 1 月 15 日：发布 3.5.9

这是 3.5 分支的一个 bug 修复版本。
它修复了 25 个问题，包括多个 CVE 修复。

有关详细信息，请参见 ZooKeeper 3.5.9 发行说明。

2020 年 9 月 9 日：发布 3.6.2

这是 3.6 分支的错误修复版本。
这是一个小版本，修复了一些关键问题并带来了一些依赖项升级。

有关详细信息，请参见 ZooKeeper 3.6.2 发行说明。

2020 年 5 月 11 日：发布 3.5.8

这是 3.5 分支的一个 bug 修复版本。
它修复了 24 个问题，包括第三方 CVE 修复、几个与领导者选举相关的修复以及与针对较早的 3.5 客户端库构建的应用程序的兼容性问题（通过恢复一些非公共 API）。

有关详细信息，请参见 ZooKeeper 3.5.8 发行说明。

2020 年 4 月 30 日：发布 3.6.1

这是 3.6 分支的第二个版本。
这是一个 bug 修复版本，修复了与为 ZooKeeper 3.5 构建的应用程序的一些兼容性问题。从 3.5.7 升级到 3.6.1 可以像往常一样执行，不需要任何特殊的附加升级过程。只要您不使用 3.5 中不存在的新 API，ZooKeeper 3.6.1 客户端就与 3.5 服务器兼容。

有关详细信息，请参见 ZooKeeper 3.6.1 发行说明。

2020 年 3 月 4 日：发布 3.6.0

这是 3.6 分支的第一个版本。
它带来了许多新功能和性能和安全方面的改进。它还在客户端引入了新的 API。
来自 3.4 和 3.5 分支的 ZooKeeper 客户端与 3.6 服务器完全兼容。从 3.5.7 升级到 3.6.0 可以像往常一样执行，不需要任何特殊的附加升级过程。只要您不使用 3.5 中不存在的新 API，ZooKeeper 3.6.0 客户端就与 3.5 服务器兼容。

有关详细信息，请参见 ZooKeeper 3.6.0 发行说明。

2020 年 2 月 14 日：发布 3.5.7 版本

这是 3.5 分支的一个 bug 修复版本。
它修复了 25 个问题，包括第三方 CVE 修复、潜在数据丢失和在某些罕见条件下可能出现的分脑问题。

有关详细信息，请参阅 ZooKeeper 3.5.7 发行说明。

2019 年 10 月 19 日：发布 3.5.6 版本

这是 3.5 分支的一个 bug 修复版本。
它修复了 29 个问题，包括 CVE 修复、主机名解析问题和可能的内存泄漏。

有关详细信息，请参阅 ZooKeeper 3.5.6 发行说明。

2019 年 5 月 20 日：发布 3.5.5 版本

3.5 分支的第一个稳定版本。此版本被认为是 3.4 稳定分支的继任者，建议用于生产用途。
它包含 950 次提交，解决了 744 个问题，修复了 470 个错误，并包括以下新功能

各种性能和稳定性改进。

另请注意

感谢贡献者为实现此版本所做的巨大努力。

有关详细信息，请参阅 ZooKeeper 3.5.5 发行说明。

2019 年 4 月 2 日：发布 3.4.14 版本

这是一个错误修复版本。它修复了 8 个问题，主要是构建/单元测试问题、OWASP 标记的依赖项更新、NPE 和名称解析问题。其中，它还支持实验性 Maven 构建和基于 Markdown 的文档生成。有关详细信息，请参阅 ZooKeeper 3.4.14 发行说明。

2018 年 7 月 15 日：发布 3.4.13 版本

这是一个错误修复版本。它修复了 17 个问题，包括可能在使用观察者时导致数据丢失的 ZOOKEEPER-2959 问题，以及阻止 ZooKeeper Java 客户端在动态 IP（容器/云）环境中工作的 ZOOKEEPER-2184 问题。有关详细信息，请参阅 ZooKeeper 3.4.13 发行说明。

2018 年 5 月 17 日：发布 3.5.4-beta 版本

3.5.4-beta 是计划的 3.5 发行版系列中的第二个 beta 版本，将发布一个稳定的 3.5 版本。它包含 113 个错误修复和改进。

版本 3.5.3 添加了新功能 ZOOKEEPER-2169 “启用创建具有 TTL 的节点”。在实现 TTL 节点时出现了一个重大疏忽。每个服务器的会话 ID 生成器使用高字节中的已配置服务器 ID 播种。TTL 节点在临时所有者中使用时使用最高位表示 TTL 节点。这意味着创建临时节点的服务器 ID > 127 将始终将这些节点视为 TTL 节点（TTL 基本上是一个随机数）。ZOOKEEPER-2901 修复了此问题。默认情况下，TTL 已禁用，现在必须在 zoo.cfg 中启用。当启用 TTL 节点时，最大服务器 ID 从 255 更改为 254。有关更多详细信息，请参阅管理员指南（或引用的 JIRA）中的 TTL 文档。

2018 年 5 月 1 日：发布版本 3.4.12

此版本修复了 22 个问题，包括影响 dataDir 和 dataLogDir 处理不当的问题。有关详细信息，请参阅 ZooKeeper 3.4.12 发行说明。

2017 年 11 月 9 日：发布版本 3.4.11

此版本修复了 53 个问题，包括对 Java 9 的支持和其他关键错误修复。有关详细信息，请参阅 ZooKeeper 3.4.11 发行说明。

警告：最近发现 ZOOKEEPER-2960 是 3.4.11 中的回归，影响了单独的 dataDir 和 dataLogDir 配置参数的规范（与默认值不同，默认值是这两个参数的单个目录）。它将在 3.4.12 中解决。

2017 年 4 月 17 日：发布版本 3.5.3-beta

3.5.3-beta 是计划中的 3.5 发行版本中的第一个 beta，将发布一个稳定的 3.5 版本。它包含 76 个错误修复和改进。此版本包括围绕动态重新配置 API 的重要安全修复、对测试基础设施的改进以及 TTL 节点等新功能。

2017 年 3 月 30 日：发布版本 3.4.10

此版本修复了 43 个问题，包括通过 SASL 进行 QuorumPeer 相互身份验证的安全功能和其他关键错误。有关详细信息，请参阅 ZooKeeper 3.4.10 发行说明。

2016 年 9 月 3 日：发布版本 3.4.9

此版本修复了许多关键错误并进行了改进。有关详细信息，请参阅 ZooKeeper 3.4.9 发行说明。

2016 年 7 月 20 日：发布 3.5.2-alpha

这是一个 alpha 质量版本，包含许多错误修复和改进。

2016 年 2 月 20 日：发布 3.4.8

此版本修复了 9 个问题，最值得注意的是关闭 ZooKeeper 时发生的死锁。有关详细信息，请参阅ZooKeeper 3.4.8 发行说明。

2015 年 8 月 31 日：发布 3.5.1-alpha

这是一个 alpha 质量版本，包含许多错误修复和改进。它还引入了几个新功能，包括容器 znode 和客户端-服务器通信的 SSL 支持。

有关详细信息，请参阅ZooKeeper 3.5.1-alpha 发行说明。

2014 年 8 月 6 日：发布 3.5.0-alpha

此版本为 alpha 质量，包含许多改进、新功能、错误修复和优化。

有关详细信息，请参阅ZooKeeper 3.5.0-alpha 发行说明。或者，您可以在Jira 中查看所有版本的 issue 日志。

2014 年 3 月 10 日：发布 3.4.6

此版本修复了一个严重错误，该错误可能阻止服务器加入已建立的 ensemble。有关详细信息，请参阅ZooKeeper 3.4.6 发行说明。

2012 年 11 月 18 日：发布 3.4.5

此版本修复了一个严重错误，该错误可能导致客户端连接问题。有关详细信息，请参阅ZooKeeper 3.4.5 发行说明。

2012 年 9 月 23 日：发布 3.4.4

此版本修复了一个严重错误，该错误可能导致数据不一致。有关详细信息，请参阅ZooKeeper 3.4.4 发行说明。

2012 年 8 月 2 日：发布 3.3.6

此版本修复了一个严重错误，该错误可能导致数据丢失。有关详细信息，请参阅ZooKeeper 3.3.6 发行说明。

2012 年 3 月 20 日：发布 3.3.5

此版本修复了一个严重错误，该错误可能导致数据损坏。有关详细信息，请参阅ZooKeeper 3.3.5 发行说明。

2012 年 2 月 13 日：发布 3.4.3

此版本修复了 3.4.2 中的严重错误。有关详细信息，请参阅ZooKeeper 3.4.3 发行说明。

鉴于我们对 3.4 分支进行了许多错误修复，并且 3.4 版本已经发布了一段时间，我们现在将此版本升级为 beta 版本。

2011 年 12 月 29 日：发布 3.4.2

此版本修复了 3.4.1 中的一个严重错误。有关详细信息，请参见 ZooKeeper 3.4.2 发行说明。

请注意，此版本仍为 alpha 版本，我们不建议将其用于生产环境。请使用稳定版本 3.3.* 用于生产环境。

2011 年 12 月 16 日：发布 3.4.1

此版本修复了 3.4.0 中导致数据丢失的一个严重错误。有关详细信息，请参见 ZooKeeper 3.4.1 发行说明。如果您已经在使用 3.4.0 版本，请尽快升级。

请注意，此版本为 alpha 版本，目前尚未准备好用于生产环境。

2011 年 11 月 26 日：发布 3.3.4

此版本修复了可能导致数据损坏的若干严重错误。有关详细信息，请参见 ZooKeeper 3.3.4 发行说明。

2011 年 11 月 22 日：发布 3.4.0

由于数据丢失问题，此版本已从下载页面中删除。现在已发布 3.4.1 版本。

2011 年 2 月 27 日：发布 3.3.3

此版本修复了可能导致数据损坏的两个严重错误。它还解决了其他 12 个问题。有关详细信息，请参见 ZooKeeper 3.3.3 发行说明。

2010 年 11 月 11 日：发布 3.3.2

此版本包含若干严重错误修复。

有关详细信息，请参见 ZooKeeper 3.3.2 发行说明。或者，您也可以查看 Jira 中所有版本的错误日志。

2010 年 5 月 17 日：发布 3.3.1

此版本包含若干严重错误修复。

有关详细信息，请参见 ZooKeeper 3.3.1 发行说明。或者，您也可以查看 Jira 中所有版本的错误日志。

2010 年 3 月 25 日：发布 3.3.0

此版本包含许多改进、新功能、错误修复和优化。

有关详细信息，请参见 ZooKeeper 3.3.0 发行说明。或者，您也可以查看 Jira 中所有版本的错误日志。

2009 年 12 月 14 日：发布 3.2.2

此版本包含若干严重错误修复。

有关详细信息，请参见 ZooKeeper 3.2.2 发行说明。或者，您也可以查看 Jira 中所有版本的错误日志。

2009 年 12 月 14 日：发布 3.1.2

此版本包含若干严重错误修复。

有关详细信息，请参阅 ZooKeeper 3.1.2 发行说明。或者，您可以查看 Jira 问题日志以了解所有发行版。

2009 年 9 月 4 日：发行版 3.2.1 可用

此版本包含若干严重错误修复。

有关详细信息，请参阅 ZooKeeper 3.2.1 发行说明。或者，您可以查看 Jira 问题日志以了解所有发行版。

2009 年 7 月 8 日：发行版 3.2.0 可用

此版本包含许多改进、新功能、错误修复和优化。

有关详细信息，请参阅 ZooKeeper 3.2.0 发行说明。或者，您可以查看 Jira 问题日志以了解所有发行版。

2009 年 3 月 27 日：发行版 3.1.1 可用

此发行版包含少量错误修复。

有关详细信息，请参阅 ZooKeeper 3.1.1 发行说明。或者，您可以查看 Jira 问题日志以了解所有发行版。

2009 年 2 月 13 日：发行版 3.1.0 可用

此版本包含许多改进、新功能、错误修复和优化。

有关详细信息，请参阅 ZooKeeper 3.1.0 发行说明。或者，您可以查看 Jira 问题日志以了解所有发行版。

2008 年 12 月 4 日：发行版 3.0.1 可用

此版本包含许多改进、新功能、错误修复和优化。

有关详细信息，请参阅 ZooKeeper 3.0.1 发行说明。或者，您可以查看 Jira 问题日志以了解所有发行版。

2008 年 10 月 27 日：发行版 3.0.0 可用

此版本包含许多改进、新功能、错误修复和优化。

有关详细信息，请参阅 ZooKeeper 3.0.0 发行说明。或者，您可以查看 Jira 问题日志以了解所有发行版。