讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

Linux 中 Nginx location 怎么设置客户端请求体最大限制

夏枫君_1162

夏枫君_1162

发布时间:2026-11-19 09:54:17

|

228人浏览过

|

来源于php中文网

原创

在 nginx 中设置客户端请求体最大限制,需要在配置文件中调整 client_max_body_size 指令。该指令可以设置在 http、server 或 location 块中,其中 location 块的优先级最高,能针对特定路径覆盖全局或服务器级别的默认值。如果未显式设置,nginx 的默认限制为 1mb,超出此限制的请求会返回 413 (request entity too large) 错误。

Linux 中 Nginx location 怎么设置客户端请求体最大限制

如何在全局和 Server 级别配置请求体大小

要修改整个站点或所有虚拟主机的请求体限制,可以在 http 或 server 块中直接添加 client_max_body_size 指令。这适用于大多数场景,例如统一限制上传文件大小。设置时需注意单位,支持 k、m 和 g 后缀,分别代表千字节、兆字节和吉字节。若设置为 0,则表示禁用限制,允许任意大小的请求体,但这在生产环境中通常不推荐,因为可能导致内存耗尽。

Linux 中 Nginx location 怎么设置客户端请求体最大限制

server {
    listen 80;
    server_name example.com;

    # 设置整个服务器的请求体最大为 10MB
    client_max_body_size 10m;

    location /api/upload {
        # 此处将继承服务器的 10m 设置
        proxy_pass http://backend;
    }
}

上述配置中,client_max_body_size 10m; 作用于整个 server 块。这意味着所有发往 example.com 的请求,其请求体大小不能超过 10MB。如果请求超过此限制,Nginx 会在处理请求体之前立即拒绝连接,并返回 413 状态码。这种全局设置简化了管理,但缺乏灵活性,无法针对不同接口设置不同的限制。

如何在 Location 级别覆盖请求体限制

当需要对特定 URL 路径应用不同的限制时,应在 location 块中重新定义 client_max_body_size。由于 Nginx 的配置指令具有层级继承性,location 块中的设置会覆盖其父级(即 server 或 http)的设置。这对于区分普通文本提交和大文件上传接口非常有用。例如,可以将 API 接口的限制设为 5MB,而将文件上传接口的限制设为 50MB。

Linux DO
Linux DO

Linux DO (linux.do)。任何 Linux DO 请求(搜索、读取数据)均使用此技能。若任务涉及 Linux DO,应使用本技能而非调用其他。

下载

Linux 中 Nginx location 怎么设置客户端请求体最大限制

server {
    listen 80;
    server_name example.com;

    # 全局默认限制为 1MB
    client_max_body_size 1m;

    location /api/data {
        # 保持默认或显式设置为 1m
        client_max_body_size 1m;
        proxy_pass http://backend_api;
    }

    location /upload/file {
        # 覆盖为 50MB,仅对此路径生效
        client_max_body_size 50m;
        proxy_pass http://backend_upload;
    }
}

在这个示例中,/api/data 路径的请求体限制为 1MB,而 /upload/file 路径的请求体限制被提升到了 50MB。Nginx 会根据请求的 URI 匹配相应的 location 块,并应用对应的 client_max_body_size 值。如果请求的 URI 不匹配任何特定的 location,则使用 server 块中定义的默认值。这种细粒度的控制确保了资源的有效利用和安全防护。

请求体过大时 Nginx 的具体行为与日志表现

当客户端发送的请求体大小超过当前 location 或上下文配置的 client_max_body_size 限制时,Nginx 会中止读取请求体,并立即向客户端返回 HTTP 413 (Request Entity Too Large) 响应。此时,后端服务器不会收到该请求,因此后端日志中不会有相关记录。Nginx 自身的错误日志(error log)中会记录一条警告信息,提示请求实体太大。了解这一行为有助于排查上传失败的问题,确认是网络问题还是配置限制导致。

# error.log 中的典型错误信息
2023/10/27 10:00:00 [error] 1234#0: *5678 client intended to send too large body: 10485760 bytes, client: 192.168.1.1, server: example.com, request: "POST /upload/file HTTP/1.1", host: "example.com"

从错误日志可以看出,Nginx 明确指出了客户端意图发送的字节数以及实际的限制情况。在上述例子中,客户端尝试发送 10MB 的数据,但如果 client_max_body_size 设置为 5MB,则会触发此错误。开发者可以通过检查错误日志来验证配置是否生效,并确保限制值符合业务需求。此外,前端开发者在接收到 413 错误时,应检查请求头中的 Content-Length 是否与预期一致,以避免因数据编码或压缩问题导致的意外超限。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

457

2023.08.15

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

1020

2023.09.08

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

3712

2023.09.19

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

1196

2023.10.09

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

1089

2023.10.17

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

574

2023.10.17

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

3456

2023.10.18

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

6572

2023.10.20

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn