# static-file-server

**Repository Path**: tufeiping/static-file-server

## Basic Information

- **Project Name**: static-file-server
- **Description**: 基于 Python 极简本地文件服务 Web 微服务
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 静态文件服务器

一个基于Python的简单静态文件服务器，支持文件上传、下载和删除功能，带有美观的Web界面。

## 功能特性

- 📁 文件上传和下载
- 🗑️ 文件删除功能
- 📊 文件列表显示（文件名、大小、修改时间）
- 🎨 现代化响应式Web界面
- 🔒 安全的文件路径处理
- 📱 移动设备友好界面

## 系统要求

- Python 3.6+
- 标准库模块（无需额外安装依赖）

## 快速开始

### 基本使用

1. 克隆或下载项目
2. 在终端中运行：
   ```bash
   python server.py
   ```
3. 打开浏览器访问 `http://localhost:8000`

### 指定服务目录

```bash
python server.py /path/to/your/directory
```

如果不指定目录，服务器将在当前目录下的 `uploads` 文件夹中服务文件。

## 使用说明

### 文件上传
- 在Web界面的上传区域选择文件
- 点击"上传"按钮
- 文件将保存在配置的服务目录中

### 文件下载
- 点击文件列表中的文件名即可下载

### 文件删除
- 点击对应文件行的"删除"按钮
- 在确认对话框中确认删除操作

### 文件浏览
- 文件按修改时间倒序排列（最新在前）
- 显示文件大小和最后修改时间
- 显示当前服务目录的绝对路径

## 技术实现

- **后端**: Python `http.server` 和 `socketserver`
- **前端**: 响应式HTML/CSS/JavaScript
- **安全**: 文件路径验证和HTML转义
- **编码**: UTF-8，支持中文文件名

## 配置选项

在 `server.py` 中可以修改以下配置：

```python
# 服务器端口
PORT = 8000

# 默认服务目录
DEFAULT_DIR = "uploads"
```

## 安全注意事项

- 文件删除操作需要用户确认
- 所有文件名都经过HTML转义防止XSS攻击
- 文件路径限制在指定服务目录内
- 仅支持文件操作，不支持目录遍历

## 许可证

[MIT License](./LICENSE)