OpenList 中文文档 下载 App

网页上传文件的两种方式:流式与表单、前台直传与后台任务

在网页里把文件传进挂好的存储,看似一键的事,实际有几个影响体验的选项值得了解。

前端上传弹窗界面
网页端上传弹窗

两种上传通道

添加存储或站点设置里可选 stream 与 form 两种上传方式:

方式原理特点
stream文件二进制直接进请求体服务器内存占用小,正常情况首选
form文件包成表单上传内存占用更高,但不受请求体大小限制

经验法则:普通文件用 stream;遇到超大文件 stream 报错时切 form 试试。

上传的真实路径:服务器中转

关键认知:所有上传都经过 OpenList 服务器中转——浏览器先把文件传到你部署 OpenList 的机器,机器再上传到网盘 API。两个推论:

「添加为任务」

上传弹窗里勾选「添加为任务」后,文件先落服务器临时目录,转存网盘的过程作为后台任务执行,可以在后台任务面板看到进度;不勾选则直接同步上传。大批量传文件时勾上它,关掉网页也不怕中断。

允许访客上传

想把站点变成「收集箱」让别人也往里传文件:在 用户权限体系 给游客(guest)账号勾选「创建目录或上传」权限,或用 元信息 的开放写入功能对特定目录放开。公开收集目录建议单独建一个存储路径,与私人文件隔离。

上传出问题