112 lines
3.0 KiB
Markdown
112 lines
3.0 KiB
Markdown
# ServerGuard - 服务器硬件健康诊断系统
|
||
|
||
ServerGuard 是一款基于 Python 的 Linux 命令行工具，用于诊断服务器硬件（CPU、内存、存储、电源、显卡等）的潜在故障。
|
||
|
||
## 功能特性
|
||
|
||
- **硬件信息概览**：收集 CPU、内存、主板、存储、显卡等详细信息
|
||
- **CPU 检测**：温度监控、MCE 错误检查、压力测试
|
||
- **内存检测**：DIMM 信息、ECC 状态检查、内存压力测试
|
||
- **存储检测**：SMART 数据分析、I/O 性能测试、RAID 状态检查
|
||
- **传感器监控**：电压、风扇转速、温度监控（支持 IPMI）
|
||
- **显卡检测**：GPU 信息、温度、驱动状态检查
|
||
- **日志分析**：自动扫描系统日志中的硬件错误
|
||
- **报告生成**：支持 JSON、CSV、纯文本、HTML 格式
|
||
|
||
## 安装
|
||
|
||
### 系统要求
|
||
|
||
- Python 3.8+
|
||
- Linux 操作系统
|
||
- root 权限（大多数硬件诊断功能需要）
|
||
|
||
### 安装系统依赖
|
||
|
||
**Debian/Ubuntu:**
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install -y lshw dmidecode smartmontools lm-sensors stress-ng memtester ipmitool edac-utils fio mdadm pciutils usbutils
|
||
```
|
||
|
||
**CentOS/RHEL:**
|
||
```bash
|
||
sudo yum install -y lshw dmidecode smartmontools lm_sensors stress-ng memtester OpenIPMI edac-utils fio mdadm pciutils usbutils
|
||
```
|
||
|
||
### 安装 Python 依赖
|
||
|
||
```bash
|
||
python3 -m venv venv
|
||
source venv/bin/activate
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
## 使用方法
|
||
|
||
### 快速检测（非侵入性）
|
||
|
||
```bash
|
||
sudo python3 main.py --quick
|
||
```
|
||
|
||
### 全面诊断（包含压力测试）
|
||
|
||
```bash
|
||
sudo python3 main.py --full
|
||
```
|
||
|
||
### 运行特定模块
|
||
|
||
```bash
|
||
sudo python3 main.py --module cpu
|
||
sudo python3 main.py --module memory
|
||
sudo python3 main.py --module storage
|
||
```
|
||
|
||
### 生成不同格式的报告
|
||
|
||
```bash
|
||
sudo python3 main.py --full --format json --output report.json
|
||
sudo python3 main.py --full --format html --output report.html
|
||
```
|
||
|
||
### 查看帮助
|
||
|
||
```bash
|
||
python3 main.py --help
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
ServerGuard/
|
||
├── main.py # 程序入口和核心调度器
|
||
├── utils.py # 通用工具库
|
||
├── reporter.py # 报告生成模块
|
||
├── requirements.txt # Python 依赖
|
||
├── README.md # 项目说明
|
||
├── config/
|
||
│ └── config.yaml # 配置文件
|
||
├── modules/
|
||
│ ├── __init__.py
|
||
│ ├── system_info.py # 系统信息概览
|
||
│ ├── cpu.py # CPU 检测
|
||
│ ├── memory.py # 内存检测
|
||
│ ├── storage.py # 存储检测
|
||
│ ├── sensors.py # 传感器监控
|
||
│ ├── gpu.py # 显卡检测
|
||
│ └── log_analyzer.py # 日志分析
|
||
└── tests/ # 测试文件
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **权限要求**：大多数硬件诊断功能需要 root 权限运行
|
||
2. **压力测试**：全面诊断中的压力测试会占用大量系统资源，建议在维护窗口期进行
|
||
3. **数据安全**：存储设备坏块扫描可能破坏数据，请谨慎使用
|
||
|
||
## 许可证
|
||
|
||
MIT License
|