# FileShare

**Repository Path**: hyz2xx/file-share

## Basic Information

- **Project Name**: FileShare
- **Description**: FileShare是一个基于Python Flask的文件分享网站，允许用户上传、分类和分享图片和音乐文件。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-20
- **Last Updated**: 2025-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FileShare - 文件分享网站

FileShare是一个基于Python Flask的文件分享网站，允许用户上传、分类和分享图片和音乐文件。

## 功能特点

- **用户认证**：内置管理员账号登录系统
- **文件上传**：支持上传图片和音乐文件
- **文件预览**：图片缩略图和在线预览，音乐在线播放
- **文件下载**：所有访问者可下载文件，并提供下载链接复制功能
- **分组管理**：可创建不同的组（文件夹）对文件进行分类管理
- **搜索功能**：支持按文件名搜索
- **文件筛选**：可按文件类型（图片/音乐）和组进行筛选
- **下载统计**：记录每个文件的下载次数

## 技术栈

- **后端**：Python Flask
- **数据库**：SQLite
- **前端**：Bootstrap 5, jQuery, Font Awesome
- **文件处理**：Werkzeug, Pillow, Mutagen
- **用户认证**：Flask-Login

## 安装步骤

1. 克隆仓库
```bash
git clone <repository-url>
cd res-share
```

2. 创建并激活虚拟环境
```bash
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# 或
.venv\Scripts\activate  # Windows
```

3. 安装依赖
```bash
cd file_sharing_site
pip install -r requirements.txt
```

4. 运行应用
```bash
python run.py
```

5. 访问网站
在浏览器中访问 http://127.0.0.1:5000

## 使用说明

### 管理员登录
- 默认账号: admin
- 默认密码: Admin.001

### 文件管理
1. **上传文件**：登录后，点击"上传文件"按钮，选择文件类型和所属组
2. **查看文件**：主页显示所有上传的文件，可按类型和组筛选
3. **预览文件**：点击"预览"按钮查看图片，点击"播放"按钮播放音乐
4. **下载文件**：点击"下载"按钮下载文件

### 组管理
1. **创建组**：登录后，点击"组管理"，然后点击"创建新组"
2. **编辑组**：在组管理页面，点击组旁边的"编辑"按钮
3. **删除组**：在组管理页面，点击组旁边的"删除"按钮

### 下载链接
- 每个文件卡片显示文件的下载链接
- 点击复制按钮可复制下载链接，方便分享给他人

## 目录结构

```
file_sharing_site/
├── app/                    # 应用主目录
│   ├── __init__.py         # 应用初始化
│   ├── models.py           # 数据库模型
│   ├── routes.py           # 路由和视图函数
│   ├── static/             # 静态文件
│   │   ├── css/            # CSS样式
│   │   ├── js/             # JavaScript文件
│   │   └── uploads/        # 上传文件存储
│   │       ├── images/     # 图片存储
│   │       └── music/      # 音乐存储
│   └── templates/          # HTML模板
│       ├── base.html       # 基础模板
│       ├── index.html      # 主页模板
│       ├── login.html      # 登录页面
│       ├── upload.html     # 上传页面
│       ├── groups.html     # 组管理页面
│       ├── create_group.html # 创建组页面
│       └── edit_group.html # 编辑组页面
├── config.py               # 配置文件
├── requirements.txt        # 依赖包列表
└── run.py                  # 应用入口
```

## 注意事项

- 上传文件大小限制为16MB
- 支持的图片格式：PNG, JPG, JPEG, GIF
- 支持的音乐格式：MP3, WAV, OGG, FLAC

## 许可证

[MIT License](LICENSE)