> 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/run-the-platform/zh/xi-tong-guan-li/node-diagnostics.md).

# 节点诊断指南

VergeOS 节点诊断工具的综合参考，包括 IPMI 命令、SMART 测试、网络诊断、Fabric 配置和硬件故障排除。

## 概述

Node Diagnostics 工具为单个 VergeOS 节点提供全面的硬件和系统级故障排查功能。这些诊断命令使系统管理员能够直接通过 VergeOS 界面执行详细的硬件分析、监控系统性能，并排查特定节点的问题。

{% hint style="info" %}
**你将学到什么**

* 如何访问和使用节点诊断工具
* 了解每条诊断命令及其针对的硬件
* 节点级故障排查的最佳实践
* 发生硬件问题时，何时使用特定的诊断命令
  {% endhint %}

## 先决条件

* 拥有具备节点管理权限的 VergeOS 界面访问权限
* 对服务器硬件组件有基本了解
* 网络和存储概念知识

{% hint style="info" %}
**节点访问**

节点诊断可提供深入的硬件级访问权限，应由经验丰富的系统管理员使用。
{% endhint %}

## 访问节点诊断

1. **导航至“节点诊断”：**
   * 选择 **基础设施** > **节点** （位于顶部菜单中）。
   * 选择所需的 **节点** 从列表中
   * 点击 **诊断** 在左侧菜单中
2. **使用诊断命令：**
   * 从 **查询** 下拉菜单中选择所需的命令
   * 在右侧配置可用参数
   * 点击 **发送 →** 以执行命令

{% hint style="success" %}
**命令可见性**

启用 **“显示命令”** 以查看实际执行的确切命令，适用于 SSH 执行或脚本自动化。
{% endhint %}

## 诊断命令参考

### ARP 扫描

**用途：** 使用 ARP 数据包发现节点网络接口上的活动设备。

**适用场景：**

* 从节点视角验证网络连通性
* 识别节点本地网段中的设备
* 排查节点网络配置问题

**参数：**

* **接口：** 用于扫描的网络接口

**CLI 语法：**

```bash
nmap -sn [NETWORK_RANGE]
```

***

### ARP 表

**用途：** 显示节点的 ARP 缓存，其中包含 IP 地址与 MAC 地址的映射。

**适用场景：**

* 排查节点网络连接问题
* 验证网络邻居发现
* 检查是否存在影响节点的 ARP 冲突

**CLI 语法：**

```bash
arp -a
```

***

### 网桥地址

**用途：** 显示节点上网络网桥的 MAC 地址表。

**适用场景：**

* 排查网络网桥配置问题
* 验证虚拟交换机上的 MAC 地址学习情况
* 网络拓扑分析

**CLI 语法：**

```bash
brctl showmacs [BRIDGE_NAME]
```

***

### 清除持久化存储

**用途：** 清除节点上的持久化存储缓存和临时数据。

**适用场景：**

* 解决与存储相关的性能问题
* 清除损坏的缓存数据
* 为重新配置存储做准备

{% hint style="danger" %}
**数据影响警告**

此命令可能会影响系统性能，仅应在支持人员指导下使用。
{% endhint %}

**CLI 语法：**

```bash
sync && echo 3 > /proc/sys/vm/drop_caches
```

***

### DMI 表

**用途：** 显示桌面管理接口（DMI）信息，包括硬件详细信息。

**适用场景：**

* 硬件清单和识别
* 验证系统规格
* 排查硬件兼容性问题

**CLI 语法：**

```bash
dmidecode
```

***

### DNS 查询

**用途：** 从节点的角度测试 DNS 解析。

**适用场景：**

* 排查节点 DNS 配置问题
* 验证节点的外部连接
* 测试名称解析服务

**参数：**

* **主机名：** 要解析的目标主机名
* **DNS 服务器：** 要查询的特定 DNS 服务器

**CLI 语法：**

```bash
nslookup [HOSTNAME]
dig [HOSTNAME]
```

***

### 以太网工具

**用途：** 提供以太网接口的详细信息和配置。

**适用场景：**

* 诊断网络接口问题
* 检查链路速度和双工设置
* 排查物理网络连接问题

**参数：**

* **接口：** 要检查的网络接口

**CLI 语法：**

```bash
ethtool [INTERFACE]
```

***

### Fabric 配置

**用途：** 显示节点的 VergeOS Fabric 网络配置。

**适用场景：**

* 排查节点间通信问题
* 验证 Fabric 网络设置
* 诊断集群连接问题

**CLI 语法：**

```bash
verge fabric show
```

***

### IP

**用途：** 用于接口和路由诊断的高级 IP 命令访问。

**适用场景：**

* 详细分析网络接口
* 检查路由表
* 高级网络故障排查

**参数：**

* **命令：** IP 命令选项（route、addr、link 等）

**CLI 语法：**

```bash
ip [COMMAND] [OPTIONS]
```

***

### IPMI BMC 信息

**用途：** 显示基板管理控制器信息。

**适用场景：**

* 排查硬件管理问题
* 验证 IPMI 配置
* 远程管理诊断

**CLI 语法：**

```bash
ipmitool bmc info
```

***

### IPMI 机箱状态

**用途：** 显示物理机箱状态和电源信息。

**适用场景：**

* 排查电源管理问题
* 验证硬件状态
* 物理系统诊断

**CLI 语法：**

```bash
ipmitool chassis status
```

***

### IPMI FRU 信息

**用途：** 显示 IPMI 中的现场可更换单元信息。

**适用场景：**

* 硬件资产管理
* 组件识别
* 保修和支持信息

**CLI 语法：**

```bash
ipmitool fru print
```

***

### IPMI LAN 信息

**用途：** 显示 IPMI 网络配置详细信息。

**适用场景：**

* 排查 IPMI 网络问题
* 远程管理连接问题
* 验证 BMC 网络配置

**CLI 语法：**

```bash
ipmitool lan print
```

***

### IPMI MC 重置

**用途：** 重置管理控制器（BMC）。

**适用场景：**

* 解决 IPMI 通信问题
* BMC 故障排查
* 管理接口恢复

{% hint style="warning" %}
**管理影响**

重置期间，IPMI/BMC 功能将暂时中断。
{% endhint %}

**CLI 语法：**

```bash
ipmitool mc reset cold
```

***

### IPMI 传感器数据存储库

**用途：** 显示传感器数据存储库的完整信息。

**适用场景：**

* 详细硬件监控
* 传感器配置验证
* 硬件诊断与分析

**CLI 语法：**

```bash
ipmitool sdr list
```

***

### IPMI 传感器

**用途：** 显示当前传感器读数（温度、电压、风扇等）。

**适用场景：**

* 硬件运行状况监控
* 温度与电源诊断
* 环境问题排查

**CLI 语法：**

```bash
ipmitool sensor list
```

***

### IPMI 系统事件日志

**用途：** 显示来自 IPMI 的系统事件日志。

**适用场景：**

* 硬件错误分析
* 系统事件问题排查
* 历史硬件问题调查

**CLI 语法：**

```bash
ipmitool sel list
```

***

### LED 控制（驱动器）

**用途：** 控制存储驱动器上的 LED 指示灯，以便进行物理识别。

**适用场景：**

* 物理驱动器识别
* 驱动器更换流程
* 硬件维护任务

**参数：**

* **驱动器：** 目标驱动器标识符
* **操作：** LED 开/关/闪烁

**CLI 语法：**

```bash
ledctl locate=[DRIVE_PATH]
```

***

### 日志

**用途：** 显示节点系统日志和日志条目。

**适用场景：**

* 系统问题排查
* 错误分析
* 性能问题调查

**CLI 语法：**

```bash
journalctl -n 100
dmesg
```

***

### 网络绑定

**用途：** 显示网络绑定配置和状态。

**适用场景：**

* 网络冗余问题排查
* 绑定接口诊断
* 链路聚合验证

**CLI 语法：**

```bash
cat /proc/net/bonding/[BOND_NAME]
```

***

### OpenSSL 性能测试

**用途：** 测试节点 CPU 的加密性能。

**适用场景：**

* 性能基准测试
* 加密能力测试
* 硬件加速验证

**CLI 语法：**

```bash
openssl speed
```

***

### Ping

**用途：** 测试节点的网络连接。

**适用场景：**

* 基本连接测试
* 网络路径验证
* 延迟测量

**参数：**

* **目标：** 目标 IP 或主机名
* **次数：** Ping 数据包数量

**CLI 语法：**

```bash
ping -c [COUNT] [DESTINATION]
```

***

### RAS 查询

**用途：** 查询可靠性、可用性和可维护性信息。

**适用场景：**

* 硬件可靠性评估
* 错误纠正状态
* 内存和处理器诊断

**CLI 语法：**

```bash
ras-mc-ctl --summary
```

***

### S.M.A.R.T. 诊断测试

**用途：** 在存储驱动器上启动 SMART 诊断测试。

**适用场景：**

* 主动检测驱动器健康状况
* 存储故障排查
* 预防性维护

**参数：**

* **驱动器：** 要测试的目标驱动器
* **测试类型：** 短测、长测或传输测试

**CLI 语法：**

```bash
smartctl -t [TEST_TYPE] [DRIVE_PATH]
```

{% hint style="info" %}
**测试时长**

SMART 测试可能需要较长时间才能完成，尤其是长测。
{% endhint %}

***

### S.M.A.R.T. 信息

**用途：** 显示驱动器的 SMART 属性和健康信息。

**适用场景：**

* 驱动器健康状况评估
* 预测性故障分析
* 存储性能监控

**参数：**

* **驱动器：** 目标驱动器标识符

**CLI 语法：**

```bash
smartctl -a [DRIVE_PATH]
```

***

### 显示块设备

**用途：** 列出节点可见的所有块设备。

**适用场景：**

* 存储设备清单
* 驱动器识别故障排查
* 存储配置验证

**CLI 语法：**

```bash
lsblk
fdisk -l
```

***

### TCP 连接测试

**用途：** 测试与远程主机和端口的 TCP 连通性。

**适用场景：**

* 服务连通性验证
* 防火墙规则测试
* 网络故障排查

**参数：**

* **主机：** 目标主机名或 IP 地址
* **端口：** TCP 端口号

**CLI 语法：**

```bash
telnet [HOST] [PORT]
nc -zv [HOST] [PORT]
```

***

### TCP 抓包

**用途：** 捕获网络数据包，以便详细分析流量。

**适用场景：**

* 网络故障排查
* 安全分析
* 协议调试

**参数：**

* **数据包数量：** 要捕获的数据包数（100 到 1000，默认值为 100）
* **超时时间（秒）：** 捕获时长（1 到 30 秒，默认值为 15 秒）
* **接口类型：** ***物理接口***, ***VXLAN***, ***网桥***&#x6216; ***TAP 设备***
* **名称：** 要捕获的接口，按以下条件筛选： **接口类型**.
* **详细输出：** ***无***, ***低***, ***中***&#x6216; ***高***
* **显示链路层标头（VLAN、MAC）：** 在命令中添加 `-e` ，使每个数据包都显示其 MAC 地址和 802.1Q VLAN 标签
* **表达式：** 数据包筛选表达式（例如， `vlan 210` 或 `not vlan 1`），按原样附加到命令中

{% hint style="info" %}
**接口名称列表**

“ **物理** ”列表显示节点的物理网卡。 **网桥** 和 **TAP 设备** 只会列出所选节点上正在运行的网络和虚拟机的网桥与 TAP 设备，因此请在网络或虚拟机运行所在的节点上执行捕获。
{% endhint %}

{% hint style="info" %}
**查看 VLAN 标记**

默认情况下，捕获不会打印链路层标头，因此带 VLAN 标记的帧会显示为普通 IP 流量，不包含 VLAN ID。选中 **显示链路层标头（VLAN、MAC）** 即可查看标记，例如 `ethertype 802.1Q (0x8100) ... vlan 210, p 0`.
{% endhint %}

**CLI 语法：**

启用 **显示命令** 即可查看使用的确切命令。默认命令为：

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100
```

勾选 **显示链路层标头（VLAN、MAC）** 并输入 **表达式** 后：

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100 -e [EXPRESSION]
```

{% hint style="warning" %}
**性能影响**

数据包捕获可能会影响节点性能。在生产环境中请谨慎使用。
{% endhint %}

***

### CPU 使用率最高的进程

**用途：** 显示占用 CPU 资源最多的进程。

**适用场景：**

* 性能故障排查
* 资源利用率分析
* 进程监控

**CLI 语法：**

```bash
top -o %CPU
```

***

### 网络使用率最高的进程

**用途：** 显示网络利用率最高的进程。

**适用场景：**

* 网络性能分析
* 带宽利用率故障排查
* 识别网络密集型进程

**CLI 语法：**

```bash
iftop
nethogs
```

***

### 路由跟踪

**用途：** 跟踪从节点到目标地址的网络路径。

**适用场景：**

* 网络路由故障排查
* 路径分析
* 连接问题诊断

**参数：**

* **目标：** 目标 IP 或主机名

**CLI 语法：**

```bash
traceroute [DESTINATION]
mtr [DESTINATION]
```

***

### 我的 IP 地址是什么

**用途：** 显示节点的外部 IP 地址。

**适用场景：**

* 外部连接验证
* NAT 配置故障排查
* 网络配置验证

**CLI 语法：**

```bash
curl ifconfig.me
```

## 最佳实践

### 硬件诊断工作流程

1. **系统概览：** 从 DMI 表和 IPMI 机箱状态开始
2. **健康检查：** 查看 IPMI 传感器和系统事件日志
3. **存储分析：** 使用 S.M.A.R.T. 信息和测试
4. **网络验证：** 检查网络绑定和接口状态
5. **性能评估：** 监控 CPU 和网络使用情况

### 预防性维护

* **定期健康检查：** 监控 IPMI 传感器和 SMART 数据
* **日志审查：** 定期检查系统事件日志
* **性能监控：** 跟踪 CPU 和网络利用率趋势
* **驱动器健康状况：** 安排定期 SMART 诊断测试

### 安全注意事项

* **影响评估：** 考虑诊断命令对生产系统的影响
* **支持协调：** 对于复杂的硬件问题，请联系 VergeOS 支持团队
* **文档记录：** 保存诊断结果记录，以便分析趋势
* **变更管理：** 硬件修改须遵循变更管理流程

## 常见节点问题故障排查

### 硬件问题

1. 检查 **IPMI 传感器** 以排查温度、电压和风扇问题
2. 查看 **IPMI 系统事件日志** 以查找硬件错误
3. 使用 **S.M.A.R.T. 信息** 评估驱动器健康状况

### 网络问题

1. 验证 **网络绑定** 状态和配置
2. 使用 **以太网工具** 检查接口设置
3. 使用以下工具测试连通性： **Ping** 和 **路由跟踪**

### 性能问题

1. 监控 **CPU 使用率最高的进程** 以检查资源限制
2. 检查 **网络使用率最高的进程** 以了解带宽使用情况
3. 查看 **日志** 以查找与性能相关的错误

### 存储问题

1. 使用 **显示块设备** 以确认驱动器是否已识别
2. 运行 **S.M.A.R.T. 诊断测试** 以全面检测驱动器
3. 检查 **RAS 查询** 以获取内存和存储错误信息

## 后续步骤

掌握节点诊断后，可以进一步了解：

* 高级硬件监控与警报
* 自动化诊断脚本
* 与外部监控系统集成
* 预防性维护计划

对于复杂的硬件问题或异常的诊断结果，请联系 [VergeOS 支持团队](https://docs.verge.io/overview/zh/support-and-services.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/node-diagnostics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
