# FileServer

**Repository Path**: fmCoder/FileServer

## Basic Information

- **Project Name**: FileServer
- **Description**: No description available
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-06
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FileServer 文件服务器

一个基于 Flask 的文件管理系统，支持文件上传、下载、删除、文件夹管理等功能，支持 PC、平板和移动端响应式布局。

---

## 功能特性

- **用户认证** - 密码登录、CSRF 保护
- **文件管理** - 单文件上传、批量上传、文件夹上传
- **文件夹管理** - 创建文件夹、删除文件夹（递归删除文件和子文件夹）
- **下载功能** - 单文件下载、批量下载（打包成 zip）
- **响应式布局** - 支持 PC 端表格视图、平板/移动端卡片视图

---

## 快速开始

### 1. 密码配置

首次启动前，请在 `.env` 文件中设置登录密码：

```
LOGIN_FS_PWD=your_password_here
```

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

### 3. 启动服务

```bash
# Linux/Ubuntu
chmod +x start.sh
./start.sh

# 或手动启动
cd server
python app.py
```

### 4. 访问

打开浏览器访问: http://localhost:5000

---

## 配置说明

在 `.env` 文件中可配置以下参数（请复制以下内容并修改密码）：

```bash
# FileServer 配置文件
# 请复制此文件为 .env 并修改密码

# 登录密码 - 首次访问需要输入此密码
LOGIN_FS_PWD=your_password_here

# 服务器配置
HOST=0.0.0.0
PORT=5000

# Session 密钥（请修改为随机字符串，保持session持久化）
SECRET_KEY=your_random_secret_key_here

# 文件上传配置
# 最大文件大小（字节），默认100MB
MAX_CONTENT_LENGTH=104857600
# 允许的文件扩展名
ALLOWED_EXTENSIONS=pdf,doc,docx,xls,xlsx,ppt,pptx,txt,rtf,odt,png,jpg,jpeg,gif,bmp,svg,webp,ico,tiff,mp3,wav,ogg,flac,aac,wma,m4a,mp4,avi,mov,wmv,flv,mkv,webm,m4v,zip,rar,7z,tar,gz,bz2,exe,msi,bat,sh,cmd,properties,json,xml,html,css,js,py,apk
```

---

## 项目结构

```
FileServer/
├── server/
│   └── app.py              # Flask 后端应用
├── static/
│   ├── js/
│   │   └── app.js          # 前端逻辑
│   └── css/
│       └── style.css       # 样式文件
├── templates/
│   └── index.html          # 前端页面
├── uploads/                 # 上传文件存储目录
├── files.db                # SQLite 数据库
├── .env                    # 环境配置
└── requirements.txt         # Python 依赖
```

---

## 生产环境部署

建议使用 Gunicorn 替代 Flask 内置服务器：

```bash
pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 "server.app:app"
```

---

## 依赖

- flask
- werkzeug
- python-dotenv