# 文件上传工具

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

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

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

## README

# 📁 文件上传工具 - SpringUploader

<div align="center">
  <img src="docs/logo.png" alt="SpringUploader Logo" width="200">
  <br>
  <p>轻量安全的跨平台文件上传工具</p>
  
  [![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/许可证-春晓PSL-84dd84)](LICENSE)
</div>

## ✨ 项目介绍
本项目使用Python3的FastAPI框架开发。运行项目会在本地启动启动一个Web服务，在其他设备上通过浏览器访问该服务地址即可上传文件。上传的文件保存于与`main.py`同级的`uploads`目录下。  
支持中文、俄文等非英语文件名、自动过滤文件路径中的危险字符、上传时保留原文件名并对同名文件自动添加序号。

<div align="center">
  <img src="docs/preview.png" alt="项目预览" width="800">
</div>

## 📦 文件结构

```bash
SpringUploader/
├── docs/                  # 文档资源
│   ├── logo.png           # 项目LOGO
│   └── preview.png        # 项目预览图
├── src/                   # 源代码
│   ├── main.py            # 主程序入口
│   ├── static/            # 静态资源
│   │   ├── css/           # 样式表
│   │   ├── js/            # 前端脚本
│   │   └── img/           # 图片资源
│   ├── templates/         # HTML模板
│   └── uploads/           # 上传文件存储目录
├── requirements.txt       # 依赖清单
└── README.md              # 项目说明
```

## 🚀 快速开始
### 启动服务
```bash
git clone https://github.com/yourusername/SpringUploader.git
cd SpringUploader
pip install -r requirements.txt # 安装依赖
python src/main.py # 启动服务
```
### 访问服务
打开浏览器访问控制台显示的IP地址，例如：
```text
http://192.168.1.100:8000
```

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

## 鸣谢
- 感谢[小深](https://chat.deepseek.com/)在项目开发中对我的技术与情感支持🩷   
- 感谢[即梦AI](https://jimeng.jianying.com/s/6stQq3HtrnI/)为我设计的项目logo	


如果本项目对您有帮助，欢迎 ⭐ Star 支持！