解除绑定服务器
企业版

您可以使用 neo4j-admin server unbind 命令删除并归档集群服务器的集群状态，以便将其重新绑定到集群。

在任意数量的服务器上运行 unbind 命令可能会导致集群仲裁丢失，从而严重影响集群功能。因此，强烈建议在使用 unbind 命令之前咨询 Neo4j 支持团队。

仅在排查特定服务器故障时使用 unbind 命令，并请记住，分配器不保证会再次将相同的数据库分配给此服务器，这可能会导致出现孤立的数据库存储。

unbind 命令会保留服务器上的所有数据库存储；当解绑后的服务器重启时，它会被视为一台全新的服务器。因此，它不会承载操作前所承载的任何数据库。

在 2025.x 版本中，unbind 命令不能用于将集群成员转换为独立服务器。建议的做法是进行备份，创建独立服务器，然后使用这些备份来恢复数据库。

语法

neo4j-admin server unbind 命令具有以下语法

neo4j-admin server unbind [-h] [--expand-commands] [--verbose]
                          [--archive-cluster-state[=true|false]]
                          [--additional-config=<file>]
                          [--archive-path=<path>]

选项

neo4j-admin server unbind 命令具有以下选项

表 1. neo4j-admin server unbind 选项
选项 描述 默认

--additional-config=<file>[1]

包含额外配置的配置文件。

--archive-cluster-state[=true|false]

启用或禁用集群状态归档。

false

--archive-path=<path>

集群状态归档的目标位置（文件或文件夹）。

--expand-commands

允许在配置值评估中进行命令扩展。

-h, --help

显示此帮助消息并退出。

--verbose

启用详细输出。
1. 有关详细信息，请参阅 Neo4j Admin 和 Neo4j CLI → 配置。

限制

在运行 neo4j-admin server unbind 命令之前，必须关闭 Neo4j 服务器。

用法

您可以使用 neo4j-admin server unbind 命令删除或归档集群服务器的集群状态。

删除服务器的集群状态

要删除服务器的集群状态，请在该服务器的 <NEO4J_HOME> 文件夹中运行 neo4j-admin server unbind 命令。重新启动后，解绑的服务器将作为新服务器重新加入集群，并必须使用 ENABLE SERVER 命令进行启用。

归档集群状态

如果出现问题需要调试，您可以归档集群状态。在 <NEO4J_HOME> 文件夹中，运行带有 --archive-cluster-state=true 和 --archive-path=<destination-folder> 参数的 neo4j-admin server unbind 命令。

bin/neo4j-admin server unbind --archive-path=/path/to/archive-folder --archive-cluster-state=true

默认生成的文件命名为

unbound_cluster_state.<YYYYMMDDHH24MM>.zip