github apache/apisix 3.21.0

2 hours ago

Apache APISIX 3.21.0 upgrades APISIX Runtime to 1.4.3, protects credentials in forwarded requests and logs, and improves upstream recovery and log delivery.

Runtime and security fixes

APISIX Runtime 1.4.3 uses the NGINX 1.31.9 core in its OpenResty 1.31.8.1 build. It incorporates ten upstream security fixes. Their relevance to a deployment depends on the enabled modules and configuration. Runtime upgrade #14223 · NGINX security advisories

Component CVEs
HTTP/2 CVE-2026-123007, CVE-2026-123633
HTTP/3 CVE-2026-121810
TLS request bodies CVE-2026-118899
DNS resolution CVE-2026-123634
Stream TLS and PROXY protocol CVE-2026-123640, CVE-2026-120967, CVE-2026-120993
Static file handling CVE-2026-125283
Mail proxy (disabled in the standard Runtime build) CVE-2026-113425

Gateway and plugin changes

  • With normalize_uri_like_servlet enabled, upstream requests now use the query arguments left by rewrite and access plugins. This preserves credential removal by key-auth and jwt-auth. Mirrored requests honor explicit upstream URI overrides, and data-mask applies query masking rules to upstream_uri in access logs. #14163
  • APISIX stops logging sensitive configuration values during etcd validation and plugin execution. Admin API errors for invalid plugin configuration types report the type without echoing the submitted value. #14157
  • Recovered round-robin nodes restart their slow-start ramp. New health checkers observe health transitions during initialization, and Redis cluster probes reuse TLS and authentication settings when checking for recovery. #14188 · #14215 · #14181
  • Logger batch processors preserve active batches during cleanup and correct backlog counts after failures or filtering. The Elasticsearch logger isolates batches by plugin configuration so each Route uses its own endpoints and credentials. TCP and Splunk loggers also improve error handling. #14192 · #14004 · #14012
  • Prometheus includes the first session's bytes in apisix_stream_bandwidth for a new service. The host-based router includes the referring Route ID when it cannot load a Service. #14101 · #13723

Before upgrading from 3.20.0

  • Admin API keys. When admin_key_required is enabled, set an explicit admin or viewer role on every configured key and quote numeric-looking keys in YAML. Check traditional and control-plane configurations, including traditional deployments with the Admin API disabled. #14203
  • Encrypted configuration. Newly encrypted plugin configuration and metadata values carry a $ENC$v1$ prefix. Back up etcd before upgrading and avoid Admin API writes during a rolling upgrade. If encrypted resources have been re-saved, restore the pre-upgrade data before rolling back to the official 3.20.0 source release or another build without marker support. #14162
  • HTTP parsing and source installs. The new NGINX core rejects header lines missing a colon, returning 400 for client requests or 502 for upstream responses. It also rejects chunked request bodies with excessive framing overhead. When installing from the source archive, install APISIX Runtime 1.4.3 separately, then run make deps APISIX_RUNTIME=1.4.3. #14223

Full 3.21.0 changelog

Don't miss a new apisix release

NewReleases is sending notifications on new releases.