# diteng-fastapi

**Repository Path**: mimrc/diteng-fastapi

## Basic Information

- **Project Name**: diteng-fastapi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 系统状态监控服务

基于 FastAPI 的系统状态监控服务，提供 CPU、内存、磁盘、网络等实时状态信息。

## 一键部署

```bash
curl -sL https://gitee.com/mimrc/diteng-fastapi/raw/main/install.sh | bash
```

自动克隆项目到 `~/diteng-fastapi` 并执行部署。

## 环境要求

- Python 3.13+
- Debian/Ubuntu 需安装 `python3.13-venv`

## 安装与部署

**一键部署（推荐）**：

```bash
./deploy.sh
```

首次运行自动创建虚拟环境、安装依赖、部署 systemd 服务。

## 运行

交互式文档：http://localhost:8000/docs

## API 端点

| 端点 | 描述 |
|------|------|
| `GET /system/status` | 获取完整系统状态（CPU、内存、磁盘、网络等）|
| `GET /docs` | Swagger UI 文档 |
| `GET /redoc` | ReDoc 文档 |

## 响应字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| cpu.usage_percent | float | CPU 使用率 (%) |
| load_avg.load_1/5/15min | float | 1/5/15分钟系统负载 |
| memory.total/used/available_gb | float | 总/已用/可用内存 (GB) |
| memory.usage_percent | float | 内存使用率 (%) |
| disk.total/used/available_gb | float | 总/已用/可用磁盘 (GB) |
| disk.usage_percent | float | 磁盘使用率 (%) |
| disk_io.read/write_bytes_per_sec | float | 磁盘读/写速度 (MB/s) |
| network | array | 网络接口状态列表 |
| inner_ip | string | 物理网卡内网 IP |
| timestamp | string | 数据采集时间 |

## 依赖

- fastapi
- pydantic
- psutil
- uvicorn

所有依赖安装在项目独立的 `venv/` 中，不影响系统环境。

## 停止与卸载

停止服务：

```bash
sudo systemctl stop sysstat-api
```

完全卸载：

```bash
./uninstall.sh
```