API 网关
API 网关
文档指南
请输入
- 文档首页
API 网关用户指南插件中心流量管控全局限流插件
复制全文
下载 pdf全局限流插件
文档反馈
问问助手全局限流插件通过预设带宽阈值、请求频率上限、连接数限制等指标，对所有接入的流量进行统一管控，避免单一路径或用户过量占用资源导致整体性能下降、服务不可用，保障系统全局稳定运行与资源公平分配。本文介绍如何配置全局限流插件。
前提条件
- 已创建用于安装插件的 Redis 数据库，并获取账号和密码。
- （可选）使用 Token 数限流功能，需要创建后端服务为 AI 模型代理 的 Upstream 支持该功能，创建方式参见 AI 模型代理。
操作步骤
第一步：安装插件
- 登录 API 网关控制台。
- 在顶部导航栏，选择目标地域。
- 在左侧导航栏 实例管理 下拉框中选择目标实例后， 单击 插件中心 > 流量管控 > 全局限流插件。
- 单击 安装插件 ，在配置页面填写已创建 Redis 数据库的地址、端口和登录信息。
- 单击 确定，完成操作。
第二步：创建插件
- 在 全局限流插件 页面，单击 创建插件。
- 配置限流规则。
说明
支持通过 或 的方式配置多个限流规则。
- 配置项说明所属服务选择插件所属服务。所属路由选择插件所属路由。限流配置根据业务场景，配置限流规则。
- 限流维度：当前仅支持 Header 维度限流。
- 限流对象：支持以下限流对象。
- Token 数：支持基于 Token 数进行限流。仅后端服务为 AI 模型代理 的 Upstream 支持该功能。创建 AI 模型代理 Upstream 的方式参见 AI 模型代理。
- 入向带宽限流：支持对 Upstream 进行带宽限流。
- 请求数：支持对 Upstream 进行请求数限流。
Header Value限流对象请求头的取值。限流阈值配置当前实例在 1 个时间周期内，请求允许的 Token 数、入向带宽或者访问次数。超过阈值后，访问请求将被拒绝。
- 单击 确定，完成配置。
查看配置
配置完成后，在插件列表中，查看已配置的插件，若插件状态为 已启用，表示插件已生效。
最近更新时间：2026.10.19 10:35:47
这个页面对您有帮助吗？
有用
有用
无用
无用