跳到主要内容
版本:3.20.0

插件全局规则

本文档将介绍 APISIX 中插件全局规则的基本概念以及为什么需要它们。

在文档末尾探索其他资源,以获取有关相关主题的更多信息。

概述​

在 APISIX 中,全局规则(Plugin Global Rules)对象用于为传入请求配置插件,这些插件独立于绑定到路由、服务、消费者、消费者组或插件配置的插件。限流和可观测性插件通常会全局启用,以便在所有 API 上应用一致的行为。

在同一阶段内,全局插件先于局部插件运行。完整顺序为:全局 rewrite、局部 rewrite、全局 access、局部 access。因此,全局 access 处理程序不会先于局部 rewrite 处理程序运行。优先级仅用于排列同一阶段和作用域内的插件;提前返回响应会阻止后续处理程序运行。有关详细信息,请参阅插件执行顺序。

下图展示了一个示例:为所有传入请求全局启用 key-auth 插件,并在路由上配置 proxy-rewrite 插件。两个插件都在 rewrite 阶段运行,因此全局 key-auth 实例先于路由级 proxy-rewrite 实例运行:

key-auth 全局规则图解

此配置确保只有经过身份认证的请求才能与上游服务交互。如果身份认证失败,APISIX 会在执行路由级 rewrite 或将请求代理到上游之前拒绝该请求。如果向 APISIX 发送请求:

  • 没有任何密钥或密钥错误,请求将被拒绝。
  • 带有 global-key 但请求不存在的路由,请求通过身份认证,但 APISIX 返回错误警告用户找不到路由。
  • 使用 global-key 请求现有路由,全局身份认证插件会验证凭证,路由插件会修改请求头,随后 APISIX 将请求转发到上游服务。

上面的示例在全局规则和路由中使用了两个不同的插件。如果同一个插件在两个对象中都配置了,则该插件的两个实例将按顺序执行,而不是相互覆盖。

其他资源​