限流
设置 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。已部署环境会补入新规则,不覆盖运营已有的调整。
验证
- 打开
/admin/rate-limits,能看到三个端点覆盖值和一条默认 API Key 限额。 - 不填 URL 就把后端切到 Redis。页面拒绝保存,不会回退到内存。
- 填入 Redis URL 后刷新页面。页面显示 URL 已配置,但不显示 URL 本身。