限制上传大小与请求速率

区分请求体大小限制和按地址限速,理解 413 与 429 并验证规则。

🎯 引言

假设一个笔记网站既能上传附件,也能查询笔记。一次上传几 GB 的附件会占用大量带宽和存储资源。即使查询请求几乎不带数据,短时间内连发上千次也会让后台忙不过来。

  • 请求体大小限制管一次请求能带多少数据。第一个实验会用过大的请求触发 413。
  • 请求速率限制管同一来源的请求能以多快的频率被放行。第二个实验会用密集请求触发 429。

手工搭建的实验在 Bash 中执行 cd "$HOME/nginx-course"。使用下载包时,在 Bash 中进入解压目录。下载包已设置本篇的大小和速率规则,核对已有配置即可,仍需创建第一个实验的临时文件和路径。


🧱 限制单次请求携带的数据

请求体是请求携带的数据,例如上传的文件或提交的表单内容。在 conf/servers/site.conf 的 server 中设置下面这行。如果前面的练习已经设为 2m,直接把它改为 1m。

client_max_body_size 1m;

1m 是 Nginx 的默认值,表示 1 MiB(1,048,576 字节)。这里显式写出它,方便在练习里修改。请求体超过这个上限时,Nginx 返回 413 Content Too Large。旧资料中也叫 Payload Too Large,实验的响应行可能显示 Request Entity Too Large,以数字 413 为准。 Nginx 大小限制文档 · RFC 9110

实验只验证 Nginx 会不会拦下过大的请求,借用一个静态文件地址即可。Nginx 可以从这次 POST 的 Content-Length 得知请求体有多大,并在静态文件处理之前返回 413。在同一个 server 中加入临时路径,try_files $uri =404 负责查找对应文件,找不到就返回 404。

location = /body-check.txt {
    try_files $uri =404;
}

在课程目录里创建测试用的静态文件,再用 dd 生成一份 2 MiB 的数据,作为稍后发送的请求体。

mkdir -p temp
printf 'body check\n' > html/body-check.txt
dd if=/dev/zero of=temp/large.bin bs=1048576 count=2

手工搭建的实验执行 ngx -t && ngx -s reload。下载包执行 sh ./ngx -t && sh ./ngx -s reload。后面每次修改配置,都用同一条命令检查并重载。重载后发送请求。

curl -i -H 'Expect:' --data-binary @temp/large.bin http://127.0.0.1:8080/body-check.txt

--data-binary @temp/large.bin 让 curl 把文件内容放进 POST 请求体。-H 'Expect:' 省去发送请求体前的等待。响应行应显示 413,因为 2 MiB 超过了 1 MiB。保留临时路径和文件,文末会用同一个请求做对照。


🧰 给接口设置按来源限速

假设规定每个 IP 平均每秒可处理 2 次请求。新请求到达时,Nginx 要看这个 IP 前面的请求有多密集、已经过去多久,再决定这次能否放行。同一个 IP 的请求可能由不同的工作进程处理,所以这些进程要共用同一份限速记录。

在 conf/nginx.conf 的 http 块里定义这份记录和限速规则。

limit_req_zone $binary_remote_addr zone=api_rate:10m rate=2r/s;
  • $binary_remote_addr 用连接到 Nginx 的客户端 IP 区分来源,每个 IP 单独记账。
  • zone=api_rate:10m 给这块共享内存取名 api_rate,分配 10 MiB 存放各个 IP 的限速记录。
  • rate=2r/s 表示每个 IP 的长期速率是每秒 2 次,约每过半秒就能消化一次超额请求。限速状态随经过的时间变化,整秒时也不会重置。

上面的配置定义了规则。在 conf/servers/site.conf 已有的 location ^~ /api/ 块中应用它。

limit_req zone=api_rate burst=4 nodelay;
limit_req_status 429;

burst=4 给每个 IP 留出 4 个额外的突发名额。假设一个 IP 此前没有累积超额请求,突然几乎同时发来 8 个请求。第 1 个正常放行,第 2 到第 5 个占用突发名额,第 6 到第 8 个被拒绝。实际结果取决于请求间隔和这个 IP 已有的限速状态。

省略 nodelay 时,占用突发名额的请求会排队,按约每半秒一个的节奏放行。加上 nodelay 后,它们可以立即转发,但占用的名额仍按 2r/s 的速率逐步腾出。所以上面能瞬间放行 5 个,长期速率仍是 2r/s。 Nginx 突发限速示例

Nginx 默认对限速拒绝的请求返回 503。这里用 limit_req_status 429 将它改为 429 Too Many Requests。 Nginx 限速模块文档


🧪 验证速率限制

检查并重载配置,等几秒让已有的突发名额腾出,再向本机的笔记接口连续发 20 次请求。请在 Bash 中执行,{1..20} 会展开为 1 到 20,在 sh 中可能只执行一次。

for n in {1..20}; do
    curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/api/notes
done

-w '%{http_code}\n' 让 curl 每次只打印一行状态码。实验中会看到两种结果。

  • 200 表示请求通过限速检查,Nginx 把它转发给模拟后台,后台成功返回。入口访问日志会记录上游地址和 us=200。
  • 429 表示同一 IP 的请求来得太密集,突发名额已满,Nginx 在转发前就拒绝了这次请求。入口访问日志会显示 upstream=- us=-,错误日志会记录 limiting requests。

两种状态码的数量会随实际请求间隔变化。如果只有 200,先确认限速指令已生效,再查看请求是否发得足够密集。如果只有 429,等几秒再试。

多名用户共用一个公网 IP 时,会共用这份限速额度。如果 Nginx 前面还有代理,这里的规则可能会把代理后的用户都算到代理的 IP 上。


❓ 知识问答

前端把文件限制到 1 MiB 就够了吗?

不够。访问者可以绕开网页直接发请求,服务器和应用都要设置合适的限制。


🧪 小练习

把 client_max_body_size 临时调成 3m,检查并重载,再发送同一份 2 MiB 请求。此时应看到 405 Method Not Allowed。请求通过了大小检查,随后由静态文件处理程序拒绝了 POST。对比两次结果,想一想 413 和 405 各出现在哪一步。

练习结束后,把大小限制改回 1m,删除临时的 location = /body-check.txt 块,检查并重载。然后在课程目录删除两个临时文件。

rm html/body-check.txt temp/large.bin