blog: add 3.13.0 release notes (#1927)

kayx23 · web-flow · commit 6d320dc99f61 · 2025-06-27T14:35:34.000+05:30
diff --git a/blog/en/blog/2025/06/27/release-apache-apisix-3.13.0.md b/blog/en/blog/2025/06/27/release-apache-apisix-3.13.0.md
@@ -0,0 +1,134 @@
+---
+title: "Release Apache APISIX 3.12.0"
+authors:
+  - name: "Ashish Tiwari"
+    title: "Author"
+    url: "https://github.com/Revolyssup"
+    image_url: "https://github.com/Revolyssup.png"
+  - name: "Traky Deng"
+    title: "Technical Writer"
+    url: "https://github.com/kayx23"
+    image_url: "https://github.com/kayx23.png"
+keywords:
+  - Apache APISIX
+  - API Gateway
+  - API Management Platform
+  - New Release
+  - Cloud Native
+description: The Apache APISIX 3.13.0 version is released on June 27, 2025. This release includes a few changes, new features, bug fixes, and other improvements to user experiences.
+tags: [Community]
+---
+
+We are glad to present Apache APISIX 3.13.0 with exciting new features, bug fixes, and other improvements to user experiences.
+
+<!--truncate-->
+
+This release introduces a number of new features, including the `mcp-bridge` and `lago` plugins, the standalone Admin API, status health check endpoint, L4 proxy health check, and more.
+
+While there are no breaking changes, a few features have been marked for deprecation for future releases. Please review the deprecation notes to stay informed about future changes.
+
+## Deprecations
+
+### Mark the `server-info` plugin as deprecated
+
+The `server-info` plugin is now marked for deprecation and will be removed in a future release. It periodically writes server info to etcd, which can cause performance issues in large clusters due to excessive etcd writes during startup.
+
+For more information, see the [mailing list proposal](https://lists.apache.org/thread/nrwqo1gbc0z4z48fkb8dd4rn0trnfnz9) and [PR #12244](https://github.com/apache/apisix/pull/12244).
+
+### Warn on etcd write operations in decoupled `data_plane` mode
+
+When APISIX is running in the decoupled mode as the data plane instance, it now logs warnings if the data plane instance performs etcd write operations via core.etcd functions or the CLI. Writes will be deprecated in future releases, where such operations will be disallowed.
+
+For more information, see the [mailing list proposal](https://lists.apache.org/thread/gfsooqm4cz6cx2sh7htmqgwlml5kggm2) outlining the future enforcement plan and [PR #12241](https://github.com/apache/apisix/pull/12241) for change in this release.
+
+## New Features
+
+### Add standalone Admin API
+
+This release introduces a new Admin API for standalone mode, allowing users to manage in-memory configurations via HTTP PUT (to update) and GET (to retrieve). Configurations can be submitted in JSON or YAML, validated, and broadcast to all workers within the same APISIX instance—making the mode fully stateless. This feature improves support for use cases such as the Ingress Controller.
+
+For more information, see relevant PRs [#12179](https://github.com/apache/apisix/pull/12179), [#12214](https://github.com/apache/apisix/pull/12214), [#12256](https://github.com/apache/apisix/pull/12256), [#12295](https://github.com/apache/apisix/pull/12295), [#12317](https://github.com/apache/apisix/pull/12317), and [#12333](https://github.com/apache/apisix/pull/12333).
+
+### Support health check for L4 proxy
+
+APISIX now supports upstream health checks when operating as an L4 proxy, enabling improved reliability and automatic failover for TCP/UDP traffic.
+
+For more information, see PR [#12180](https://github.com/apache/apisix/pull/12180).
+
+### Add status health check endpoint
+
+This release introduces a health check endpoint that indicates when APISIX is ready to serve traffic. In standalone mode, it reports readiness after configuration is loaded from external clients (e.g., Ingress Controller). When using etcd, the endpoint remains unhealthy until all workers have completed the initial configuration load. This helps external systems perform accurate readiness checks.
+
+For more information, see [#12200](https://github.com/apache/apisix/pull/12200).
+
+### Add `mcp-bridge` plugin
+
+This release introduces the `mcp-bridge` plugin, which converts stdio-based MCP servers to HTTP SSE-based interfaces, with support for subprocess management and prototype session handling across NGINX workers. To support broader use cases, the MCP server has been refactored into a standalone module, replacing the original mcp-bridge implementation with a more flexible framework while preserving backward compatibility through existing tests.
+
+For more information, see [#12168](https://github.com/apache/apisix/pull/12168) and [#12151](https://github.com/apache/apisix/pull/12151).
+
+### Add `lago` plugin  
+
+This release introduces the lago plugin, enabling integration with Lago for API monetization. The plugin logs API calls and charges consumers based on configured billing metrics and subscriptions. It supports flexible use cases such as token-based billing for AI services or per-call billing for APIs, and allows multiple routes to be linked to different pricing models for pay-as-you-go scenarios.
+
+For more information, see [#12196](https://github.com/apache/apisix/pull/12196).
+
+### Add `headers` attribute to the `loki-logger` plugin
+
+This release adds a `headers` attribute to the `loki-logger` plugin. This allows, for example, setting an authorization header when sending logs to a remote Loki service.
+
+For more information, see [#12243](https://github.com/apache/apisix/pull/12243).
+
+### Add metadata fields to core resource schemas
+
+This release adds standardized metadata for core resources, including name, description, and labels. The addition improves resource consistency and addresses issues in downstream projects.
+
+For more information, see PR [#12224](https://github.com/apache/apisix/pull/12224).
+
+### Add `max_pending_entries` attribute to batch processor
+
+This release introduces a new `max_pending_entries` option to the batch processor to prevent memory spikes when the log server is slow or unresponsive. This option allows dropping new entries if too many pending callbacks are waiting to be processed.
+
+For more information, see PR [#12338](https://github.com/apache/apisix/pull/12338).
+
+### Enhance Admin API filtering
+
+The Admin API now supports filtering routes and stream routes by `service_id` and `upstream_id`, making it easier to query and manage related resources, especially for the APISIX Dashboard project.
+
+For more information, see PR [#12291](https://github.com/apache/apisix/pull/12291).
+
+### Expose APISIX version in Prometheus `node_info` metric
+
+This release enhances the Prometheus `node_info` metric by adding a version label to expose the current APISIX version, improving observability and version tracking.
+
+For more information, see PR [#12367](https://github.com/apache/apisix/pull/12367).
+
+### Support dash (-) in consumer usernames
+
+This release allows the use of dashes (-) in consumer usernames. This is useful for scenarios such as namespacing in Kubernetes, where consumer names like namespace-username are needed for resource isolation.
+
+For more information, see PR [#12296](https://github.com/apache/apisix/pull/12296).
+
+## Dependencies
+
+Upgraded core dependencies for improved stability, compatibility, and to address known issues:
+
+- Bumped OpenResty to v1.27.1.2 (PR [#12307](https://github.com/apache/apisix/pull/12307))
+- Bumped LuaRocks to v3.12.0 (PR [#12305](https://github.com/apache/apisix/pull/12305))
+
+## Other Updates
+
+- Compare service discovery nodes by address to improve performance (PR [#12258](https://github.com/apache/apisix/pull/12258))
+- Change log level to `debug` to reduce unnecessary logs (PR [#12361](https://github.com/apache/apisix/pull/12361))
+- Adjust log level from `warn` to `info` when removing stale batch processors (PR [#12297](https://github.com/apache/apisix/pull/12297))
+- Refactor `ai-proxy` plugin to move `read_response` into the `ai_driver.request` function (PR [#12101](https://github.com/apache/apisix/pull/12101))
+- Prevent stale health checker from running when the number of new nodes is less than or equal to one (PR [#12118](https://github.com/apache/apisix/pull/12118))
+- Release health checker when there are zero nodes (PR [#12126](https://github.com/apache/apisix/pull/12126))
+- Parse and validate `apisix.yaml` in the CLI only during startup (PR [#12216](https://github.com/apache/apisix/pull/12216))
+- Restrict TLSv1.3 cross-SNI session resumption (PR [#12366](https://github.com/apache/apisix/pull/12366))
+- Fix data dump issue in Kubernetes service discovery single mode (PR [#12284](https://github.com/apache/apisix/pull/12284))
+- Handle `nil` port cases in Consul by defaulting to port 80 (PR [#12304](https://github.com/apache/apisix/pull/12304))
+
+## Changelog
+
+For a complete list of changes in this release, please see [CHANGELOG](https://github.com/apache/apisix/blob/master/CHANGELOG.md#3130).
diff --git a/blog/zh/blog/2025/06/27/release-apache-apisix-3.13.0.md b/blog/zh/blog/2025/06/27/release-apache-apisix-3.13.0.md
@@ -0,0 +1,134 @@
+---
+title: "Apache APISIX 3.13.0 正式发布"
+authors:
+  - name: "Ashish Tiwari"
+    title: "Author"
+    url: "https://github.com/Revolyssup"
+    image_url: "https://github.com/Revolyssup.png"
+  - name: "Traky Deng"
+    title: "Technical Writer"
+    url: "https://github.com/kayx23"
+    image_url: "https://github.com/kayx23.png"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: Apache APISIX 3.13.0 版本于 2025 年 6 月 27 日发布。该版本带来了一系列新功能、修复、以及相关用户体验优化。
+tags: [Community]
+---
+
+我们很高兴地宣布 Apache APISIX 3.13.0 版本已经发布，带来了一系列新功能、修复、以及相关用户体验优化。
+
+<!--truncate-->
+
+此版本引入了多项新功能，包括 `mcp-bridge` 和 `lago` 插件、独立的 Admin API、状态健康检查端点、L4 代理健康检查等等。
+
+虽然本次更新没有引入任何重大变更，但部分功能已被标记为未来版本中将废弃。请查阅下方的弃用说明，以便及时了解未来的变化。
+
+## 弃用说明
+
+### 标记 `server-info` 插件为弃用
+
+`server-info` 插件已被标记为弃用，并将在未来的版本中移除。该插件会定期将服务器信息写入 etcd，在大型集群中可能会由于启动时 etcd 写入操作过多而导致性能问题。
+
+更多信息请参见 [邮件列表讨论](https://lists.apache.org/thread/nrwqo1gbc0z4z48fkb8dd4rn0trnfnz9) 和 [PR #12244](https://github.com/apache/apisix/pull/12244)。
+
+### 在 decoupled 的 `data_plane` 模式中对 etcd 写操作进行警告
+
+当 APISIX 以数据面实例运行在解耦模式时，如果通过 core.etcd 函数或 CLI 执行 etcd 写操作，将记录警告日志。未来版本中将弃用并禁止此类操作。
+
+更多信息请参见 [邮件列表讨论](https://lists.apache.org/thread/gfsooqm4cz6cx2sh7htmqgwlml5kggm2)，该讨论说明了未来的限制计划，以及本次变更的 [PR #12241](https://github.com/apache/apisix/pull/12241)。
+
+## 新功能
+
+### 新增 standalone 模式 Admin API
+
+本次版本为 standalone 模式引入了新的 Admin API，允许用户通过 HTTP PUT（更新）和 GET（获取）来管理内存中的配置。配置支持以 JSON 或 YAML 格式提交，会在验证后广播至同一 APISIX 实例中的所有 worker 进程，实现完全无状态的运行模式。该功能提升了对 Ingress Controller 等场景的支持能力。
+
+更多信息请参见相关 PR [#12179](https://github.com/apache/apisix/pull/12179)、[#12214](https://github.com/apache/apisix/pull/12214)、[#12256](https://github.com/apache/apisix/pull/12256)、[#12295](https://github.com/apache/apisix/pull/12295)、[#12317](https://github.com/apache/apisix/pull/12317)、[#12333](https://github.com/apache/apisix/pull/12333)。
+
+### 支持 L4 代理的健康检查
+
+APISIX 现已支持作为 L4 代理运行时对上游目标进行健康检查，从而提升 TCP/UDP 流量的可靠性并实现自动故障转移。
+
+更多信息请参见 [PR #12180](https://github.com/apache/apisix/pull/12180)。
+
+### 新增状态健康检查端点
+
+本次版本引入了一个健康检查 status 端点，用于指示 APISIX 是否已准备好接收流量。在 standalone 模式下，该端点在从外部客户端（如 Ingress Controller）加载配置后报告就绪状态；在使用 etcd 时，该端点会在所有工作进程完成初始配置加载之前一直处于非就绪状态。该功能有助于外部系统准确执行就绪性检查。
+
+更多信息请参见 [#12200](https://github.com/apache/apisix/pull/12200)。
+
+### 新增 `mcp-bridge` 插件
+
+本次版本引入了 `mcp-bridge` 插件，用于将基于 stdio 的 MCP 服务器转换为基于 HTTP SSE 的接口，并支持子进程管理和跨 NGINX worker 的会话原型处理。为支持更广泛的使用场景，MCP 服务器已重构为独立模块，替换了原始的 `mcp-bridge` 实现，采用更灵活的框架，同时通过现有测试保持向后兼容。
+
+更多信息请参见 [#12168](https://github.com/apache/apisix/pull/12168) 和 [#12151](https://github.com/apache/apisix/pull/12151)。
+
+### 新增 `lago` 插件
+
+本次版本引入了 `lago` 插件，支持与 Lago 集成实现 API 商业化。该插件记录 API 调用，并基于配置的计费指标和订阅对消费者进行计费。它支持灵活的使用场景，例如面向 AI 服务的基于令牌的计费或基于调用次数的 API 计费，并允许将多个路由链接到不同的定价模型，以支持按需付费模式。
+
+更多信息请参见 [#12196](https://github.com/apache/apisix/pull/12196)。
+
+### 为 `loki-logger` 插件添加 `headers` 属性
+
+本次版本为 `loki-logger` 插件新增了 `headers` 属性。通过此功能，用户可以在将日志发送到远程 Loki 服务时设置授权等自定义请求头。
+
+更多信息请参见 [#12243](https://github.com/apache/apisix/pull/12243)。
+
+### 为核心资源 schema 添加 metadata 字段
+
+本次版本为核心资源 schema 添加了标准化的 metadata 字段，包括名称、描述和标签。此增强提升了资源的一致性，并解决了下游项目中的相关问题。
+
+更多信息请参见 [#12224](https://github.com/apache/apisix/pull/12224)。
+
+### 为批处理器新增 `max_pending_entries` 属性
+
+本次版本为批处理器新增了 `max_pending_entries` 配置项，用于防止在日志服务器响应缓慢或无响应时引发内存激增。该配置允许在等待处理的回调数量过多时丢弃新的日志条目。
+
+更多信息请参见 PR [#12338](https://github.com/apache/apisix/pull/12338)。
+
+### 增强 Admin API 过滤功能
+
+Admin API 现在支持通过 `service_id` 和 `upstream_id` 过滤 routes 和 stream routes，使用户更容易查询和管理相关资源，特别是对 APISIX Dashboard 项目更为友好。
+
+更多信息请参见 PR [#12291](https://github.com/apache/apisix/pull/12291)。
+
+### 在 Prometheus `node_info` 指标中暴露 APISIX 版本
+
+本次版本增强了 Prometheus 的 `node_info` 指标，增加了 `version` 标签用于暴露当前 APISIX 版本，从而提升可观测性和版本追踪能力。
+
+更多信息请参见 PR [#12367](https://github.com/apache/apisix/pull/12367)。
+
+### 支持在 consumer 用户名中使用连字符 (-)
+
+本次版本允许在 consumer 的用户名中使用连字符（`-`）。该功能适用于 Kubernetes 等场景，可以通过类似 `namespace-username` 的格式实现资源隔离。
+
+更多信息请参见 PR [#12296](https://github.com/apache/apisix/pull/12296)。
+
+## 依赖项更新
+
+为提升稳定性、兼容性以及修复已知问题，本次版本升级了核心依赖项：
+
+- 升级 OpenResty 至 v1.27.1.2（PR [#12307](https://github.com/apache/apisix/pull/12307)）
+- 升级 LuaRocks 至 v3.12.0（PR [#12305](https://github.com/apache/apisix/pull/12305)）
+
+## 其他更新
+
+- 通过比较服务发现节点的地址来提升性能（PR [#12258](https://github.com/apache/apisix/pull/12258)）
+- 将日志级别调整为 `debug`，以减少不必要的日志输出（PR [#12361](https://github.com/apache/apisix/pull/12361)）
+- 移除过期批处理器时，将日志级别从 `warn` 调整为 `info`（PR [#12297](https://github.com/apache/apisix/pull/12297)）
+- 重构 `ai-proxy` 插件，将 `read_response` 移动到 `ai_driver.request` 函数中（PR [#12101](https://github.com/apache/apisix/pull/12101)）
+- 当新增节点数量小于或等于 1 时，避免启动过期的健康检查器（PR [#12118](https://github.com/apache/apisix/pull/12118)）
+- 在节点数量为 0 时释放健康检查器资源（PR [#12126](https://github.com/apache/apisix/pull/12126)）
+- CLI 工具仅在启动时解析并验证 `apisix.yaml` 文件（PR [#12216](https://github.com/apache/apisix/pull/12216)）
+- 限制 TLSv1.3 的跨 SNI 会话恢复（PR [#12366](https://github.com/apache/apisix/pull/12366)）
+- 修复 Kubernetes 服务发现单节点模式下的数据导出问题（PR [#12284](https://github.com/apache/apisix/pull/12284)）
+- 在 Consul 中处理 `nil` 端口的情况，默认使用端口 80（PR [#12304](https://github.com/apache/apisix/pull/12304)）
+
+## 变更日志
+
+有关此版本的完整变更列表，请参阅 [CHANGELOG](https://github.com/apache/apisix/blob/master/CHANGELOG.md#3130)。
