# net_file_share

**Repository Path**: sanzk/net_file_share

## Basic Information

- **Project Name**: net_file_share
- **Description**: 局域网文件共享系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-31
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 局域网文件共享服务器

## 📦 项目概述

这是一个独立的局域网文件共享服务器，允许在局域网内的多台计算机之间共享文件。该服务器基于Node.js和Express构建，支持文件上传、下载和管理功能。

## 🚀 技术栈

- Node.js
- Express.js
- Multer (文件上传)
- HTML5/CSS3/JavaScript (前端界面)

## 📁 项目结构

```
file-server/
├── file-server.js          # 服务器主文件
├── package.json            # 项目依赖配置
├── start-file-server.bat   # Windows启动脚本
├── public/                 # 前端静态文件
│   └── index.html          # 主页面
└── uploads/                # 上传文件存储目录
```

## 🛠️ 安装和运行

### 1. 安装依赖

```bash
cd file-server
npm install
```

### 2. 启动服务器

```bash
# 方法1: 使用npm启动
npm start

# 方法2: 使用启动脚本 (Windows)
start-file-server.bat

# 方法3: 直接运行Node.js
node file-server.js
```

## 🌐 访问地址

服务器启动后，会在控制台显示本机的IP地址和访问信息：

- **本地访问**: http://localhost:3005
- **局域网访问**: http://[本机IP]:3005

服务器会自动检测并显示所有可用的局域网IP地址，局域网内的其他设备可以通过这些地址访问文件共享服务。

## 💡 功能特性

### 1. 文件上传
- 支持单个或多个文件同时上传
- 支持拖拽上传
- 保持原始文件名

### 2. 文件下载
- 点击"下载"按钮直接下载文件
- 支持浏览器直接打开可预览文件

### 3. 文件管理
- 查看所有上传文件的列表
- 显示文件大小和修改时间
- 删除不需要的文件

### 4. 局域网共享
- 自动检测本机IP地址
- 显示所有可用的局域网访问地址
- 支持多网卡环境

## 🎯 使用说明

### 首次运行
1. 确保已安装Node.js环境
2. 进入[file-server](file:///C:/Users/sanzh/Desktop/warehouse-3d/file-server)目录
3. 运行`npm install`安装依赖
4. 运行`npm start`启动服务器
5. 在浏览器中访问显示的地址

### 文件操作指南

#### 上传文件
1. 点击"选择文件"按钮或拖拽文件到上传区域
2. 选择要上传的文件
3. 点击"上传文件"按钮
4. 上传成功后文件会显示在文件列表中

#### 下载文件
1. 在文件列表中找到要下载的文件
2. 点击对应行的"下载"按钮
3. 浏览器会自动下载文件

#### 删除文件
1. 在文件列表中找到要删除的文件
2. 点击对应行的"删除"按钮
3. 确认删除操作
4. 文件将从服务器和文件列表中移除

## 🔧 配置说明

### 端口配置
默认端口为3005，如需修改可在[file-server.js](file:///C:/Users/sanzh/Desktop/warehouse-3d/file-server/file-server.js)中修改：
```javascript
const PORT = 3005; // 修改为所需端口
```

### 文件存储目录
上传的文件默认存储在[uploads](file:///C:/Users/sanzh/Desktop/warehouse-3d/file-server/uploads)目录中，如需修改可在[file-server.js](file:///C:/Users/sanzh/Desktop/warehouse-3d/file-server/file-server.js)中修改：
```javascript
const uploadDir = path.join(__dirname, 'uploads'); // 修改为所需目录
```

## 🐛 故障排查

### 问题1: 无法访问服务器
- 检查服务器是否正常启动
- 确认防火墙设置是否允许对应端口通信
- 检查IP地址是否正确

### 问题2: 文件上传失败
- 检查文件大小是否超出限制
- 确认磁盘空间是否充足
- 检查文件名是否包含特殊字符

### 问题3: 局域网设备无法访问
- 确认所有设备是否在同一局域网
- 检查路由器设置是否允许设备间通信
- 确认防火墙是否阻止了访问

## 🔐 安全说明

> ⚠️ **注意**: 此文件服务器为局域网内使用设计，不包含用户认证和访问控制机制。请仅在受信任的局域网环境中使用。

### 安全建议
1. 仅在受信任的局域网中运行
2. 不要在公网环境中暴露此服务
3. 定期清理不需要的文件
4. 避免上传敏感或机密文件

## 📄 许可证

MIT License

## 📞 联系方式

sanzk@qq.com