# web-file-manager

**Repository Path**: weedlu/web-file-manager

## Basic Information

- **Project Name**: web-file-manager
- **Description**: WEB版的服务器文件管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WEB版文件管理系统

基于 Vue 3 + Spring Boot 的轻量级文件管理系统。

## 功能特性

- ✅ 简单鉴权（admin/admin）
- ✅ 左侧目录树、右侧文件列表
- ✅ 新建/删除/重命名目录
- ✅ 新建/删除/重命名文件
- ✅ 文件上传/下载

## 技术栈

| 层级 | 技术选型                        |
|------|-----------------------------|
| 前端 | Vue 3 + Element Plus + Vite |
| 后端 | Spring Boot 3 + Java 21     |
| 认证 | Session                     |

## 快速开始

### 后端启动

```bash
cd backend
# 确保已配置 application.yml 中的 file.manager.root-path
./mvnw spring-boot:run
# 或
java -jar target/web-file-manager-1.0.0.jar
```

后端端口：**8080**

### 前端启动

```bash
cd frontend
npm install
npm run dev
```

前端端口：**5273**（已代理 /api 到后端 8080）

### 访问

浏览器打开：http://localhost:5273

默认账号：`admin` / `admin`

## API接口

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/auth/login` | 登录 |
| POST | `/api/auth/logout` | 登出 |
| GET | `/api/auth/check` | 检查登录状态 |
| GET | `/api/fs/tree` | 获取目录树 |
| GET | `/api/fs/list` | 列出目录内容 |
| POST | `/api/fs/mkdir` | 创建目录 |
| POST | `/api/fs/createFile` | 创建文件 |
| POST | `/api/fs/rename` | 重命名 |
| DELETE | `/api/fs/delete` | 删除文件/目录 |
| POST | `/api/fs/upload` | 上传文件 |
| GET | `/api/fs/download` | 下载文件 |

## 配置说明

后端配置文件 `backend/src/main/resources/application.yml`：

```yaml
server:
  port: 8080

spring:
  servlet:
    multipart:
      max-file-size: 500MB
      max-request-size: 500MB

file:
  manager:
    root-path: /home/agentuser  # 管理根目录
```

## 目录结构

```
web-file-manager/
├── backend/                    # Spring Boot 后端
│   ├── pom.xml
│   └── src/main/java/com/filemanager/
│       ├── FileManagerApplication.java
│       ├── common/
│       ├── config/
│       ├── controller/
│       └── service/
├── frontend/                   # Vue 3 前端
│   ├── index.html
│   ├── package.json
│   ├── vite.config.js
│   └── src/
│       ├── main.js
│       ├── App.vue
│       ├── api/
│       └── views/
└── README.md
```

## License

MIT