> 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/proper-vergeos-system-shutdown-procedure.md).

# VergeOS 系统正确关机流程

## 概述

本文档提供了正确关闭 VergeOS 系统的分步操作流程。遵循正确的关机顺序至关重要，可确保数据完整性、防止损坏，并维护您的 VergeOS 环境健康。

## 前提条件

* 对 VergeOS UI 的管理访问权限
* 了解您的集群拓扑
* 识别所有正在运行的工作负载和租户
* 了解控制器节点位置（Node1 和 Node2）

## 关机顺序

### 第 1 步：清点正在运行的工作负载

在开始关机流程之前，您必须识别环境中的所有活动工作负载。

1. 导航到每个 **节点仪表板** 在您的集群中
2. 查看 **运行中的机器** 每个节点上的部分
3. 记录所有正在运行的工作负载，包括：
   * 虚拟机（VM）
   * 租户节点
   * VMware 备份服务
   * NAS 服务
   * 任何其他活动服务

### 第 2 步：关闭租户工作负载

如果租户正在集群中的任何节点上运行：

1. **登录每个租户环境** 其中有活动工作负载
2. **平稳关闭所有正在运行的工作负载** 在每个租户内
3. **验证关机完成情况** 然后再继续下一步

{% hint style="warning" %}
**重要提示**

在继续之前，确保所有租户工作负载都已正确关闭。否则可能导致数据丢失或损坏。
{% endhint %}

### 第 3 步：关闭主机级工作负载

在所有租户工作负载关闭后，关闭每个节点上其余所有工作负载的电源：

1. **虚拟机（VM）**：尽可能使用平稳关机选项
2. **租户节点**：确保在其内部工作负载关闭后再将其断电
3. **VMware 备份服务**：停止任何活动的备份操作
4. **NAS 服务**：安全地停止所有与 NAS 相关的服务
5. **其他服务**：关闭任何剩余的活动服务电源

{% hint style="info" %}
**vNet 容器**

vNet 容器无需手动停止。它们将在集群关机过程中自动平稳停止。
{% endhint %}

### 第 4 步：关闭单个节点

一旦所有工作负载都停止后：

1. 导航到 **集群仪表板** 针对您希望关闭电源的集群
2. 选择 **关闭电源** 从左侧菜单中
3. 系统将开始关闭集群中的每个节点
4. **监控关机进度** 通过集群仪表板

### 第 5 步：关闭整个集群

在单个节点关闭后：

1. 导航到 **系统 → 集群**
2. 选择您要关闭的集群
3. 选择 **关闭电源** 从左侧菜单中
4. 在提示时确认关机

## 多集群环境注意事项

{% hint style="danger" %}
**重要警告**

如果您的环境包含 **多个集群**，您必须 **始终** 最后关闭包含控制器节点（Node1 和 Node2）的集群 **最后**.
{% endhint %}

### 多集群环境的关机顺序：

1. 先关闭所有 **非控制器集群** ，
2. 关闭 **控制器集群** （包含 Node1 和 Node2）最后

这样可确保在所有其他集群都安全关闭之前，集群协调和管理服务仍然可用。

## 替代方法：通过 API 关机

对于高级用户或自动化场景，您可以使用 VergeOS API 来关闭集群：

```json
POST /v4/cluster_actions
{
    "cluster": [cluster_id],
    "action": "shutdown",
    "params": "{}"
}
```

## 正确的开机顺序

当重新开启您的 VergeOS 系统时，请按以下顺序执行：

### 单集群环境：

1. **开启 Node1** ，
2. **等待 Node1 完全联机** 完成
3. **开启 Node2**
4. **开启其余节点** 一次一个，之间大约等待 1 分钟
5. **验证系统状态** 在主仪表板上（应显示为绿色且在线）

### 多集群环境：

1. **先开启控制器集群** （先 Node1，然后 Node2，再开启其余控制器节点）
2. **等待控制器集群完全联机**
3. **开启其他集群** 对每个集群遵循单集群顺序

## 验证和监控

完成关机或启动过程后：

1. **检查主仪表板** 上的系统状态指示器
2. **验证所有节点** 显示适当状态（关机为离线，启动为在线）
3. **监控系统日志** 以查找任何错误或警告
4. **测试关键服务** 在启动后以确保正常运行

## 故障排除

### 关机期间的常见问题：

**工作负载无法平稳关闭：**

* 检查来宾操作系统的 ACPI 设置
* 在最后手段下使用“硬重置”或“切断电源”选项
* 检查 VM 电源管理设置

**节点无法进入关机：**

* 验证所有工作负载均已停止
* 检查是否有卡住或无响应的 VM
* 查看节点日志中的错误消息

**集群关机失败：**

* 确保首先正确关闭单个节点
* 检查集群状态和连接性
* 验证没有正在进行的迁移或维护操作

### 获取帮助：

如果您在关机过程中遇到问题：

1. **记录错误消息** 和当前系统状态
2. **检查 VergeOS 日志** 以获取详细的错误信息
3. **联系 VergeOS 支持** 并提供有关问题的具体细节

## 最佳实践

* **安排关机窗口** 在低使用率时段进行
* **通知用户** 在开始关机流程之前
* **记录您的特定环境** 包括集群拓扑和关键工作负载
* **先在非生产环境中** 测试关机流程
* **保持当前备份** 在执行系统关机之前
* **使用维护模式** 尽可能对单个节点使用，而不是整机关机

## 摘要检查清单

* [ ] 清点所有节点上的全部正在运行的工作负载
* [ ] 平稳关闭租户工作负载
* [ ] 关闭所有主机级工作负载（VM、服务等）
* [ ] 导航到集群仪表板并选择关机
* [ ] 导航到 系统 → 集群 并关闭整个集群电源
* [ ] 对于多集群：最后关闭控制器集群（Node1 和 Node2）
* [ ] 通过仪表板监控验证关机完成情况
* [ ] 记录遇到的任何问题以供将来参考

遵循此流程可确保在保持数据完整性和系统健康的同时，安全且受控地关闭您的 VergeOS 环境。

***

{% hint style="info" %}
**文档信息**

* 文档类型：知识库文章
* 分类：系统管理
* 标签：关机、电源关闭、集群管理、系统维护
* 适用于：VergeOS 4.12.6 及更高版本
  {% endhint %}


---

# 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/proper-vergeos-system-shutdown-procedure.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.