# open-file-server

**Repository Path**: numen06/open-file-server

## Basic Information

- **Project Name**: open-file-server
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Open File Server

一个只依赖 Python 标准库的轻量文件服务，提供手机端文件管理页面与 curl 上传接口。

功能：目录浏览、新建目录、上传、预览、下载、复制地址、重命名和删除。下载不需要认证；上传及其他写操作也未启用认证，请只部署在可信网络，或在反向代理层增加访问控制。

## Docker 运行

```bash
docker run -d --name open-file-server \
  -p 8088:80 \
  -v ./data:/srv \
  --restart unless-stopped \
  open-file-server:latest
```

访问 `http://localhost:8088/`。

也可以使用 Compose：

```bash
docker compose up -d
```

## curl 上传

上传到根目录，默认覆盖同名文件：

```bash
curl -F "file=@./你的文件" "http://localhost:8088/upload/"
```

上传到当前子目录时，将目录加在 `/upload/` 后：

```bash
curl -F "file=@./你的文件" "http://localhost:8088/upload/目录名/"
```

- `?overwrite=false`：同名时返回 409，不覆盖。
- `?rename=true`：同名时自动生成 `文件名 (1).扩展名`。
- `MAX_UPLOAD_BYTES`：最大上传字节数，默认 1 GiB。