nginx

关注公众号 jb51net

关闭
首页 > 网站技巧 > 服务器 > nginx > nginx 文件上传大小限制

Nginx 文件上传大小限制及 client_max_body_size最大值问题记录

作者:Hello.Reader

这篇文章主要介绍了Nginx 文件上传大小限制及 client_max_body_size最大值问题,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下

一、默认值与错误提示

HTTP/1.1 413 Request Entity Too Large
Content-Type: text/html

二、如何配置 client_max_body_size

该指令可放置在 httpserverlocation 块中,后者会覆盖前者的配置:

http {
    # 全局设置,作用于所有 server
    client_max_body_size 50m;
    server {
        listen 80;
        server_name example.com;
        # 针对某个虚拟主机单独设置
        client_max_body_size 100m;
        location /upload {
            # 针对特定路径再度覆盖
            client_max_body_size 200m;
            proxy_pass http://backend;
        }
    }
}

说明:在嵌套块中声明的 client_max_body_size 会覆盖祖先块中的同名指令citeturn1search1。
单位:支持 kmg(不区分大小写),如 10K2m1G

三、client_max_body_size 的最大上限

Nginx 在内部将该值存储为 C 语言类型 off_t,其位宽决定了上限:

64 位可执行文件

32 位可执行文件(未启用大文件支持)

四、取消大小检查(无限制上传)

client_max_body_size 设置为 0,可禁用对请求体大小的检查,允许无限制上传或 POST 请求:

server {
    listen 80;
    server_name unlimited.example.com;
    # 取消大小限制
    client_max_body_size 0;
    location / {
        proxy_pass http://backend;
    }
}

说明:设置为 0 时,Nginx 不再在自身层面拦截任何大小的请求体。

五、实战示例

按需放宽单接口限制

server {
    listen 80;
    server_name upload.example.com;
    # 默认允许 10MiB
    client_max_body_size 10m;
    location /api/v1/upload {
        # 单接口放宽至 500MiB
        client_max_body_size 500m;
        proxy_pass http://backend_upload;
    }
}

开启无限制上传

server {
    listen 80;
    server_name files.example.com;
    # 完全取消 Nginx 层面的大小限制
    client_max_body_size 0;
    location /files {
        proxy_pass http://backend_files;
    }
}

六、配置验证

# 检查配置语法
nginx -t
# 重载 Nginx(应用新配置)
nginx -s reload

随后可使用 curl 或前端上传大文件,确认是否仍出现 413 错误,并查看 /var/log/nginx/error.log 以排查问题。

七、小结

通过上述配置与示例,您可以灵活地调整或取消 Nginx 的上传大小限制,满足从小型表单到超大文件传输的各种业务需求。

到此这篇关于Nginx 文件上传大小限制及 client_max_body_size最大值问题记录的文章就介绍到这了,更多相关nginx 文件上传大小限制内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:
阅读全文