# 文件上传工具

**Repository Path**: springmorningcxx/spring-uploader

## Basic Information

- **Project Name**: 文件上传工具
- **Description**: 基于浏览器的轻量安全的跨平台文件上传工具，由FastAPI驱动
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-07-12
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, FastAPI, JavaScript, 春晓

## README

# SpringUploader - 文件上传工具

基于 FastAPI 的轻量级跨平台文件上传服务

[![Python](https://img.shields.io/badge/Python-3.9%2B-blue?logo=python)](https://python.org)
[![FastAPI](https://img.shields.io/badge/Framework-FastAPI-green?logo=fastapi)](https://fastapi.tiangolo.com)
[![License](https://img.shields.io/badge/License-MIT-blue)](LICENSE)

## 特性

- **快速部署**：单文件启动，无需复杂配置
- **跨平台访问**：局域网内任意设备通过浏览器即可上传
- **智能文件处理**：
  - 支持多语言文件名（中文、俄文等）
  - 自动过滤危险字符
  - 同名文件自动添加序号避免覆盖
- **安全可靠**：本地运行，数据不经过第三方服务器

## 项目结构

```
SpringUploader/
├── src/
│   ├── main.py            # 主程序
│   ├── static/            # 静态资源（CSS/JS/图片）
│   ├── templates/         # HTML模板
│   └── uploads/           # 上传文件存储
├── docs/                  # 文档
├── requirements.txt       # Python依赖
└── README.md             # 说明文档
```

## 快速开始

### 安装依赖
```bash
pip install -r requirements.txt
```

### 启动服务
```bash
python src/main.py
```

服务启动后，控制台会显示访问地址（如 `http://192.168.1.100:8000`）。

### 打包为可执行文件（可选）
```bash
pip install pyinstaller
pyinstaller --onefile \
  --add-data "src/static;static" \
  --add-data "src/templates;templates" \
  src/main.py
```

## 使用说明

1. 在浏览器中打开服务地址
2. 拖拽或选择要上传的文件
3. 文件将保存到 `src/uploads/` 目录
4. 支持批量上传和进度显示

## 贡献

欢迎提交 Issue 和 Pull Request。

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

---

如果这个工具对你有帮助，欢迎 Star 支持！