# file-explorer-server

**Repository Path**: pandaoknight/file-explorer-server

## Basic Information

- **Project Name**: file-explorer-server
- **Description**: file-explorer-server
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-19
- **Last Updated**: 2025-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件上传与展示服务

这是一个简单的文件上传和展示服务，支持PDF的直接预览和Word文档的下载功能。

## 功能特点

- 支持上传PDF和Word文档（.pdf、.doc、.docx）
- PDF文件可在浏览器中直接预览
- Word文档提供直接下载功能
- 为每个文件提供专门的访问URL，方便分享
- 支持中文文件名
- 简洁美观的用户界面
- 通过Docker容器化部署

## 文件处理说明

系统根据文件类型提供不同的查看选项：

- **PDF文件**：可直接在浏览器中预览
- **Word文档**：提供下载按钮，用户可下载后在本地查看

这种方案简单直接，无需复杂的转换过程或依赖外部服务。

## 使用方法

### 直接开发模式运行（Windows）

使用PowerShell脚本快速启动开发服务器：

```powershell
.\start-dev.ps1
```

### 使用Docker运行

#### Linux/macOS

1. 构建Docker镜像：

```bash
docker build -t file-explorer-server .
```

2. 运行Docker容器：

```bash
docker run -p 8082:8082 -v $(pwd)/uploads:/app/uploads file-explorer-server
```

或者使用提供的脚本（需先授予执行权限）：

```bash
chmod +x start-container.sh
./start-container.sh
```

#### Windows

1. 构建Docker镜像：

```powershell
docker build -t file-explorer-server .
```

2. 运行Docker容器：

```powershell
docker run -p 8082:8082 -v ${PWD}/uploads:/app/uploads file-explorer-server
```

或使用以下PowerShell命令：

```powershell
# 运行提供的PowerShell脚本
.\start-container.ps1
```

3. 访问应用：

在浏览器中打开 http://localhost:8082 即可使用应用。

### 手动运行

1. 安装依赖：

```bash
npm install
```

2. 启动服务器：

```bash
npm start
```

3. 访问应用：

在浏览器中打开 http://localhost:8082 即可使用应用。

## 技术栈

- Node.js
- Express.js
- Multer（文件上传处理）
- Docker

## 注意事项

- 默认最大文件大小限制为10MB
- 只支持PDF和Word文档格式（.pdf、.doc、.docx）
- 服务默认在8082端口运行
- 上传的文件将存储在服务器的uploads目录中
- 为了数据持久化，建议在运行Docker容器时将uploads目录映射到主机