# jetFile

**Repository Path**: kang-zhenbin/jet-file

## Basic Information

- **Project Name**: jetFile
- **Description**: 这是一个使用 Node.js 创建文件服务器的完整解决方案，支持目录浏览和大文件高效下载:
1、提供美观的文件列表页面，显示文件名、大小和修改日期
2、使用流传输处理大文件（100MB+），避免内存溢出
3、支持断点续传
4、能正确处理中文文件名和路径
5、性能优化：Gzip 压缩（针对文本类文件）、静态资源缓存、流式传输大文件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-15
- **Last Updated**: 2025-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

这是一个使用 Node.js 创建文件服务器的完整解决方案，支持目录浏览和大文件高效下载：

### 功能特点：

1. **目录浏览**：提供美观的文件列表页面，显示文件名、大小和修改日期
2. **高效下载**：
   - 使用流传输处理大文件（100MB+），避免内存溢出
   - 支持断点续传（Resume Download），可暂停/继续下载
   - 优化的 HTTP 头设置，确保正确的文件大小和名称显示
3. **中文支持**：正确处理中文文件名和路径
4. **性能优化**：
   - Gzip 压缩（针对文本类文件）
   - 静态资源缓存
   - 流式传输大文件
5. **支持上传功能**

### 使用步骤：

1. 创建项目目录并放入上述代码文件
2. 创建 `downloads` 目录，将需要共享的文件放入其中
3. 安装依赖：

```bash
npm install
```

4. 启动服务器：

```bash
npm start
```

5. 访问地址：
   - 本地：`http://localhost:3000`
   - 局域网其他设备：`http://你的IP地址:3000`（如：`http://192.168.1.100:3000`）

### `TODO`性能优化建议：

1. 确保服务器有足够带宽和资源
2. 对于超大文件（GB 级），建议使用专用下载工具（如 IDM）
3. 可通过以下方式进一步提升性能：

### 注意事项：

- 确保防火墙开放 3000 端口
- 如需修改端口，可编辑 `server.js` 中的 `PORT` 变量
- 如需修改共享目录，可编辑 `server.js` 中的 `DOWNLOAD_DIR` 变量
- 对于生产环境，建议使用 Nginx 等反向代理服务器

这个解决方案能满足你的需求，提供友好的文件下载界面，并通过流处理确保大文件高效下载。