File Server

上传、下载、在线预览，自动清理过期文件

上传文件

拖拽文件或点击选择

API 文档

所有上传统一使用 file 字段，支持三种 Content-Type

POST /f — 上传文件

三种方式任选其一：

方式一：multipart/form-data

curl -X POST -F "file=@photo.jpeg" http://localhost:8000/f

# 指定文件名
curl -X POST -F "file=@photo.jpeg" http://localhost:8000/f

方式二：application/json

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"file":"iVBORw0KGgo..."}' \
  http://localhost:8000/f

# 支持 data URI 格式
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"file":"data:image/jpeg;base64,/9j/4AAQ..."}' \
  http://localhost:8000/f

方式三：application/x-www-form-urlencoded

curl -X POST \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "file=SGVsbG8" \
  http://localhost:8000/f

上传参数

参数类型必填说明
filefile / string是multipart 传二进制，其他传 base64 字符串

返回格式

{
  "code": 0,
  "message": "success",
  "data": {
    "name": "a1b2c3d4e5f6.jpeg",
    "size": 2493435,
    "ext": ".jpeg",
    "mod_time": "2026-06-04T03:18:47+08:00",
    "url": "http://localhost:8000/f/2026/06/04/a1b2c3d4e5f6.jpeg"
  }
}

GET /f/:date/*filepath — 在线预览 / 下载

浏览器访问自动预览（图片、PDF、视频等），其他情况自动下载。加 ?dl=1 强制下载。

# 浏览器直接访问 — 自动预览
http://localhost:8000/f/2026/06/04/a1b2c3d4e5f6.jpeg

# 强制下载
curl -O http://localhost:8000/f/2026/06/04/a1b2c3d4e5f6.jpeg?dl=1

# 非预览文件 — 自动下载
curl -O http://localhost:8000/f/2026/06/04/abc123def456.zip