elasticsearch-node 离线救援工具

根据你的问题，elasticsearch-node 是 Elasticsearch 自 7.0 版本后提供的一个命令行工具，主要用于在节点无法正常启动或需要进行灾难恢复时，直接操作节点磁盘上的数据。它属于“最后手段”的离线救援工具。

核心子命令与用途

该工具包含多个子命令，下表汇总了其核心功能：

 

子命令	主要参数/用途	核心作用与典型场景
detach-cluster	--clear-trimming	剥离集群身份。当一个节点与集群失去联系且无法恢复，或集群元数据损坏时，此命令会清除节点上旧的集群元数据，使其可以作为一个“新节点”启动并加入另一个集群。这是你之前提到的场景。
repurpose	无	重新设定节点用途。当你想彻底改变一个节点的角色（例如，将一个数据节点改造成仅作为主节点），而节点因存有旧角色的数据而拒绝启动时，此命令会安全地删除这些不匹配的数据（如分片数据），以便节点能以新角色启动。
remove-customs	无	移除自定义元数据。删除插件写入的、可能阻止节点启动的自定义元数据。
unsafe-bootstrap	无	不安全地自举主节点。在多数主节点永久丢失的极端情况下，强制指定一个存活节点成为新的主节点，以尝试恢复集群。此操作极可能导致数据丢失。
remove-settings	无	强制移除配置。从磁盘上的集群状态中删除指定的持久化设置。

重要说明与使用警告

这些命令设计用于处理无法通过常规API操作解决的严重问题，使用时必须格外谨慎：

1. 离线操作：执行任何 elasticsearch-node 命令前，必须完全停止目标节点的Elasticsearch进程。

2. 数据风险：上述操作（尤其是 detach-cluster 和 unsafe-bootstrap）可能导致数据不一致或丢失，应作为最后手段。

3. 备份为先：在操作前，务必备份节点数据目录（path.data）下的所有内容。

4. 获取帮助：你可以直接在命令行中运行 $ES_HOME/bin/elasticsearch-node -h 来查看所有子命令及其简要说明。

如果你能详细说明你遇到的具体问题场景（例如，是节点无法启动，还是想将节点加入新集群），我可以为你提供更具针对性的操作思路。