# file_server

**Repository Path**: jimonik/file_server

## Basic Information

- **Project Name**: file_server
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-17
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 本地文件服务器

基于 Python 3.12 标准库的轻量文件服务器，提供目录浏览、拖放/多文件上传、新建文件夹、单个及批量移动、重命名、删除、单文件下载、跨目录批量打包下载，以及不依赖扩展名的 UTF-8/ASCII 纯文本预览和在线编辑功能。

## 启动

项目使用已有的 `py312` Conda 环境，不需要安装第三方依赖：

```bash
conda activate py312
python main.py
```

浏览器打开 <http://127.0.0.1:8000>。按 `Ctrl+C` 停止服务。

服务默认监听 `0.0.0.0`，同一局域网中的设备可通过运行服务器电脑的 IP 访问，例如 <http://192.168.100.107:8000>。

服务器固定只共享项目中的 `files` 目录：

```text
/Users/jimo/PycharmProjects/file_server/files
```

把需要下载的文件放入这个目录即可。

如果还没有环境，可以先创建：

```bash
conda env create -f environment.yml
```

如需明确指定监听地址和端口，可运行：

```bash
python main.py --host 0.0.0.0 --port 8000
```

单个文件默认最多上传 10 GB，可通过参数调整，例如：

```bash
python main.py --max-upload-gb 20
```

然后在其他设备访问 `http://运行服务器的电脑IP:8000`。删除文件夹时会同时删除其中的所有内容。请只在可信网络中使用局域网模式；服务没有登录认证，任何能够访问服务的设备都可以管理共享文件。