# python_upload_server

**Repository Path**: shoukaiseki/python_upload_server

## Basic Information

- **Project Name**: python_upload_server
- **Description**: 上传文件的服务,用于内网临时文件传输
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件服务器 (Python Flask)

基于 Flask 的本地文件 HTTP 服务器，支持文件上传、下载、目录浏览。

## 创建链接
### linux

```
chmod +x /data/usr/python_upload_server/shear_path
ln -s  /data/usr/python_upload_server/shear_path /usr/bin/shear_path
```

安装依赖
```
python3 -m venv /data/usr/python_upload_server/venv
source /data/usr/python_upload_server/venv/bin/activate
pip install -r requirements.txt

```

### windows
将C:\bin加入PATH环境变了

新建脚本 C:\bin\shear_path.cmd
```
@echo off
chcp 65001 >nul
python E:\gitwork\python_upload_server\run_server.py %*
```

## 文件说明

| 文件 | 说明 |
|---|---|
| `file_server.py` | Flask 服务主程序，含 API 和 Web 界面 |
| `run_server.py` | 灵活启动脚本，支持命令行参数指定共享目录和端口 |
| `start_server.cmd` | 批处理启动（硬编码共享目录，直接启动 `file_server.py`） |
| `run_server.cmd` | 批处理启动（透传参数给 `run_server.py`） |
| `requirements.txt` | Python 依赖 |

## 环境要求

- Python 3.x
- 安装依赖：`pip install flask werkzeug`

## 快速开始

```bash
# 1. 克隆代码后进入目录
cd python_upload_server

# 2. 安装依赖
pip install flask werkzeug

# 3. 启动（使用当前目录作为共享目录）
python run_server.py

# 4. 打开浏览器访问
# http://localhost:5550
```

## 启动方式

### 方式一：直接运行 Python 脚本

```bash
# 使用当前目录作为共享目录
python run_server.py

# 指定共享目录
python run_server.py -p D:/share

# 指定端口
python run_server.py --port 5566

# 组合使用
python run_server.py -p D:/share --port 5566
```

### 方式二：批处理脚本（Windows）

```bash
run_server.cmd                          # 使用当前目录
run_server.cmd -p D:/share             # 指定共享目录
run_server.cmd --port 5566             # 指定端口
```

### 方式三：直接启动（需修改 file_server.py 中的 SHARED_FOLDER）

```bash
python file_server.py
```

## 快捷命令（可选）

将启动命令配到 PATH 中，可在任意目录下直接运行。

### Windows

在 `D:\bin\` 下创建 `shear_path.cmd`：
```batch
@echo off
python E:\devwork\pywork\PythonDemo\run_server.py %*
```
然后将 `D:\bin` 添加到系统环境变量 PATH 中，即可在任意目录运行：
```bash
shear_path                          # 使用当前目录
shear_path -p D:/share             # 指定共享目录
```

### Linux

创建软链接或 shell 脚本到 PATH 目录（如 `/usr/local/bin/shear_path`）：
```bash
#!/bin/bash
exec /path/to/run_server.py "$@"
```
然后即可直接运行：
```bash
shear_path                          # 使用当前目录
shear_path -p /data/share          # 指定共享目录
```

## 部署到 Linux 服务器

```bash
# 上传文件到服务器（从本机复制）
scp file_server.py run_server.py root@服务器IP:/data/pyserver/

# 安装依赖
pip install flask werkzeug

# 启动
cd /data/pyserver && python run_server.py
```

## API 接口

### 上传文件
```bash
curl -F "file=@/path/to/file" http://localhost:5550/upload
```

### 下载文件
```bash
curl -O http://localhost:5550/download/filename
```
支持子目录文件下载：`/download/subdir/filename`

### 浏览目录
```bash
curl http://localhost:5550/browse/subdir
```

### 文件列表
```bash
# 根目录
curl http://localhost:5550/files

# 指定子目录
curl http://localhost:5550/files?path=subdir
```

### Web 界面
浏览器访问 `http://localhost:5550`，提供图形化上传、下载和目录浏览功能。