Apache APISIX 3.13.0 正式发布


Apache APISIX 3.13.0 版本已经发布,带来了一系列新功能、修复、以及相关用户体验优化。

此版本引入了多项新功能,包括 mcp-bridge和 lago插件、独立的 Admin API、状态健康检查端点、L4 代理健康检查等等。虽然本次更新没有引入任何重大变更,但部分功能已被标记为未来版本中将废弃。

弃用说明

1. 标记 server-info 插件为弃用

server-info插件已被标记为弃用,并将在未来的版本中移除。该插件会定期将服务器信息写入 etcd,在大型集群中可能会由于启动时 etcd 写入操作过多而导致性能问题。

更多信息请参见 邮件列表讨论[1]和 PR #12244

2. 在解耦 data_plane 模式下对执行 etcd 写操作进行警告

当 APISIX 以数据面实例运行在解耦模式时,如果通过 core.etcd 函数或 CLI 执行 etcd 写操作,将记录警告日志。未来版本中将弃用并禁止此类操作。

更多信息请参见 邮件列表讨论[2]和 PR #12241

新功能

1. 新增 standalone 模式 Admin API

本次版本为 standalone 模式引入了新的 Admin API,允许用户通过 HTTP PUT(更新)和 GET(获取)来管理内存中的配置。配置支持以 JSON 或 YAML 格式提交,会在验证后广播至同一 APISIX 实例中的所有 worker 进程,实现完全无状态的运行模式。该功能提升了对 Ingress Controller 等场景的支持能力。

更多信息请参见相关 PR #12179PR #12214PR #12256PR #12295PR #12317PR #12333

2. 支持 L4 代理的健康检查

APISIX 现已支持作为 L4 代理运行时对上游目标进行健康检查,从而提升 TCP/UDP 流量的可靠性并实现自动故障转移。

更多信息请参见 PR #12180

3. 新增状态健康检查端点

本次版本引入了一个健康检查 status 端点,用于指示 APISIX 是否已准备好接收流量。在 standalone 模式下,该端点在从外部客户端(如 Ingress Controller)加载配置后报告就绪状态;在使用 etcd 时,该端点会在所有工作进程完成初始配置加载之前一直处于非就绪状态。该功能有助于外部系统准确执行就绪性检查。

更多信息请参见 PR #12200

4. 新增 mcp-bridge 插件

本次版本引入了 mcp-bridge插件,用于将基于 stdio 的 MCP 服务器转换为基于 HTTP SSE 的接口,并支持子进程管理和跨 NGINX worker 的会话原型处理。为支持更广泛的使用场景,MCP 服务器已重构为独立模块,替换了原始的 mcp-bridge实现,采用更灵活的框架,同时通过现有测试保持向后兼容。

更多信息请参见 **PR [#12168](javascript:;) **和 PR #12151

5. 新增 lago 插件

本次版本引入了 lago插件,支持与 Lago 集成实现 API 商业化。该插件记录 API 调用,并基于配置的计费指标和订阅对消费者进行计费。它支持灵活的使用场景,例如面向 AI 服务的基于令牌的计费或基于调用次数的 API 计费,并允许将多个路由链接到不同的定价模型,以支持按需付费模式。

更多信息请参见 PR #12196

6. 为 loki-logger 插件添加 headers 属性

本次版本为 loki-logger插件新增了 headers属性。通过此功能,用户可以在将日志发送到远程 Loki 服务时设置授权等自定义请求头。

更多信息请参见 PR #12243

7. 为核心资源 schema 添加 metadata 字段

本次版本为核心资源 schema 添加了标准化的 metadata 字段,包括名称、描述和标签。此增强提升了资源的一致性,并解决了下游项目中的相关问题。

更多信息请参见 PR #12224

8. 为批处理器新增 max_pending_entries 属性

本次版本为批处理器新增了 max_pending_entries配置项,用于防止在日志服务器响应缓慢或无响应时引发内存激增。该配置允许在等待处理的回调数量过多时丢弃新的日志条目。

更多信息请参见 PR #12338

9. 增强 Admin API 过滤功能

Admin API 现在支持通过 service_id和 upstream_id过滤 routes 和 stream routes,使用户更容易查询和管理相关资源,特别是对 APISIX Dashboard 项目更为友好。

更多信息请参见 PR #12291

10. 在 Prometheus node_info 指标中暴露 APISIX 版本

本次版本增强了 Prometheus 的 node_info指标,增加了 version标签用于暴露当前 APISIX 版本,从而提升可观测性和版本追踪能力。

更多信息请参见 PR #12367

11. 支持在 consumer 用户名中使用连字符 (-)

本次版本允许在 consumer 的用户名中使用连字符(-)。该功能适用于 Kubernetes 等场景,可以通过类似 namespace-username的格式实现资源隔离。

更多信息请参见 PR #12296

依赖项更新

为提升稳定性、兼容性以及修复已知问题,本次版本升级了核心依赖项:

  • 升级 OpenResty 至 v1.27.1.2(PR #12307
  • 升级 LuaRocks 至 v3.12.0(PR #12305

其他更新

  • 通过比较服务发现节点的地址来提升性能(PR #12258
  • 将日志级别调整为 debug,以减少不必要的日志输出(PR #12361
  • 移除过期批处理器时,将日志级别从 warn调整为 infoPR #12297
  • 重构 ai-proxy插件,将 read_response移动到 ai_driver.request函数中(PR #12101
  • 当新增节点数量小于或等于 1 时,避免启动过期的健康检查器(PR #12118
  • 在节点数量为 0 时释放健康检查器资源(PR #12126
  • CLI 工具仅在启动时解析并验证 apisix.yaml文件(PR #12216
  • 限制 TLSv1.3 的跨 SNI 会话恢复(PR #12366
  • 修复 Kubernetes 服务发现单节点模式下的数据导出问题(PR #12284
  • 在 Consul 中处理 nil端口的情况,默认使用端口 80(PR #12304

变更日志:https://github.com/apache/apisix/blob/master/CHANGELOG.md#3130


相關推薦

2023-11-21

Apache APISIX 3.7.0 版本已经发布,带来了一系列新功能、Bug 修复和相关用户体验优化。该新版本添加了许多新功能,包括对 Consul 服务发现的 ACL 令牌的支持、openid-connect 插件中的授权参数、Nacos AK/SK 身份验证等,此外还包含了一

2024-05-01

Apache APISIX 3.8.1 版本已经发布。此新版本包含了一项重要修复,旨在进一步优化和提升用户体验。 修复 forward-auth 插件超时的问题 当客户端使用 POST 方法发送请求,但身份验证服务 API 实际上需要 GET 方法时,可能出现超时问题

2023-01-11

个版本 v1.5 发布,已经过了 3 个月,我们很高兴地宣布 Apache APISIX Ingress v1.6 正式发布! 在该版本中,共有 29 位贡献者 参与代码提交,其中 17 位是新晋贡献者 ,感谢大家的支持和参与! 本次发布的 Apache APISIX Ingress v1.6 版本

2022-11-19

作为开源的云原生 API 网关,Apache APISIX 致力于在性能和使用体验上为开发者和用户们带来更好更优异的表现,帮助企业解决一些关于云原生和微服务技术下遇到的新问题。 在 9 月底,Apache APISIX 发布了 3.0.0-beta 预览版,为用

2024-10-22

Apache APISIX 3.11.0 版本已经发布,带来了一系列新功能、修复、以及相关用户体验优化。这个新版本增加了许多新功能,包括添加一系列 AI 插件以集成 LLM 提供商、支持 AWS 和 GCP Secret Manager 进行 Secret 管理等等。 此外,该版本还

2023-07-26

Apache APISIX 3.2.2 现已发布,此版本包含了一系列的修复和优化。 修复 升级 lua-resty-jwt 依赖版本 将 lua-resty-jwt 的依赖版本从 0.2.4 升级到 0.2.5,避免 APISIX jwt-auth 插件中身份验证绕过的安全

2023-06-08

等丰富的流量管理功能。从其主要功能和特点角度来看,Apache APISIX 可以替代 Nginx 来处理南北流量,也可以扮演 Istio 控制平面和 Envoy 数据平面的角色来处理东西向流量。 Bugfix 修复 core.request.add_header 中的无效缓存问题。避

2023-03-18

内容感兴趣,请参考 3.2 发布的 CHANGELOG:https://github.com/apache/apisix/blob/release/3.2/docs/zh/latest/CHANGELOG.md#320

2023-07-25

Apache APISIX 3.4.1 版本现已正式发布,其中包含了针对 JWT 的安全补丁。 修复 升级 lua-resty-jwt 依赖版本 为了解决 APISIX jwt-auth 插件中身份验证绕过的安全风险,将 lua-resty-jwt 的依赖版本从 0.2.4升级到&nbs

2025-04-03

Apache APISIX 3.12.0 版本已经发布,带来了一系列新功能、修复、以及相关用户体验优化。 本次新版本增加了许多新功能,包括几个 AI 插件、openid-connect插件中对有效发行者的支持、速率限制响应头名称自定义的支持等等,以及包

2023-09-06

Apache APISIX 3.5.0 现已正式发布,此版本带来了一些新功能和改进的用户体验。包括在主机级别动态配置 TLS 版本、与 Chaitin WAF 的集成、强制删除资源、在独立模式下部署 APISIX 时在配置文件中使用环境变量等。此外,还包含了一

2022-11-05

直播嘉宾 ▲ 王晔倞(头哥), 支流科技技术 VP、Apache APISIX Committer   ▲  tison,Apache Member & Incubator Mentor,Apache Flink Committer,微信公众号 “夜天之书” 作者   ▲ 李志信, ioc-golang 作者,Apache Dubbo P

2024-08-29

升级 UI braces 3.0.2 到 3.0.3 升级 org.apache.kyuubi:kyuubi-hive-jdbc-shaded 1.7.1 到 1.9.2 升级 org.apache.maven.plugins:maven-compiler-plugin 3.12.1 到 3.13.0 升级 testcontainers.version 1.19.5 到 

2023-10-15

布。 详情查看 Python 3.13 发布日程(将于明年 10 月 1 日正式发布):https://peps.python.org/pep-0719/。