限流

设置 API Key 请求限额,并选择内存或 Redis 计数后端。

/admin/rate-limits 配置 API Key 流量:一条默认限额,以及 AI 生成、AI 状态和资源上传的覆盖值。登录和 Webhook 的保护使用独立运行路径,本页面不编辑这些规则。

准备工作

  • 查看页面需要有 config.read 的账号,修改后端需要 config.write。见角色与权限。
  • 默认后端为进程内内存。多实例需要 Redis 共享计数。

设置

先看已有的规则

打开 /admin/rate-limits。表单列出默认限额和三个端点覆盖值。这些值存在后台配置中,不是独立 rate_limit_rules 审计表中的记录。

选择后端

内存只在单个进程内计数。不同 Workers isolate 或 Node 容器有各自的计数器。选择 Redis 并填写连接地址后,实例可共享计数。

URL 作为后台配置里的 secret 保存,不会回传给浏览器。页面只显示 URL 是否已配置。

调整规则

设置默认请求上限和时间窗口,再调整需要单独限制的端点。

此页面配置的 API Key 限额

键端点模式默认值
默认 API Key 限额其他使用 API Key 的请求每 1 秒最多 100 次
ai_generate/api/{scene}/generate未修改前继承默认值
ai_status/api/status未修改前继承默认值
assets_upload/api/assets/upload未修改前继承默认值

各项请求上限允许 1–10,000 次,时间窗口允许 1–3,600 秒。

后端

Prop

Type

增加默认规则时,更新 defaultRateLimitRules 并调用 insertMissingRateLimitRules。已部署环境会补入新规则,不覆盖运营已有的调整。

验证

  1. 打开 /admin/rate-limits,能看到三个端点覆盖值和一条默认 API Key 限额。
  2. 不填 URL 就把后端切到 Redis。页面拒绝保存,不会回退到内存。
  3. 填入 Redis URL 后刷新页面。页面显示 URL 已配置,但不显示 URL 本身。

参考

下一步