nginx 限制上传文件大小

前言

nginx 使用client_max_body_size属性限制上传文件大小。
client_max_body_size属性说明参考这里。

client_max_body_size使用说明

语法

client_max_body_size size;

示例

client_max_body_size 1m;

上下文

client_max_body_size属性可以出现在http, server, location中。出现在不同的位置，表示其作用域不同。

client_max_body_size的作用域

http, server, location三者的关系如下：

http{
    server{
        location / {
        }
    }
}

• http的作用域 > server的作用域
• server的作用域 > location 的作用域

http{
    client_max_body_size 1M;
    server{
        server_name localhost;
        client_max_body_size 10M;
        location =/upload {
            client_max_body_size 100M;
        }
    }
}

• http 作用域范围内，上传的文件最大为1M
• server 作用域范围内（使用 http://localhost/xxx 访问的应用），上传的文件最大为10M
• location 作用域范围内（使用 http://localhost/upload 访问的应用），上传的文件最大为100M

client_max_body_size的默认值

client_max_body_size的默认值为1M。

client_max_body_size的特殊值0

当 client_max_body_size 设置为 0 时，将不限制上传文件大小。

413错误

如果上传文件大小超过允许值时，将返回给客户端413错误。