upload_store
`upload_store` 指令指定上传文件的临时存放目录。
NGINX module for handling file uploads
·
httpserverlocationif in locationlimit_except
语法upload_store [options];
默认值none
上下文http, server, location, if in location, limit_except
参数1-4
说明
upload_store 指令属于 NGINX 的 upload 模块,旨在处理使用多部分表单数据编码的文件上传。当客户端上传文件时,此指令使 NGINX 能将这些文件保存到服务器上的指定目录。所提供的路径可以是静态的,也可以使用 NGINX 的变量语法动态生成,从而在文件管理上提供灵活性。该指令最多接受四个参数,第一个参数为存放上传文件的目录路径,其他参数用于控制属性,例如设置权限、文件命名约定和文件轮换策略。
文件一旦存储在指定目录后,可以直接进行管理,例如进一步处理或提供给客户端。如果该目录没有适当的写权限,文件上传将失败。重要的是要确保 NGINX 对上传目录具有必要的访问权限,且最佳实践是定期清理该目录中的文件,以防止其随时间被填满。upload_store 指令通常与其他指令配合使用,例如 upload_pass(定义上传完成后将请求转发到何处)和 upload_cleanup(指定处理后如何管理临时文件)。
配置示例
location /upload {
upload_store /tmp/uploads;
upload_pass /handle_upload;
}⚠
确保指定的目录存在并具有适当的写权限;否则,上传将失败。
⚠
存放在上传目录中的文件不会被自动清理,除非通过 upload_cleanup 进行配置。
⚠
检查安全设置,避免将上传目录暴露给未授权的访问者。