first commit

README.md

@@ -0,0 +1,111 @@
+# 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