网页上传文件的两种方式:流式与表单、前台直传与后台任务
在网页里把文件传进挂好的存储,看似一键的事,实际有几个影响体验的选项值得了解。

两种上传通道
添加存储或站点设置里可选 stream 与 form 两种上传方式:
| 方式 | 原理 | 特点 |
|---|---|---|
| stream | 文件二进制直接进请求体 | 服务器内存占用小,正常情况首选 |
| form | 文件包成表单上传 | 内存占用更高,但不受请求体大小限制 |
经验法则:普通文件用 stream;遇到超大文件 stream 报错时切 form 试试。
上传的真实路径:服务器中转
关键认知:所有上传都经过 OpenList 服务器中转——浏览器先把文件传到你部署 OpenList 的机器,机器再上传到网盘 API。两个推论:
- 上传速度受「你到服务器」和「服务器到网盘」两段中较慢的那段限制
- 消耗的是服务器流量,放在按流量计费的 VPS 上要留意
「添加为任务」
上传弹窗里勾选「添加为任务」后,文件先落服务器临时目录,转存网盘的过程作为后台任务执行,可以在后台任务面板看到进度;不勾选则直接同步上传。大批量传文件时勾上它,关掉网页也不怕中断。
允许访客上传
想把站点变成「收集箱」让别人也往里传文件:在 用户权限体系 给游客(guest)账号勾选「创建目录或上传」权限,或用 元信息 的开放写入功能对特定目录放开。公开收集目录建议单独建一个存储路径,与私人文件隔离。