| --- |
| title: 云盘 - Cloud Disk |
| emoji: 💾 |
| colorFrom: purple |
| colorTo: pink |
| sdk: docker |
| app_file: app.py |
| pinned: false |
| --- |
| |
| # 云盘 - Cloud Disk v2.0 |
|
|
| 一个轻量级的个人云盘应用，支持用户注册登录、独立存储空间、文件上传下载、文件夹管理等功能。 |
|
|
| ## ✨ 功能特性 |
|
|
| ### v2.0 新功能 |
| - 👤 **用户系统**：支持注册、登录、退出 |
| - 🔒 **空间隔离**：每个用户独立存储空间，数据安全隔离 |
| - 💾 **存储配额**：每个用户 1GB 存储空间 |
| - 📊 **实时显示**：存储空间使用情况实时展示 |
|
|
| ### 核心功能 |
| - 📁 **文件管理**：上传、下载、删除文件 |
| - 📂 **文件夹管理**：创建、浏览、删除文件夹 |
| - 🎨 **现代化界面**：美观的 UI 设计，支持响应式布局 |
| - 🖱️ **拖拽上传**：支持拖拽文件到上传区域 |
| - 🔐 **密码安全**：密码哈希存储，保护用户隐私 |
|
|
| ## 🚀 部署到 Hugging Face Spaces |
|
|
| ### Docker 部署（推荐） |
|
|
| 1. 在 Hugging Face 创建一个新的 Space，选择 **Docker** 作为 SDK |
| 2. 将本项目的所有文件上传到 Space 仓库 |
| 3. 等待部署完成后即可访问 |
|
|
| > 💡 **注意**：v2.0 版本默认使用本地存储，无需配置 HF_TOKEN 和 DATASET_REPO。但 Hugging Face Spaces 重启后数据可能会丢失。 |
|
|
| ### 📦 使用 Storage Buckets 持久化存储（推荐） |
|
|
| 为了防止数据丢失，建议使用 Hugging Face 的 Storage Buckets 功能： |
|
|
| 1. 在你的 Space 设置中找到 **Storage Buckets** 部分 |
| 2. 点击 **Mount a bucket** 挂载一个存储桶 |
| 3. 挂载路径设置为 `/data` |
| 4. 重新部署 Space，数据就会自动保存到存储桶中 |
|
|
| > ✅ 使用 Storage Buckets 后，即使 Space 重启，数据也不会丢失！ |
|
|
| ### 本地运行 |
|
|
| ```bash |
| # 安装依赖 |
| pip install -r requirements.txt |
| |
| # 运行 |
| python app.py |
| ``` |
|
|
| 访问 http://localhost:7860 即可使用。 |
|
|
| ## ⚙️ 环境变量配置 |
|
|
| | 变量名 | 说明 | 默认值 | |
| |--------|------|--------| |
| | `SECRET_KEY` | Session 加密密钥 | cloud-disk-secret-key-2024 | |
| | `STORAGE_PATH` | 存储文件路径（Storage Buckets 设为 `/data`） | /data | |
| | `PORT` | 服务端口 | 7860 | |
|
|
| ## 📝 使用说明 |
|
|
| ### 注册账号 |
| 1. 打开应用后点击"立即注册" |
| 2. 输入用户名（3-20位，支持字母、数字、下划线、中文） |
| 3. 设置密码（至少6位）并确认 |
| 4. 点击"注册账号"完成注册 |
|
|
| ### 登录账号 |
| 1. 输入用户名和密码 |
| 2. 点击"登录"进入云盘 |
|
|
| ### 上传文件 |
| - 点击"上传文件"按钮选择文件 |
| - 或直接拖拽文件到上传区域 |
| - 支持批量上传多个文件 |
| - 上传前会检查剩余存储空间 |
|
|
| ### 创建文件夹 |
| - 点击"新建文件夹"按钮 |
| - 输入文件夹名称并确认 |
|
|
| ### 浏览文件 |
| - 点击文件夹进入 |
| - 使用面包屑导航返回上级目录 |
| - 点击刷新按钮重新加载文件列表 |
|
|
| ### 下载/删除文件 |
| - 点击下载图标下载文件 |
| - 点击删除图标删除文件或文件夹（删除前会确认） |
|
|
| ### 查看存储空间 |
| - 顶部显示存储空间使用进度条 |
| - 上传、删除文件后会自动更新 |
|
|
| ### 退出登录 |
| - 点击右上角的退出图标 |
| - 确认后返回登录页面 |
|
|
| ## 🏗️ 技术栈 |
|
|
| - **后端**：Flask (Python) |
| - **前端**：HTML + CSS + JavaScript + Font Awesome |
| - **用户认证**：Werkzeug Security + Flask Session |
| - **存储**：本地文件系统 |
| - **部署**：Docker / Hugging Face Spaces |
|
|
| ## 📁 项目结构 |
|
|
| ``` |
| cloud-disk/ |
| ├── app.py # Flask 后端应用 |
| ├── requirements.txt # Python 依赖 |
| ├── Dockerfile # Docker 部署配置 |
| ├── README.md # 说明文档 |
| ├── .env.example # 环境变量示例 |
| ├── storage/ # 存储目录（运行时自动创建） |
| │ ├── users.json # 用户数据文件 |
| │ └── users/ # 用户存储目录 |
| │ └── {username}/ # 每个用户独立目录 |
| ├── templates/ |
| │ ├── index.html # 主页面 |
| │ ├── login.html # 登录页面 |
| │ └── register.html # 注册页面 |
| └── static/ |
| ├── css/style.css # 样式文件 |
| └── js/app.js # 前端交互逻辑 |
| ``` |
|
|
| ## 🔒 安全特性 |
|
|
| - **密码哈希**：使用 werkzeug.security 进行密码哈希存储 |
| - **路径安全**：防止路径遍历攻击，用户只能访问自己的文件 |
| - **空间隔离**：每个用户独立存储目录，数据互不干扰 |
| - **配额限制**：每个用户最多 1GB 存储空间，防止滥用 |
|
|
| ## ⚠️ 注意事项 |
|
|
| 1. **数据持久化**：建议使用 Storage Buckets 存储（路径 `/data`），这样 Space 重启后数据不会丢失 |
| 2. **并发限制**：单用户演示用途，高并发场景可能需要优化 |
| 3. **存储配额**：每个用户 1GB 空间，超出后无法上传新文件 |
|
|
| ## 📄 License |
|
|
| MIT License |
|
|
