upload_max_file_size

`upload_max_file_size` 指令设置 NGINX upload 模块中允许上传的最大文件大小。

语法upload_max_file_size size;
默认值none
上下文http, server, location, if in location, limit_except
参数1

说明

upload_max_file_size 指令指定通过 NGINX upload 模块可以上传的文件的最大大小(以字节为单位)。如果文件超过此限制,将向客户端发送 413 (Payload Too Large) 错误响应,而不是处理上传。该指令对于控制资源使用非常重要,可确保服务器在不被过大文件压垮的情况下高效地处理上传请求。

该指令可以在多个上下文中定义,包括 httpserverlocationif in locationlimit_exceptupload_max_file_size 的参数必须是一个以单位后缀的单一数值(k、m、g 分别表示千字节、兆字节或吉字节)。该配置允许系统管理员根据服务器容量和应用需求设置适当的限制,在可用性与防止意外资源消耗之间取得平衡。

在上传文件时,如果传入请求的总大小超过此限制,模块将中止上传处理并返回指定的 HTTP 错误。建议根据应用需求设置合理的限制,因为限制过高可能导致服务器资源被过度使用,而限制过低则可能限制合法的使用场景。

配置示例

http {
    upload_max_file_size 10m;
}

在错误的上下文中设置 upload_max_file_size(例如在 location 块中设置,而它应该在 http 中)可能会导致意外行为。

如果未设置任何值,上传可能会不受大小限制地成功,这可能导致资源耗尽。

请确保将此指令与 client max body size 设置一起检查。

← 返回所有指令