pypan:基于 Flask 的 B/S 架构云盘系统项目

python做的云盘,使用flash框架

Branch1Tags0
FilesLast commitLast 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界面修改

  1. 登录系统
  2. 点击右上角的"配置"按钮
  3. 在配置面板中修改配置项
  4. 点击"保存配置"按钮

方法3:通过API修改

curl -X POST -H "Content-Type: application/json" -d '{"port": 8080}' http://localhost:5000/api/config

用户管理

默认用户

系统默认创建一个管理员用户:

  • 用户名:admin
  • 密码:admin123

注册新用户

  1. 通过Web界面注册
  2. 或使用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             # 说明文档

大文件上传流程

  1. 前端将大文件分割成10MB大小的分片
  2. 逐个上传分片到 /api/upload_chunk 接口
  3. 所有分片上传完成后,调用 /api/merge_chunks 接口合并分片
  4. 服务器将分片合并成完整文件

多用户隔离

每个用户拥有独立的存储目录:

uploads/
├── admin/                # 管理员用户目录
│   └── .chunks/         # 管理员分片目录
└── user1/               # 用户1目录
    └── .chunks/         # 用户1分片目录

性能优化

  • 文件缓存:文件列表缓存30秒,减少文件系统访问
  • 多进程:生产模式下使用4个Gunicorn工作进程
  • 分片上传:大文件分片上传,提高上传成功率
  • 断点续传:支持上传中断后继续上传
  • 高效合并:优化的分片合并算法

安全特性

  • 路径遍历防护:严格的路径检查,防止路径遍历攻击
  • 密码哈希:使用SHA256对用户密码进行哈希存储
  • 用户隔离:每个用户只能访问自己的文件
  • CSRF防护:集成了Flask-WTF的CSRF防护

浏览器支持

  • Chrome (推荐)
  • Firefox
  • Safari
  • Edge

许可证

MIT License

Introduction

python做的云盘,使用flash框架

Customize your domain