# spulse

**Repository Path**: deepplayer/spulse

## Basic Information

- **Project Name**: spulse
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# spulse - 系统资源监控

一个轻量级、实时、无需登录的系统资源监控 Web 应用。

![GitHub](https://img.shields.io/badge/Rust-2021-orange?logo=rust)
![GitHub](https://img.shields.io/badge/Vue-3.4-green?logo=vue.js)
![GitHub](https://img.shields.io/badge/License-MIT-blue)

## 特性

- **实时监控**: CPU、内存、磁盘 I/O、网络流量
- **单文件部署**: 单个二进制文件包含所有资源
- **自动检测**: 自动切换嵌入式/外部静态资源
- **跨平台**: 支持 Linux、macOS、Windows
- **WebSocket**: 实时数据推送，无刷新更新
- **深色主题**: 现代化 UI 设计

## 快速开始

### 开发模式

```bash
./start.sh dev
```

访问 http://localhost:5173

### 生产模式

```bash
./start.sh prod
```

访问 http://localhost:4567

### 其他命令

```bash
./start.sh build            # 构建 release 版本到 dist/ 目录
./start.sh clean            # 清除构建产物
./start.sh help             # 显示帮助
PORT=8080 ./start.sh prod   # 自定义端口
```

## 手动构建

### 依赖

- Rust 1.70+ 
- Node.js 18+

### 构建步骤

```bash
# 1. 构建前端
cd frontend
pnpm install
pnpm run build

# 2. 构建后端
cd ../backend
cargo build --release

# 3. 运行
./target/release/spulse
```

## 使用说明

```bash
# 默认端口 4567
./spulse

# 自定义端口
./spulse -p 8080

# 强制使用嵌入资源
./spulse --embedded

# 帮助
./spulse -h
```

## 技术栈

| 层级 | 技术 | 版本 |
|------|------|------|
| 后端 | Rust + Axum | 2021 + 0.7 |
| 前端 | Vue 3 + Vite | 3.4 + 5 |
| 样式 | TailwindCSS | 3.4 |
| 系统采集 | sysinfo | 0.30 |

## 项目结构

```
spulse/
├── backend/          # Rust 后端
│   ├── src/          # 源代码
│   └── public/       # 前端构建产物（可选）
├── frontend/         # Vue3 前端
│   └── src/
│       └── components/   # 监控组件
├── dist/             # 发布目录
├── start.sh          # 一键启动脚本（Bash）
├── start.py          # 一键启动脚本（Python）
└── logs/             # 运行日志
```

## 功能详情

| 功能 | 描述 |
|------|------|
| CPU 监控 | 总体使用率 + 各核心详情 + 60秒历史波形 |
| 内存监控 | 已用/可用/总量 + 交换内存监控 + 60秒历史波形 |
| 磁盘监控 | 各分区使用率 + I/O 读写速度波形 + 实时读写速度显示 |
| 网络监控 | 上下行速度 + 60秒历史波形 + 实时速度显示 |

## 测试脚本

```bash
# 系统压力测试（CPU/内存/磁盘）
python3 test_memory.py

# 内存性能测试
python3 test_memory_perf.py
```

## 部署

### 单文件部署

```bash
# 复制到目标服务器
scp backend/target/release/spulse server:/usr/local/bin/

# 服务器上运行
ssh server 'spulse -p 80'
```

### Docker（可选）

```dockerfile
FROM alpine:latest
COPY backend/target/release/spulse /usr/local/bin/
EXPOSE 4567
CMD ["spulse", "-p", "4567"]
```

## 贡献

欢迎 Issue 和 PR！

## 许可证

MIT License