必须在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 余量，防止边界情况失败
