> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/zh/system-administration/removing-a-node-from-cluster.md).

# 从 VergeOS 集群中移除节点

## 概述

本指南介绍如何从 VergeOS 系统中移除物理节点的流程。此过程适用于硬件退役、集群缩容或节点替换等场景。

{% hint style="warning" %}
**重要限制**

只能在 **最后一个节点** 上执行节点移除。节点必须按相反顺序移除（最后添加，最先移除）。
{% endhint %}

## 前提条件

在移除节点之前，请确保以下事项：

* **vSAN 健康状态**：所有 vSAN 层都必须健康（绿色状态）
* **集群大小**：移除后，集群中必须至少保留两个节点
* **最近的快照**：建议在继续之前创建当前系统快照
* **备份访问**：验证是否可访问 IPMI 或控制台以进行故障排查

## 移除流程

### 步骤 1：启用维护模式

1. 导航到 **系统** > **节点**.
2. 双击 **最后一个节点** 中。
3. 点击 **启用维护** 左侧菜单中的。
4. 点击 **是** 以确认。
5. 等待所有工作负载从该节点迁移出去。监控 **运行中的机器** 部分，直到其为空。

{% hint style="info" %}
**不可迁移的工作负载**

对于使用 GPU 直通或主机 CPU 类型的虚拟机，必须先手动关机，然后节点才能进入维护模式。
{% endhint %}

### 步骤 2：使驱动器下线并删除

在关闭节点电源之前，必须先将所有驱动器从 vSAN 中移除。

1. 从节点仪表板中，点击 **驱动器** 左侧菜单中的。
2. 选择该节点列出的所有驱动器。
3. 点击 **下线** ，位于操作菜单中。
4. 点击 **是** 以确认。
5. 等待所有驱动器显示 **下线** 状态。
6. 在仍然选中所有驱动器的情况下，点击 **删除** ，位于操作菜单中。
7. 点击 **是** 以确认删除。

{% hint style="warning" %}
**等待数据迁移**

删除驱动器后，vSAN 会将数据迁移到剩余驱动器。请监控 vSAN 仪表板，并等待修复完成后再执行下一步。
{% endhint %}

### 步骤 3：关闭节点电源

{% hint style="danger" %}
**继续前验证 vSAN 健康状态**

在关闭节点电源之前，进入 **基础架构** > **vSAN 层** 并确认所有层均为 **绿色** （健康）。在 vSAN 完全从步骤 2 的驱动器移除中恢复之前，请勿继续操作。
{% endhint %}

1. 一旦所有驱动器都被删除且节点状态显示为 **维护模式**，点击 **关闭电源** 左侧菜单中的。
2. 点击 **是** 以确认。
3. 等待节点完全关机。

### 步骤 4：删除节点

1. 在节点关机后，点击 **删除** 左侧菜单中的。
2. 点击 **是** 以确认删除。

### 步骤 5：等待最终修复

节点删除后，vSAN 将在其余节点之间执行最终的数据重新分布。

1. 导航到 **系统** > **vSAN** 以监控修复进度。
2. 等待所有层恢复为 **绿色** （健康）状态后，再执行任何其他操作。

{% hint style="danger" %}
**不要中断修复**

在 vSAN 修复进行期间，不要关闭电源、重启或移除其他节点。请让修复完全完成。
{% endhint %}

## 移除后验证

修复完成后：

* 确认所有 vSAN 层均显示绿色状态
* 确认集群资源在剩余节点之间均衡分布
* 检查系统日志中是否有任何警告或错误

## 其他资源

* [维护模式](/run-the-platform/operations/maintenance-mode.md)
* [节点概览](/run-the-platform/system-administration/nodes-overview.md)
* [集群概览](/run-the-platform/system-administration/clusters-overview.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/zh/system-administration/removing-a-node-from-cluster.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.