必须在location块中配置client_max_body_size及配套超时、缓冲参数才能实现大文件上传：如location /api/upload { client_max_body_size 500m; client_body_timeout 600s; proxy_read_timeout 3600; proxy_send_timeout 3600; client_body_buffer_size 1m; client_body_temp_path /var/nginx/tmp 1 2; }，并同步调整后端限制。

直接在 location 块里设 client_max_body_size，再配上几个关键超时和缓冲参数，才能真正让大文件上传跑通。只改大小，90% 还是会卡住或报错。

必须写在 location 块里才生效

很多人把 client_max_body_size 放在 http 或 server 块，结果上传接口还是返回 413。Nginx 的匹配优先级是 location > server > http，你访问的是 /api/upload，就得在这个 location 里明确写：

• location /api/upload { client_max_body_size 500m; proxy_pass http://backend; }
• 多个上传路径（如 /upload、/chunk、/file）要各自单独配置，不能漏
• 单位必须用小写：500m 合法，500M 或 500MB 会导致 Nginx 启动失败

配套超时参数一个都不能少

client_max_body_size 只管“让不让进”，但大文件传得慢，Nginx 在接收和转发过程中容易超时断连。这几个 timeout 必须和它写在同一个 location 块里：

Browser Setup (No-Root Linux)

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

• client_body_timeout 600s;：读取请求体的超时，建议设为 600 秒以上
• proxy_read_timeout 3600;：Nginx 等待后端响应的时间，大文件处理耗时长，至少设 3600（1 小时）
• proxy_send_timeout 3600;：Nginx 向后端发送完整请求体的超时，同样建议 3600
• 别忘了前端调用方（比如 axios）也要同步延长 timeout，否则请求在客户端就中断了

缓冲和临时路径要同步调优

光有大小和超时还不够，Nginx 接收大 body 时要用内存缓存或写磁盘，这里容易出权限、空间、性能问题：

• client_body_buffer_size 1m;：建议设成 512k～1m。太小（默认 8k）会频繁刷盘；太大浪费内存
• client_body_temp_path /var/nginx/tmp 1 2;：确认该路径磁盘空间充足，且 Nginx 运行用户（如 www-data 或 nginx）有读写权限，否则日志里会报 open() failed (13: Permission denied)
• 如果 POST 请求带大量 header（比如长 JWT、多层代理头），还要检查 large_client_header_buffers 8 16k;，避免触发 400 错误

后端限制必须同步放宽

Nginx 放行后，请求才会到后端。如果后端自己卡住，照样失败，而且错误表现可能变成 502、500 或静默失败：

• PHP：同时调大 upload_max_filesize 和 post_max_size（后者 ≥ 前者），单位用 M
• Spring Boot：spring.servlet.multipart.max-file-size 和 max-request-size 都要设，单位必须是 MB 或 GB
• Node.js（Express + Multer）：初始化中间件时显式指定 limits: { fileSize: 500 * 1024 * 1024 }
• 数值建议比 Nginx 设置值多留 10–20MB 余量，防止边界情况失败