# raspi_tools

**Repository Path**: maybe_404/raspi_tools

## Basic Information

- **Project Name**: raspi_tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-08
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 树莓派助手 (Raspberry Pi Assistant)

一个功能强大的树莓派Web管理工具，提供系统监控、网络信息显示和文件上传下载功能。

## 功能特性

### 🖥️ 系统监控
- **CPU使用率** - 实时显示CPU使用情况，带有进度条和状态颜色
- **CPU温度** - 显示树莓派CPU温度，带有温度状态提示
- **内存使用率** - 显示内存使用情况和可用内存
- **磁盘使用率** - 显示磁盘使用情况和可用空间
- **系统负载** - 显示系统1分钟、5分钟、15分钟负载平均值
- **运行时间** - 显示系统运行时间

### 🌐 网络信息
- **网络接口** - 显示所有网络接口信息
- **IPv4地址** - 显示每个接口的IPv4地址
- **IPv6地址** - 显示每个接口的IPv6地址
- **MAC地址** - 显示每个接口的MAC地址
- **连接状态** - 显示每个接口的连接状态

### 📤 文件管理
- **文件上传** - 支持上传文件到树莓派
- **文件列表** - 显示所有上传的文件
- **文件下载** - 支持下载文件到本地

## 技术栈

- **后端** - Python 3 (内置http.server模块)
- **前端** - HTML5 + CSS3 + JavaScript
- **系统信息** - psutil模块（树莓派系统内置）

## 项目结构

```
raspi_tools/
├── file_server.html    # 主页面文件
├── server.py          # 服务器脚本
├── id_rsa             # SSH私钥文件
├── id_rsa.pub         # SSH公钥文件
└── README.md          # 项目说明文件
```

## 快速开始

### 1. 部署到树莓派

#### 方式1：直接部署（推荐）

将项目文件复制到树莓派：

```bash
# 使用SCP复制文件
sudo apt update && sudo apt install -y python3-psutil
scp -i id_rsa server.py file_server.html raspi@192.168.0.123:/home/raspi/
```

#### 方式2：从Gitee克隆

```bash
# 在树莓派上执行
sudo apt update && sudo apt install -y git python3-psutil
git clone https://gitee.com/maybe_404/raspi_tools.git
cd raspi_tools
```

### 2. 启动服务

在树莓派上执行：

```bash
python3 server.py
```

或者在后台运行：

```bash
nohup python3 server.py > server.log 2>&1 &
```

### 3. 访问页面

在浏览器中输入：

```
http://树莓派IP地址:8888
```

例如：
```
http://192.168.0.123:8888
```

## 详细使用说明

### 系统监控

- 系统监控区域会自动每5秒更新一次数据
- CPU和温度状态使用颜色标识：
  - 绿色 - 正常状态
  - 黄色 - 警告状态
  - 红色 - 危险状态

### 网络信息

- 显示所有非虚拟网络接口
- 显示每个接口的IP地址和连接状态
- 支持多种网络接口类型

### 文件管理

- **上传文件**：点击"上传文件"按钮选择文件上传
- **下载文件**：点击文件列表中的"下载"按钮下载文件
- **文件列表**：显示所有上传的文件，包括文件名和文件大小

## 配置说明

### 端口配置

默认使用8888端口，如需修改端口，编辑`server.py`文件：

```python
PORT = 8888  # 修改为其他端口
```

### 文件存储目录

默认文件存储在`files`目录下，如需修改，编辑`server.py`文件：

```python
FILES_DIR = 'files'  # 修改为其他目录
```

## 系统要求

### 树莓派系统

- Raspbian OS / Raspberry Pi OS
- Python 3.7+
- python3-psutil包

### 客户端

- 支持HTML5的现代浏览器
- Chrome 60+
- Firefox 55+
- Safari 12+
- Edge 79+

## 安全注意事项

1. **SSH密钥管理**：
   - 妥善保管SSH私钥文件，不要泄露给他人
   - 建议设置合适的文件权限：`chmod 600 id_rsa`

2. **网络访问**：
   - 建议在本地局域网内使用
   - 如需公网访问，建议配置防火墙和端口映射

3. **文件上传**：
   - 当前版本没有文件大小限制，建议根据实际需求添加
   - 没有文件类型限制，建议根据实际需求添加

## 开发与扩展

### 添加新功能

1. 在`server.py`中添加新的请求处理方法
2. 在HTML页面中添加相应的UI元素
3. 在JavaScript中添加交互逻辑

### 自定义样式

编辑`file_server.html`中的CSS样式，自定义页面外观。

## 常见问题

### 1. 无法访问页面

- 检查树莓派IP地址是否正确
- 检查8888端口是否被防火墙阻止
- 检查服务是否正在运行：`ps aux | grep python3`

### 2. 系统信息显示异常

- 检查psutil模块是否安装：`python3 -c "import psutil"`
- 检查树莓派系统是否支持温度读取

### 3. 文件上传失败

- 检查文件大小是否超过系统限制
- 检查磁盘空间是否充足
- 检查文件权限是否正确

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request！

## 更新日志

### v1.0.0 (2025-12-08)
- 初始版本发布
- 实现系统监控功能
- 实现网络信息显示
- 实现文件上传下载功能

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

- Gitee仓库：https://gitee.com/maybe_404/raspi_tools
- 作者：maybe_404

---

**享受使用树莓派助手！** 🎉