Web 服务器与网关 / 系统课时

为关键接口加入基础限流

为关键接口加入基础限流

统一入口可以先为高成本路径限制请求速率,让应用在突发流量下保留处理余量。本篇用无副作用的计算接口观察允许、拒绝与恢复,同时确认健康路径不被误伤;真实登录接口还需要账号维度和业务风控的配合。

学习目标

  • 对精确 API 路径启用独立的速率区。
  • 从响应和日志确认拒绝发生在代理入口。
  • 验证恢复与无关路径,并识别单 IP 策略的局限。

使用无副作用接口练习

沿用本章 backend.py 的 /api/expensive,它计算固定整数和并返回 work=4999950000,不执行真实登录、支付或消息发送。启动回环 9001 实例;需要 Nginx 1.28、curl、Linux shell 与空闲回环 8080。

先运行 mkdir -p /tmp/nginx-entry-limit,预期目录存在且无输出;确保实验 Worker 可写。以下完整 http 片段替换独立实验站点:

nginx
limit_req_zone $binary_remote_addr zone=expensive_rate:1m rate=2r/s;
log_format limit_entry '$request_uri $status $limit_req_status';
server {
    listen 127.0.0.1:8080;
    server_name app.test;
    access_log /tmp/nginx-entry-limit/access.log limit_entry;
    location = /api/expensive {
        limit_req zone=expensive_rate burst=1 nodelay;
        limit_req_status 429;
        proxy_pass http://127.0.0.1:9001;
    }
    location = /health { return 204; }
}

限制按实际来源地址分组。使用真实代理 handler 而非 return 200,确保请求经过限流阶段;nodelay 只取消允许突发的等待,不会免除额度占用。

额度允许才进入计算后端,超额在入口返回 429

对照突发、等待与健康请求

检查并重载后,在限流区新建或该来源额度已恢复时执行完整命令:

bash
for i in $(seq 1 8); do
  curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -o /dev/null -w '%{http_code}\n' http://app.test:8080/api/expensive
done
sleep 2
curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -o /dev/null -w 'recovered=%{http_code}\n' http://app.test:8080/api/expensive
curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -o /dev/null -w 'health=%{http_code}\n' http://app.test:8080/health

预期结果:短突发中出现 200 与 429,具体顺序取决于间隔;等待后 recovered=200,健康路径 health=204。超过速率的行为与日志变量见 官方限流说明。

同时检查日志中 /api/expensive 对应 PASSED 或 REJECTED;健康路径没有应用限流,其状态字段不必与计算接口相同。不要仅凭任意一个 429 推断已经覆盖所有入口和实例。

将基础策略并入实际入口

整合到 HTTPS 站点时,zone 定义放在 http,共享同一键策略,把 limit_req 放到真实计算或登录代理 location;保留正确 URI、Host 和来源还原。先检查更具体的 location 是否覆盖了这条规则。

多台 Nginx 不会仅靠同名 zone 自动共享全局额度。共享出口可能误伤不同用户,攻击者也可能分散 IP;账号级、设备级和业务任务并发需要可靠认证与应用策略,而非信任任意请求头。

以观测决定正式阈值

记录正常速率、突发长度、拒绝率、应用耗时和客户端重试行为。用 dry run 和受控范围验证后再启用正式阈值;客户端收到拒绝应退避,而非立刻无限重试。

本例每秒两次只为了易于观察。发布前还要测试长期超额、等待恢复、正常用户、其他路径和各入口实例;限速不能代替并发、超时、认证或后端容量保护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为关键接口加入基础限流

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通