> 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 节点提供全面的硬件和系统级故障排查能力。这些诊断命令使系统管理员能够直接从 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 的可更换现场单元（FRU）信息。

**何时使用：**

* 硬件清单管理
* 组件识别
* 保修和支持信息

**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]
```

***

### 日志

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

**何时使用：**

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

**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 抓包

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

**何时使用：**

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

**参数：**

* **接口：** 要监控的网络接口
* **过滤器：** 数据包过滤表达式

**CLI 语法：**

```bash
tcpdump -i [INTERFACE] [FILTER]
```

{% 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 支持](/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 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/run-the-platform/zh/xi-tong-guan-li/node-diagnostics.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.