python做的云盘,使用flash框架
| Files | Last commit | Last update |
|---|---|---|
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago |
云盘系统
一个基于 Flask 开发的 B/S 架构云盘系统,支持大文件上传下载、多用户并发访问。
功能特性
- ✅ 大文件支持:支持几十GB的单文件上传下载
- ✅ 分片上传:采用10MB分片大小,支持断点续传
- ✅ 多用户隔离:每个用户拥有独立的存储空间
- ✅ 拖拽上传:支持文件和文件夹的拖拽上传
- ✅ 文件预览:支持多种文件格式的在线预览
- ✅ 批量操作:支持文件和文件夹的批量下载和删除
- ✅ 配置灵活:支持自定义存储路径和端口
- ✅ 高效并发:基于Gunicorn多进程服务器,支持高并发访问
- ✅ 安全可靠:具有路径遍历防护和密码哈希存储
技术栈
- 后端:Flask (Python)
- 前端:HTML5 + JavaScript
- 数据库:JSON文件存储(用户数据和配置)
- 服务器:Gunicorn(生产模式)
- 认证:Flask-Login
快速开始
1. 安装依赖
pip install -r requirements.txt
2. 启动服务器
使用统一的启动脚本 start_server.py,根据配置自动选择运行模式:
python start_server.py
启动模式说明
-
开发模式:当
debug配置为true时自动启用- 单进程运行
- 实时代码重载
- 详细的调试信息
-
生产模式:当
debug配置为false时自动启用- 4个Gunicorn工作进程
- 更高的并发处理能力
- 优化的性能
服务器默认将在 http://localhost:5000 上运行。
配置说明
配置文件
系统配置集中存储在 backend/config.json 文件中,这是唯一的配置文件,所有配置项都在这里管理:
{
"storage_path": "C:\trae_projects\p1\static\uploads",
"port": 5000,
"debug": true
}
配置修改说明:
- ✅ 唯一配置文件:所有配置集中在
backend/config.json中 - ✅ 一键切换模式:只需修改
debug字段即可切换开发/生产模式 - ✅ 端口配置:修改
port字段即可更改服务器端口 - ✅ 无需重启:通过Web界面修改配置会自动重启服务器
- ✅ 自动生成:首次运行会自动创建配置文件
开发模式 vs 生产模式:
| 特性 | 开发模式 (debug=true) |
生产模式 (debug=false) |
|---|---|---|
| 运行方式 | Flask内置服务器 | Gunicorn多进程服务器 |
| 进程数 | 1个进程 | 4个工作进程 |
| 调试信息 | 详细错误信息 | 基本错误信息 |
| 代码重载 | 支持(自动重启) | 不支持 |
| 性能 | 较低 | 较高 |
| 适用场景 | 开发测试 | 生产部署 |
配置项详细说明
| 配置项 | 说明 | 默认值 |
|---|---|---|
storage_path |
文件存储路径 | ./static/uploads |
port |
服务器端口 | 5000 |
debug |
调试模式开关(true/false) | true |
修改配置
方法1:直接编辑配置文件
使用文本编辑器直接修改 backend/config.json 文件,然后重启服务器。
方法2:通过Web界面修改
- 登录系统
- 点击右上角的"配置"按钮
- 在配置面板中修改配置项
- 点击"保存配置"按钮
方法3:通过API修改
curl -X POST -H "Content-Type: application/json" -d '{"port": 8080}' http://localhost:5000/api/config
用户管理
默认用户
系统默认创建一个管理员用户:
- 用户名:
admin - 密码:
admin123
注册新用户
- 通过Web界面注册
- 或使用API注册:
curl -X POST -H "Content-Type: application/json" -d '{"username": "newuser", "password": "password123"}' http://localhost:5000/api/register
API接口
文件操作
GET /api/files?path=<path>- 获取文件列表POST /api/upload- 上传文件GET /api/download/<path>- 下载文件DELETE /api/delete/<path>- 删除文件POST /api/upload_chunk- 上传文件分片POST /api/merge_chunks- 合并文件分片
用户操作
POST /api/login- 用户登录POST /api/logout- 用户登出POST /api/register- 用户注册GET /api/user- 获取当前用户信息
配置操作
GET /api/config- 获取配置POST /api/config- 更新配置
系统架构
目录结构
.
├── backend/ # 后端代码
│ ├── app.py # Flask应用主文件
│ ├── config.json # 系统配置文件
│ ├── config_manager.py # 配置管理器
│ └── user_manager.py # 用户管理器
├── static/ # 静态资源
│ ├── index.html # 前端主页面
│ └── uploads/ # 文件存储目录
│ └── .chunks/ # 分片临时存储目录
├── start_server.py # 启动脚本
└── README.md # 说明文档
大文件上传流程
- 前端将大文件分割成10MB大小的分片
- 逐个上传分片到
/api/upload_chunk接口 - 所有分片上传完成后,调用
/api/merge_chunks接口合并分片 - 服务器将分片合并成完整文件
多用户隔离
每个用户拥有独立的存储目录:
uploads/
├── admin/ # 管理员用户目录
│ └── .chunks/ # 管理员分片目录
└── user1/ # 用户1目录
└── .chunks/ # 用户1分片目录
性能优化
- 文件缓存:文件列表缓存30秒,减少文件系统访问
- 多进程:生产模式下使用4个Gunicorn工作进程
- 分片上传:大文件分片上传,提高上传成功率
- 断点续传:支持上传中断后继续上传
- 高效合并:优化的分片合并算法
安全特性
- 路径遍历防护:严格的路径检查,防止路径遍历攻击
- 密码哈希:使用SHA256对用户密码进行哈希存储
- 用户隔离:每个用户只能访问自己的文件
- CSRF防护:集成了Flask-WTF的CSRF防护
浏览器支持
- Chrome (推荐)
- Firefox
- Safari
- Edge
许可证
MIT License