# 📁 文件管理器

一个类似 nginx autoindex 的文件管理器，支持实时显示文件变动、在线上传/删除/移动/重命名等操作。

## 功能特性

### 📂 文件浏览
- 目录导航和面包屑路径
- 文件列表显示（名称、大小、修改时间）
- Emoji 图标显示文件类型
- 支持进入子目录和返回上级

### 📤 上传功能
- 单文件上传
- 批量文件上传
- 拖拽上传支持

### 📥 下载功能
- 单文件下载
- 批量文件打包下载（ZIP）
- 整个文件夹下载（ZIP）

### ✏️ 文件操作
- 文件删除（支持批量）
- 文件重命名
- 文件移动（支持跨目录）

### 👁️ 预览功能
- 图片预览
- 文本文件预览
- PDF 文件预览

### 🔄 实时监控
- 文件系统实时监控
- 自动刷新文件列表
- SSE 实时推送通知

### 🎨 界面特性
- 响应式设计
- 深色状态指示
- 流畅动画效果

## 技术栈

- **后端**: Go + Gin
- **前端**: 原生 HTML/CSS/JavaScript
- **实时通信**: Server-Sent Events (SSE)
- **文件监控**: fsnotify
- **部署**: Docker

## 快速开始

### 使用 Docker Compose（推荐）

```bash
# 构建并启动
docker-compose up -d

# 查看日志
docker-compose logs -f file-manager

# 停止服务
docker-compose down
```

### 使用 Docker

```bash
# 构建镜像
docker build -t file-manager .

# 运行容器
docker run -d \
  --name file-manager \
  -p 8080:8080 \
  -v /path/to/your/files:/data \
  file-manager
```

### 本地运行

```bash
# 安装依赖
go mod download

# 启动服务
go run main.go -port 8080 -root ./files
```

## 使用说明

### 访问界面

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

### 上传文件

1. 点击 **📤 上传** 按钮选择文件
2. 或直接将文件拖拽到页面任意位置

### 下载文件/文件夹

1. 勾选要下载的文件/文件夹
2. 点击 **📥 下载** 按钮
3. 多个文件会打包成 ZIP 下载

### 删除文件

1. 勾选要删除的文件
2. 点击 **🗑️ 删除** 按钮
3. 确认删除操作

### 移动文件

1. 勾选一个文件
2. 点击 **✂️ 移动** 按钮
3. 选择目标目录
4. 点击 **移动** 确认

### 重命名

1. 点击文件操作列的 **✏️** 图标
2. 输入新名称
3. 点击 **确认**

### 新建文件夹

1. 点击 **📁 新建文件夹** 按钮
2. 输入文件夹名称
3. 点击 **创建**

## 配置说明

### 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| PORT | HTTP 监听端口 | 8080 |
| ROOT | 文件根目录 | /data |

### 命令行参数

```bash
file-manager -port 8080 -root /path/to/files
```

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/files?path=xxx` | 获取文件列表 |
| GET | `/api/preview?path=xxx` | 预览文件 |
| GET | `/api/download?path=xxx` | 下载文件 |
| GET | `/api/download?paths=[xxx,yyy]` | 批量下载 |
| POST | `/api/upload?path=xxx` | 上传文件 |
| POST | `/api/dir` | 创建目录 |
| DELETE | `/api/files` | 删除文件 |
| PUT | `/api/move` | 移动文件 |
| PUT | `/api/rename` | 重命名文件 |
| GET | `/api/watch` | SSE 实时监控 |

## 项目结构

```
file-manager/
├── main.go           # 主程序
├── static/
│   ├── index.html    # 主页面
│   ├── style.css     # 样式
│   └── app.js        # 前端逻辑
├── Dockerfile        # Docker 构建
├── docker-compose.yml
└── README.md
```

## 安全提示

⚠️ 此文件管理器没有访问控制，请仅在可信环境中使用：

- 不要暴露到公网
- 使用防火墙限制访问
- 或在前端添加认证层

## 许可证

MIT License