title
Changelog

3.0.0-beta

Here we use 2.99.0 as the version number in the source code instead of the code name 3.0.0-beta for two reasons:

avoid unexpected errors when some programs try to compare the version, as 3.0.0-beta contains 3.0.0 and is longer than it.
some package system might not allow package which has a suffix after the version number.

Change

Moves the config_center, etcd and Admin API configuration to the deployment

We've adjusted the configuration in the static configuration file, so you need to update the configuration in config.yaml as well:

The config_center function is now implemented by config_provider under deployment: #7901
The etcd field is moved to deployment: #7860
The following Admin API configuration is moved to the admin field under deployment: #7823
- admin_key
- enable_admin_cors
- allow_admin
- admin_listen
- https_admin
- admin_api_mtls
- admin_api_version

You can refer to the latest config-default.yaml for details.

Removing multiple deprecated configurations

With the new 3.0 release, we took the opportunity to clean out many configurations that were previously marked as deprecated.

In the static configuration, we removed several fields as follows:

Removed enable_http2 and listen_port from apisix.ssl: #7717
Removed apisix.port_admin: #7716
Removed etcd.health_check_retry: #7676
Removed nginx_config.http.lua_shared_dicts: #7677
Removed nginx_config.http.real_ip_header: #7696

In the dynamic configuration, we made the following adjustments:

Moved disable of the plugin configuration under _meta: #7707
Removed service_protocol from the Route: #7701

There are also specific plugin level changes:

Removed audience field from authz-keycloak: #7683
Removed upstream field from mqtt-proxy: #7694
tcp-related configuration placed under the tcp field in error-log-logger: #7700
Removed max_retry_times and retry_interval fields from syslog: #7699
The scheme field has been removed from proxy-rewrite: #7695

New Admin API response format

We have adjusted the response format of the Admin API in several PRs as follows:

#7630
#7622

The new response format is shown below:

Returns a single configuration:

{
  "modifiedIndex": 2685183,
  "value": {
    "id": "1",
    ...
  },
  "key": "/apisix/routes/1",
  "createdIndex": 2684956
}

Returns multiple configurations:

{
  "list": [
    {
      "modifiedIndex": 2685183,
      "value": {
        "id": "1",
        ...
      },
      "key": "/apisix/routes/1",
      "createdIndex": 2684956
    },
    {
      "modifiedIndex": 2685163,
      "value": {
        "id": "2",
        ...
      },
      "key": "/apisix/routes/2",
      "createdIndex": 2685163
    }
  ],
  "total": 2
}

Other

Port of Admin API changed to 9180: #7806
We only support OpenResty 1.19.3.2 and above: #7625
Adjusted the priority of the Plugin Config object so that the priority of a plugin configuration with the same name changes from Consumer > Plugin Config > Route > Service to Consumer > Route > Plugin Config > Service: [#7614](https://github. com/apache/pull/7614)

Core

Integrating grpc-client-nginx-module to APISIX: #7917
k8s service discovery support for configuring multiple clusters: #7895

Plugin

Support for injecting header with specified prefix in opentelemetry plugin: #7822
Added openfunction plugin: #7634
Added elasticsearch-logger plugin: #7643
response-rewrite plugin supports adding response bodies: #7794
log-rorate supports specifying the maximum size to cut logs: #7749
Added workflow plug-in.
- #7760
- #7771
Added Tencent Cloud Log Service plugin: #7593
jwt-auth supports ES256 algorithm: #7627
ldap-auth internal implementation, switching from lualdap to lua-resty-ldap: #7590
http request metrics within the prometheus plugin supports setting additional labels via variables: #7549
The clickhouse-logger plugin supports specifying multiple clickhouse endpoints: #7517

Bugfix

gRPC proxy sets :authority request header to configured upstream Host: #7939
response-rewrite writing to an empty body may cause AIPSIX to fail to respond to the request: #7836
Fix the problem that when using Plugin Config and Consumer at the same time, there is a certain probability that the plugin configuration is not updated: #7965
Only reopen log files once when log cutting: #7869
Passive health checks should not be enabled by default: #7850
The zipkin plugin should pass trace IDs upstream even if it does not sample: #7833
Correction of opentelemetry span kind to server: #7830
in limit-count plugin, different routes with the same configuration should not share the same counter: #7750
Fix occasional exceptions thrown when removing clean_handler: #7648
Allow direct use of IPv6 literals when configuring upstream nodes: #7594
The wolf-rbac plugin adjusts the way it responds to errors:
- #7561
- #7497
the phases after proxy didn't run when 500 error happens before proxy: #7703
avoid error when multiple plugins associated with consumer and have rewrite phase: #7531
upgrade lua-resty-etcd to 1.8.3 which fixes various issues: #7565

2.15.0

Change

We now map the grpc error code OUT_OF_RANGE to http code 400 in grpc-transcode plugin: #7419
Rename health_check_retry configuration in etcd section of config-default.yaml to startup_retry: #7304
Remove upstream.enable_websocket which is deprecated since 2020: #7222

Core

Support running plugins conditionally: #7453
Allow users to specify plugin execution priority: #7273
Support getting upstream certificate from ssl object: #7221
Allow customizing error response in the plugin: #7128
Add metrics to xRPC Redis proxy: #7183
Introduce deployment role to simplify the deployment of APISIX:
- #7405
- #7417
- #7392
- #7365
- #7249

Plugin

Add ngx.shared.dict statistic in promethues plugin: #7412
Allow using unescaped raw URL in proxy-rewrite plugin: #7401
Add PKCE support to the openid-connect plugin: #7370
Support custom log format in sls-logger plugin: #7328
Export some params for kafka-client in kafka-logger plugin: #7266
Add support for capturing OIDC refresh tokens in openid-connect plugin: #7220
Add prometheus plugin in stream subsystem: #7174

Bugfix

clear remain state from the latest try before retrying in Kubernetes discovery: #7506
the query string was repeated twice when enabling both http_to_https and append_query_string in the redirect plugin: #7433
don't send empty Authorization header by default in http-logger: #7444
ensure both group and disable configurations can be used in limit-count: #7384
adjust the execution priority of request-id so the tracing plugins can use the request id: #7281
correct the transcode of repeated Message in grpc-transcode: #7231
var missing in proxy-cache cache key should be ignored: #7168
reduce memory usage when abnormal weights are given in chash: #7103
cache should be bypassed when the method mismatch in proxy-cache: #7111
Upstream keepalive should consider TLS param: - #7054 - #7466
The redirect plugin sets a correct port during redirecting HTTP to HTTPS: - #7065

2.14.1

Bugfix

The "unix:" in the real_ip_from configuration should not break the batch-requests plugin: #7106

2.14.0

Change

To adapt the change of OpenTelemetry spec, the default port of OTLP/HTTP is changed to 4318: #7007

Core

Introduce an experimental feature to allow subscribing Kafka message via APISIX. This feature is based on the pubsub framework running above websocket:
- #7028
- #7032
Introduce an experimental framework called xRPC to manage non-HTTP L7 traffic:
- #6885
- #6901
- #6919
- #6960
- #6965
- #7040
Now we support adding delay according to the command & key during proxying Redis traffic, which is built above xRPC:
- #6999
Introduce an experimental support to configure APISIX via xDS:
- #6614
- #6759
Add normalize_uri_like_servlet option to normalize uri like servlet: #6984
Zookeeper service discovery via apisix-seed: #6751

Plugin

The real-ip plugin supports recursive IP search like real_ip_recursive: #6988
The api-breaker plugin allows configuring response: #6949
The response-rewrite plugin supports body filters: #6750
The request-id plugin adds nanoid algorithm to generate ID: #6779
The file-logger plugin can cache & reopen file handler: #6721
Add casdoor plugin: #6382
The authz-keycloak plugin supports password grant: #6586

Bugfix

Upstream keepalive should consider TLS param: #7054
Do not expose internal error message to the client:
- #6982
- #6859
- #6854
- #6853
- #6846
DNS supports SRV record with port 0: #6739
client mTLS was ignored sometimes in TLS session reuse: #6906
The grpc-web plugin doesn't override Access-Control-Allow-Origin header in response: #6842
The syslog plugin's default timeout is corrected: #6807
The authz-keycloak plugin's access_denied_redirect_uri was bypassed sometimes: #6794
Handle USR2 signal properly: #6758
The redirect plugin set a correct port during redirecting HTTP to HTTPS:
- #7065
- #6686
Admin API rejects unknown stream plugin: #6813

2.13.3

This is an LTS maintenance release and you can see the CHANGELOG in release/2.13 branch.

https://github.com/apache/apisix/blob/release/2.13/CHANGELOG.md#2133

2.13.2

This is an LTS maintenance release and you can see the CHANGELOG in release/2.13 branch.

https://github.com/apache/apisix/blob/release/2.13/CHANGELOG.md#2132

2.13.1

This is an LTS maintenance release and you can see the CHANGELOG in release/2.13 branch.

https://github.com/apache/apisix/blob/release/2.13/CHANGELOG.md#2131

2.13.0

Change

change(syslog): correct the configuration #6551
change(server-info): use a new approach(keepalive) to report DP info #6202
change(admin): empty nodes should be encoded as array #6384
change(prometheus): replace wrong apisix_nginx_http_current_connections{state="total"} label #6327
change: don't expose public API by default & remove plugin interceptor #6196

Core

🌅 feat: add delayed_body_filter phase #6605
🌅 feat: support for reading environment variables from yaml configuration files #6505
🌅 feat: rerun rewrite phase for newly added plugins in consumer #6502
🌅 feat: add config to control write all status to x-upsream-apisix-status #6392
🌅 feat: add kubernetes discovery module #4880
🌅 feat(graphql): support http get and post json request #6343

Plugin

🌅 feat: jwt-auth support custom parameters #6561
🌅 feat: set cors allow origins by plugin metadata #6546
🌅 feat: support post_logout_redirect_uri config in openid-connect plugin #6455
🌅 feat: mocking plugin #5940
🌅 feat(error-log-logger): add clickhouse for error-log-logger #6256
🌅 feat: clickhouse logger #6215
🌅 feat(grpc-transcode): support .pb file #6264
🌅 feat: development of Loggly logging plugin #6113
🌅 feat: add opentelemetry plugin #6119
🌅 feat: add public api plugin #6145
🌅 feat: add CSRF plugin #5727

Bugfix

fix(skywalking,opentelemetry): trace request rejected by auth #6617
fix(log-rotate): should rotate logs strictly hourly(or minutely) #6521
fix: deepcopy doesn't copy the metatable #6623
fix(request-validate): handle duplicate key in JSON #6625
fix(prometheus): conflict between global rule and route configure #6579
fix(proxy-rewrite): when conf.headers are missing,conf.method can make effect #6300
fix(traffic-split): failed to match rule when the first rule failed #6292
fix(config_etcd): skip resync_delay while etcd watch timeout #6259
fix(proto): avoid sharing state #6199
fix(limit-count): keep the counter if the plugin conf is the same #6151
fix(admin): correct the count field of plugin-metadata/global-rule #6155
fix: add missing labels after merging route and service #6177

2.12.1

This is an LTS maintenance release and you can see the CHANGELOG in release/2.12 branch.

https://github.com/apache/apisix/blob/release/2.12/CHANGELOG.md#2121

2.12.0

Change

change(serverless): rename "balancer" phase to "before_proxy" #5992
change: don't promise to support Tengine #5961
change: enable HTTP when stream proxy is set and enable_admin is true #5867

Core

🌅 feat(L4): support TLS over TCP upstream #6030
🌅 feat: support registering custom variable #5941
🌅 feat(vault): vault lua module, integration with jwt-auth authentication plugin #5745
🌅 feat: enable L4 stream logging #5768
🌅 feat: add http_server_location_configuration_snippet configuration #5740
🌅 feat: support resolve default value when environment not set #5675
🌅 feat(wasm): run in http header_filter #5544

Plugin

🌅 feat: support hide the authentication header in basic-auth with a config #6039
🌅 feat: set proxy_request_buffering dynamically #6075
🌅 feat(mqtt): balance by client id #6079
🌅 feat: add forward-auth plugin #6037
🌅 feat(grpc-web): support gRPC-Web Proxy #5964
🌅 feat(limit-count): add constant key type #5984
🌅 feat(limit-count): allow sharing counter #5881
🌅 feat(splunk): support splunk hec logging plugin #5819
🌅 feat: basic support OPA plugin #5734
🌅 feat: rocketmq logger #5653
🌅 feat(mqtt-proxy): support using route's upstream #5666
🌅 feat(ext-plugin): support to get request body #5600
🌅 feat(plugins): aws lambda serverless #5594
🌅 feat(http/kafka-logger): support to log response body #5550
🌅 feat: Apache OpenWhisk plugin #5518
🌅 feat(plugin): support google cloud logging service #5538

Bugfix

fix: the prometheus labels are inconsistent when error-log-logger is enabled #6055
fix(ipv6): allow disabling IPv6 resolve #6023
fix(mqtt): handle properties for MQTT 5 #5916
fix(sls-logger): unable to get millisecond part of the timestamp #5820
fix(mqtt-proxy): client id can be empty #5816
fix(ext-plugin): don't use stale key #5782
fix(log-rotate): race between reopen log & compression #5715
fix(batch-processor): we didn't free stale object actually #5700
fix: data pollution after passive health check is changed #5589

2.11.0

Change

change(wolf-rbac): change default port number and add authType parameter to documentation #5477

Core

🌅 feat: support advanced matching based on post form #5409
🌅 feat: initial wasm support #5288
🌅 feat(control): expose services#5271
🌅 feat(control): add dump upstream api #5259
🌅 feat: etcd cluster single node failure APISIX startup failure #5158
🌅 feat: support specify custom sni in etcd conf #5206

Plugin

🌅 feat(plugin): azure serverless functions #5479
🌅 feat(kafka-logger): supports logging request body #5501
🌅 feat: provide skywalking logger plugin #5478
🌅 feat(plugins): Datadog for metrics collection #5372
🌅 feat(limit-* plugin): fallback to remote_addr when key is missing #5422
🌅 feat(limit-count): support multiple variables as key #5378
🌅 feat(limit-conn): support multiple variables as key #5354
🌅 feat(proxy-rewrite): rewrite method #5292
🌅 feat(limit-req): support multiple variables as key #5302
🌅 feat(proxy-cache): support memory-based strategy #5028
🌅 feat(ext-plugin): avoid sending conf request more times #5183
🌅 feat: Add ldap-auth plugin #3894

2.10.5

This is an LTS maintenance release and you can see the CHANGELOG in release/2.10 branch.

https://github.com/apache/apisix/blob/release/2.10/CHANGELOG.md#2105

2.10.4

This is an LTS maintenance release and you can see the CHANGELOG in release/2.10 branch.

https://github.com/apache/apisix/blob/release/2.10/CHANGELOG.md#2104

2.10.3

This is an LTS maintenance release and you can see the CHANGELOG in release/2.10 branch.

https://github.com/apache/apisix/blob/release/2.10/CHANGELOG.md#2103

2.10.2

This is an LTS maintenance release and you can see the CHANGELOG in release/2.10 branch.

https://github.com/apache/apisix/blob/release/2.10/CHANGELOG.md#2102

2.10.1

This is an LTS maintenance release and you can see the CHANGELOG in release/2.10 branch.

https://github.com/apache/apisix/blob/release/2.10/CHANGELOG.md#2101

2.10.0

Change

change(debug): move 'enable_debug' form config.yaml to debug.yaml #5046
change: use a new name to customize lua_shared_dict in nginx.conf #5030
change: drop the support of shell script installation #4985

Core

🌅 feat(debug-mode): add dynamic debug mode #5012
🌅 feat: allow injecting logic to APISIX's method #5068
🌅 feat: allow configuring fallback SNI #5000
🌅 feat(stream_route): support CIDR in ip match #4980
🌅 feat: allow route to inherit hosts from service #4977
🌅 feat: support configurating the node listening address#4856

Plugin

🌅 feat(hmac-auth): Add validate request body for hmac auth plugin #5038
🌅 feat(proxy-mirror): support mirror requests sample_ratio #4965
🌅 feat(referer-restriction): add blacklist and message #4916
🌅 feat(kafka-logger): add cluster name support #4876
🌅 feat(kafka-logger): add required_acks option #4878
🌅 feat(uri-blocker): add case insensitive switch #4868

Bugfix

fix(radixtree_host_uri): correct matched host #5124
fix(radixtree_host_uri): correct matched path #5104
fix(nacos): distinguish services that has same name but in different groups or namespaces #5083
fix(nacos): continue to process other services when request failed #5112
fix(ssl): match sni in case-insensitive way #5074
fix(upstream): should not override default keepalive value #5054
fix(DNS): prefer SRV in service discovery #4992
fix(consul): retry connecting after a delay #4979
fix: avoid copying unwanted data when the domain's IP changed #4952
fix(plugin_config): recover plugin when plugin_config changed #4888

2.9.0

Change

change: rename plugin's balancer method to before_proxy #4697

Core

🌅 feat: increase timers limitation #4843
🌅 feat: make A/B test APISIX easier by removing "additionalProperties = false" #4797
🌅 feat: support dash in args (#4519) #4676
🌅 feat(admin): reject invalid proto #4750

Plugin

🌅 feat(ext-plugin): support ExtraInfo #4835
🌅 feat(gzip): support special * to match any type #4817
🌅 feat(real-ip): implement the first version #4813
🌅 feat(limit-*): add custom reject-message for traffic control #4808
🌅 feat: Request-ID plugin add snowflake algorithm #4559
🌅 feat: Added authz-casbin plugin and doc and tests for it #4710
🌅 feat: add error log skywalking reporter #4633
🌅 feat(ext-plugin): send the idempotent key when preparing conf #4736

Bugfix

fix: the issue that plugins in global rule may be cached to route #4867
fix(grpc-transcode): support converting nested message #4859
fix(authz-keycloak): set permissions as empty table when lazy_load_path is false #4845
fix(proxy-cache): keep cache_method same with nginx's proxy_cache_methods #4814
fix(admin): inject updatetime when the request is PATCH with sub path #4765
fix(admin): check username for updating consumer #4756
fix(error-log-logger): avoid sending stale error log #4690
fix(grpc-transcode): handle enum type #4706
fix: when a request caused a 500 error, the status was converted to 405 #4696

2.8.0

Change

change: enable stream proxy only by default #4580

Core

🌅 feat: allow user-defined balancer with metadata in node #4605
🌅 feat: Add option retry_timeout that like nginx's proxy_next_upstream_timeout #4574
🌅 feat: enable balancer phase for plugins #4549
🌅 feat: allow setting separate keepalive pool #4506
🌅 feat: enable etcd health-check #4191

Plugin

🌅 feat: add gzip plugin #4640
🌅 feat(plugin): Add new plugin ua-restriction for bot spider restriction #4587
🌅 feat(stream): add ip-restriction #4602
🌅 feat(stream): add limit-conn #4515
🌅 feat: increase ext-plugin timeout to 60s #4557
🌅 feat(key-auth): supporting key-auth plugin to get key from query string #4490
🌅 feat(kafka-logger): support for specified the log formats via admin API. #4483

Bugfix

fix(stream): sni router is broken when session reuses #4607
fix: the limit-conn plugin cannot effectively intercept requests in special scenarios #4585
fix: ref check while deleting proto via Admin API #4575
fix(skywalking): handle conflict between global rule and route #4589
fix: ctx.var.cookie_* cookie not found log #4564
fix(request-id): we can use different ids with the same request #4479

2.7.0

Change

change: check metadata_schema with check_schema like the other schema #4381
change(echo): remove odd auth_value #4055
fix(admin): correct the resources' count field and change its type to integer #4385

Core

🌅 feat(stream): support client certificate verification #4445
🌅 feat(stream): accept tls over tcp #4409
🌅 feat(stream): support domain in the upstream #4386
🌅 feat(cli): wrap nginx quit cmd #4360
🌅 feat: allow to set custom timeout for route #4340
🌅 feat: nacos discovery support group #4325
🌅 feat: nacos discovery support namespace #4313

Plugin

🌅 feat(client-control): set client_max_body_size dynamically #4423
🌅 feat(ext-plugin): stop the runner with SIGTERM #4367
🌅 feat(limit-req) support nodelay #4395
🌅 feat(mqtt-proxy): support domain #4391
🌅 feat(redirect): support appending query string #4298

Bugfix

fix: solve memory leak when the client aborts #4405
fix(etcd): check res.body.error before accessing the data #4371
fix(ext-plugin): when token is stale, refresh token and try again #4345
fix(ext-plugin): pass environment variables #4349
fix: ensure the plugin is always reloaded #4319

2.6.0

Change

change(prometheus): redesign the latency metrics & update grafana #3993
change(prometheus): don't expose metrics to internet #3994
change(limit-count): ensure redis cluster name is set correctly #3910
change: drop support of OpenResty 1.15 #3960

Core

🌅 feat: support passing different host headers in multiple nodes #4208
🌅 feat: add 50x html for error page #4164
🌅 feat: support to use upstream_id in stream_route #4121
🌅 feat: support client certificate verification #4034
🌅 feat: add nacos support #3820
🌅 feat: patch tcp.sock.connect to use our DNS resolver #4114

Plugin

🌅 feat(redirect): support uri encoding #4244
🌅 feat(key-auth): allow customizing header #4013
🌅 feat(response-rewrite): allow using variable in the header #4194
🌅 feat(ext-plugin): APISIX can support Java, Go and other languages to implement custom plugin #4183

Bugfix

fix(DNS): support IPv6 resolver #4242
fix(healthcheck): only one_loop is needed in the passive health check report #4116
fix(traffic-split): configure multiple "rules", the request will be confused between upstream #4092
fix: ensure upstream with domain is cached #4061
fix: be compatible with the router created before 2.5 #4056
fix(standalone): the conf should be available during start #4027
fix: ensure atomic operation in limit-count plugin #3991

2.5.0

The changes marked with ⚠️ are not backward compatible. Please upgrade your data accordingly before upgrading to this version. #3809 Means that empty vars will make the route fail to match any requests.

Change

⚠️ change: remove unused consumer.id #3868
⚠️ change: remove deprecated upstream.enable_websocket #3854
change(zipkin): rearrange the child span #3877

Core

🌅 feat: support mTLS with etcd #3905
⚠️ feat: upgrade lua-resty-expr/radixtree to support logical expression #3809
🌅 feat: load etcd configuration when apisix starts #3799
🌅 feat: let balancer support priority #3755
🌅 feat: add control api for discovery module #3742

Plugin

🌅 feat(skywalking): allow destroy and configure report interval for reporter #3925
🌅 feat(traffic-split): the upstream pass_host needs to support IP mode #3870
🌅 feat: Add filter on HTTP methods for consumer-restriction plugin #3691
🌅 feat: add allow_origins_by_regex to cors plugin #3839
🌅 feat: support conditional response rewrite #3577

Bugfix

fix(error-log-logger): the logger should be run in each process #3912
fix: use the builtin server by default #3907
fix(traffic-split): binding upstream via upstream_id is invalid #3842
fix: correct the validation for ssl_trusted_certificate #3832
fix: don't override cache relative headers #3789
fix: fail to run make deps on macOS #3718

2.4.0

Change

change: global rules should not be executed on the internal api by default #3396
change: default to cache DNS record according to the TTL #3530

Core

🌅 feat: support SRV record #3686
🌅 feat: add dns discovery #3629
🌅 feat: add consul kv discovery module #3615
🌅 feat: support to bind plugin config by plugin_config_id #3567
🌅 feat: support listen http2 with plaintext #3547
🌅 feat: support DNS AAAA record #3484

Plugin

🌅 feat: the traffic-split plugin supports upstream_id #3512
🌅 feat(zipkin): support b3 req header #3551

Bugfix

fix(chash): ensure retry can try every node #3651
fix: script does not work when the route is bound to a service #3678
fix: use openssl111 in openresty dir in precedence #3603
fix(zipkin): don't cache the per-req sample ratio #3522

For more changes, please refer to Milestone

2.3.0

Change

fix: use luajit by default when run apisix #3335
feat: use luasocket instead of curl in etcd.lua #2965

Core

🌅 feat: support to communicate with etcd by TLS without verification in command line #3415
🌅 feat: chaos test on route could still works when etcd is down #3404
🌅 feat: ewma use p2c to improve performance #3300
🌅 feat: support specifying https in upstream to talk with https backend #3430
🌅 feat: allow customizing lua_package_path & lua_package_cpath #3417
🌅 feat: allow to pass SNI in HTTPS proxy #3420
🌅 feat: support gRPCS #3411
🌅 feat: allow getting upstream health check status via control API #3345
🌅 feat: support dubbo #3224
🌅 feat: load balance by least connections #3304

Plugin

🌅 feat: kafka-logger implemented reuse kafka producer #3429
🌅 feat(authz-keycloak): dynamic scope and resource mapping. #3308
🌅 feat: proxy-rewrite host support host with port #3428
🌅 feat(fault-injection): support conditional fault injection using nginx variables #3363

Bugfix

fix(standalone): require consumer's id to be the same as username #3394
fix: support upstream_id & consumer with grpc #3387
fix: set conf info when global rule is hit without matched rule #3332
fix: avoid caching outdated discovery upstream nodes #3295
fix: create the health checker in access phase #3240
fix: make set_more_retries() work when upstream_type is chash #2676

For more changes, please refer to Milestone

2.2.0

Change

disable node-status plugin by default #2968
k8s_deployment_info is no longer allowed in upstream #3098
don't treat route segment with ':' as parameter by default #3154

Core

🌅 allow create consumers with multiple auth plugins #2898
🌅 increase the delay before resync etcd #2977
🌅 support enable/disable route #2943
🌅 route according to the graphql attributes #2964
🌅 share etcd auth token #2932
🌅 add control API #3048

Plugin

🌅 feat(limt-count): use 'remote_addr' as default key #2927
🌅 feat(fault-injection): support Nginx variable in abort.body #2986
🌅 feat: implement new plugin server-info #2926
🌅 feat: add batch process metrics #3070
🌅 feat: Implement traffic splitting plugin #2935
🌅 feat: the proxy-rewrite plugin support pass nginx variable within header #3144
🌅 feat: Make headers to add to request in openid-connect plugin configurable #2903
🌅 feat: support var in upstream_uri on proxy-rewrite plugin #3139

Bugfix

basic-auth plugin should run in rewrite phases. #2905
fixed the non effective config update in http/udp-logger #2901
always necessary to save the data of the limit concurrency, and release the statistical status in the log phase #2465
avoid duplicate auto-generated id #3003
fix: ctx being contaminated due to a new feature of openresty 1.19. For openresty 1.19 users, it is recommended to upgrade the APISIX version as soon as possible. #3105
fix: correct the validation of route.vars #3124

For more changes, please refer to Milestone

2.1.0

Core

🌅 support ENV variable in configuration. #2743
🌅 support TLS connection with etcd. #2548
generate create/update_time automatically. #2740
add a deprecate log for enable_websocket in upstream.#2691
add a deprecate log for consumer id.#2829
Added X-APISIX-Upstream-Status header to distinguish 5xx errors from upstream or APISIX itself. #2817
support Nginx configuration snippet. #2803

Plugin

🌅 Upgrade protocol to support Apache Skywalking 8.0#2389. So this version only supports skywalking 8.0 protocol. This plugin is disabled by default, you need to modify config.yaml to enable, which is not backward compatible.
🌅 add aliyun sls logging plugin.#2169
proxy-cache: the cache_zone field in the schema should be optional.#2776
fix: validate plugin configuration in the DP #2856

Bugfix

🐛 fix(etcd): handle etcd compaction.#2687
fix: move conf/cert to t/certs and disable ssl by default, which is not backward compatible. #2112
fix: check decrypt key to prevent lua thread aborted #2815

Not downward compatible features in future versions

-In the 2.3 release, the consumer will only support user names and discard the id. The consumer needs to manually clean up the id field in etcd, otherwise the schema verification will report an error during use -In the 2.3 release, opening websocket on upstream will no longer be supported -In version 3.0, the data plane and control plane will be separated into two independent ports, that is, the current port 9080 will only process data plane requests, and no longer process admin API requests

For more changes, please refer to Milestone

2.0.0

This is release candidate.

Core

🌅 Migrate from etcd v2 to v3 protocol, which is not backward compatible. Apache APISIX only supports etcd 3.4 and above versions. #2036
add labels for upstream object.#2279
add managed fields in json schema for resources, such as create_time and update_time.#2444
use interceptors to protect plugin's route#2416
support multiple ports for http and https listen.#2409
implement core.sleep.#2397

Plugin

🌅 add AK/SK(HMAC) auth plugin.#2192
🌅 add referer-restriction plugin.#2352
limit-count support to use redis cluster.#2406
feat(proxy-cache): store the temporary file under cache directory. #2317
feat(http-logger): support for specified the log formats via admin API #2309

Bugfix

🐛 high priority When the data plane receives an instruction to delete a resource(router or upstream etc.), it does not properly clean up the cache, resulting in the existing resources cannot be found. This problem only occurs in the case of long and frequent deletion operations.#2168
fix routing priority does not take effect.#2447
set random seed for each worker process at init_worker phase, only init phase is not enough.#2357
remove unsupported algorithm in jwt plugin.#2356
return correct response code when http_to_https enabled in redirect plugin.#2311

For more changes, please refer to Milestone

CVE

Fixed Admin API default access token vulnerability

1.5.0

Core

Admin API: support authentication with SSL certificates. 1747
Admin API: support both standard PATCH and sub path PATCH. 1930
HealthCheck: supports custom host port. 1914
Upstream: supports turning off the default retry mechanism. 1919
URI: supports delete the '/' at the end of the URI. 1766

New Plugin

🌅 Request Validator 1709

Improvements

change: nginx worker_shutdown_timeout is changed from 3s to recommended value 240s. 1883
change: the healthcheck timeout time type changed from integer to number. 1892
change: the request-validation plugin input parameter supports Schema validation. 1920
change: add comments for Makefile install command. 1912
change: update comment for config.yaml etcd.timeout configuration. 1929
change: add more prometheus metrics. 1888
change: add more configuration options for cors plugin. 1963

Bugfix

fixed: failed to get host in health check configuration. 1871
fixed: should not save the runtime data of plugin into etcd. 1910
fixed: run apisix start several times will start multi nginx processes. 1913
fixed: read the request body from the temporary file if it was cached. 1863
fixed: batch processor name and error return type. 1927
fixed: failed to read redis.ttl in limit-count plugin. 1928
fixed: passive health check seems never provide a healthy report. 1918
fixed: avoid to modify the original plugin conf. 1958
fixed: the test case of invalid-upstream is unstable and sometimes fails to run. 1925

Doc

doc: added APISIX Lua Coding Style Guide. 1874
doc: fixed link syntax in README.md. 1894
doc: fixed image links in zh-cn benchmark. 1896
doc: fixed typos in FAQ、admin-api、architecture-design、discovery、prometheus、proxy-rewrite、redirect、http-logger documents. 1916
doc: added improvements for OSx unit tests and request validation plugin. 1926
doc: fixed typos in architecture-design document. 1938
doc: added the default import path of Nginx for unit testing in Linux and macOS systems in the how-to-build document. 1936
doc: add request-validation plugin chinese document. 1932
doc: fixed file path of gRPC transcoding in README. 1945
doc: fixed uri-blocker plugin path error in README. 1950
doc: fixed grpc-transcode plugin path error in README. 1946
doc: removed unnecessary configurations for k8s document. 1891

1.4.1

Bugfix

Fix: multiple SSL certificates are configured, but only one certificate working fine. 1818

1.4.0

Core

Admin API: Support unique names for routes 1655
Optimization of log buffer size and flush time 1570

New plugins

🌅 Apache Skywalking plugin 1241
🌅 Keycloak Identity Server Plugin 1701
🌅 Echo Plugin 1632
🌅 Consume Restriction Plugin 1437

Improvements

Batch Request : Copy all headers to every request 1697
SSL private key encryption 1678
Improvement of docs for multiple plugins

1.3.0

The 1.3 version is mainly for security update.

Security

reject invalid header#1462 and uri safe encode#1461
only allow 127.0.0.1 access admin API and dashboard by default. #1458

Plugin

🌅 add batch request plugin. #1388
implemented plugin sys logger. #1414

1.2.0

The 1.2 version brings many new features, including core and plugins.

Core

🌅 support etcd cluster. #1283
using the local DNS resolver by default, which is friendly for k8s. #1387
support to run header_filter, body_filter and log phases for global rules. #1364
changed the lua/apisix dir to apisix(not backward compatible). #1351
add dashboard as submodule. #1360
allow adding custom shared dict. #1367

Plugin

🌅 add Apache Kafka plugin. #1312
🌅 add CORS plugin. #1327
🌅 add TCP logger plugin. #1221
🌅 add UDP logger plugin. 1070
🌅 add proxy mirror plugin. #1288
🌅 add proxy cache plugin. #1153
drop websocket enable control in proxy-rewrite plugin(not backward compatible). 1332
Adding support to public key based introspection for OAuth plugin. #1266
response-rewrite plugin support binary data to client by base64. #1381
plugin grpc-transcode supports grpc deadline. #1149
support password auth for limit-count-redis. #1150
Zipkin plugin add service name and report local server IP. #1386
add change_pwd and user_info for Wolf-Rbac plugin. #1204

Admin API

🌅 support key-based authentication for Admin API(not backward compatible). #1169
hide SSL private key in admin API. #1240

Bugfix

missing clear table before to reuse table (will cause memory leak). #1134
print warning error message if the yaml route file is invalid. #1141
the balancer IP may be nil, use an empty string instead. #1166
plugin node-status and heartbeat don't have schema. #1249
the plugin basic-auth needs required field. #1251
check the count of upstream valid node. #1292

1.1.0

This release is mainly to strengthen the stability of the code and add more documentation.

Core

always specify perl include path when running test cases. #1097
Feature: Add support for PROXY Protocol. #1113
enhancement: add verify command to verify apisix configuration(nginx.conf). #1112
feature: increase the default size of the core file. #1105
feature: make the number of file is as configurable as the connections. #1098
core: improve the core.log module. #1093
Modify bin/apisix to support the SO_REUSEPORT. #1085

Doc

doc: add link to download grafana meta data. #1119
doc: Update README.md. #1118
doc: doc: add wolf-rbac plugin. #1116
doc: update the download link of rpm. #1108
doc: add more english article. #1092
Adding contribution guidelines for the documentation. #1086
doc: getting-started.md check. #1084
Added additional information and refactoring sentences. #1078
Update admin-api-cn.md. #1067
Update architecture-design-cn.md. #1065

CI

ci: remove patch which is no longer necessary and removed in the upst. #1090
fix path error when install with luarocks. #1068
travis: run a apisix instance which intalled by luarocks. #1063

Plugins

feature: Add wolf rbac plugin. #1095
Adding UDP logger plugin. #1070
enhancement: using internal request instead of external request in node-status plugin. #1109

1.0.0

This release is mainly to strengthen the stability of the code and add more documentation.

Core

🌅 Support routing priority. You can match different upstream services based on conditions such as header, args, priority, etc. under the same URI. #998
When no route is matched, an error message is returned. To distinguish it from other 404 requests. #1013
The address of the dashboard /apisix/admin supports CORS. #982
The jsonschema validator returns a clearer error message. #1011
Upgrade the ngx_var module to version 0.5. #1005
Upgrade the lua-resty-etcd module to version 0.8. #980
In development mode, the number of workers is automatically adjusted to 1. #926
Remove the nginx.conf file from the code repository. It is automatically generated every time and cannot be modified manually. #974

Doc

Added documentation on how to customize development plugins. #909
fixed example's bugs in the serverless plugin documentation. #1006
Added documentation for using the Oauth plugin. #987
Added dashboard compiled documentation. #985
Added documentation on how to perform a/b testing. #957
Added documentation on how to enable the MQTT plugin. #916

Test case

Add test cases for key-auth plugin under normal circumstances. #964
Added tests for gRPC transcode pb options. #920

0.9.0

This release brings many new features, such as support for running APISIX with Tengine, an advanced debugging mode that is more developer friendly, and a new URI redirection plugin.

Core

🌅 Supported to run APISIX with tengine. #683
🌅 Enabled HTTP2 and supported to set ssl_protocols. #663
🌅 Advanced Debug Mode, Target module function's input arguments or returned value would be printed once this option is enabled. #614
Support to install APISIX without dashboard. #686
Removed router R3 #725

Plugins

Redirect URI: Redirect URI plugin. #732
Proxy Rewrite: Supported remove header feature. #658
Limit Count: Supported global limit count with Redis Server.#624

lua-resty-*

lua-resty-radixtree
- Support for host + uri as an index.
lua-resty-jsonschema
- This extension is a JSON data validator that replaces the existing lua-rapidjson extension.

Bugfix

key-auth plugin cannot run accurately in the case of multiple consumers. #826
Exported schema for plugin serverless. #787
Discard args of uri when using proxy-write plugin #642
Zipkin plugin not set tracing data to request header. #715
Skipped check cjson for luajit environment in apisix CLI. #652
Skipped to init etcd if use local file as config center. #737
Support more built-in parameters when set chash balancer. #775

Dependencies

Replace the lua-rapidjson module with lua-resty-jsonschema global, lua-resty-jsonschema is faster and easier to compile.

0.8.0

Released on 2019/09/30

This release brings many new features, such as stream proxy, support MQTT protocol proxy, and support for ARM platform, and proxy rewrite plugin.

Core

🌅 support stand-alone mode: using yaml to update configurations of APISIX, more friendly to kubernetes. #464
🌅 support stream proxy. #513
🌅 support consumer bind plugins. #544
support domain name in upstream, not only IP. #522
ignored upstream node when it's weight is 0. #536

Plugins

🌅 MQTT Proxy: support to load balance MQTT by client_id, both support MQTT 3.1 and 5.0. #513
proxy-rewrite: rewrite uri, schema, host for upstream. #594

ARM

🌅 APISIX can run normally under Ubuntu 18.04 of ARM64 architecture, so you can use APISIX as IoT gateway with MQTT plugin.

lua-resty-*

lua-resty-ipmatcher
- support IPv6
- IP white/black list, route.
lua-resty-radixtree
- allow to specify multiple host, remote_addr and uri.
- allow to define user-function to filter request.
- use lua-resty-ipmatcher instead of lua-resty-iputils, lua-resty-ipmatcher matches fast and support IPv6.

Bugfix

healthcheck: the checker name is wrong if APISIX works under multiple processes. #568

Dependencies

removed lua-tinyyaml from source code base, and install through Luarocks.

0.7.0

Released on 2019/09/06

This release brings many new features, such as IP black and white list, gPRC protocol transcoding, IPv6, IdP (identity provider) services, serverless, Change the default route to radix tree (not downward compatible), and more.

Core

🌅 gRPC transcoding: supports protocol transcoding so that clients can access your gRPC API by using HTTP/JSON. #395
🌅 radix tree router: The radix tree is used as the default router implementation. It supports the uri, host, cookie, request header, request parameters, Nginx built-in variables, etc. as the routing conditions, and supports common operators such as equal, greater than, less than, etc., more powerful and flexible.IMPORTANT: This change is not downward compatible. All users who use historical versions need to manually modify their routing to work properly. #414
Dynamic upstream supports more parameters, you can specify the upstream uri and host, and whether to enable websocket. #451
Support for get values from cookies directly from ctx.var. #449
Routing support IPv6. #331

Plugins

🌅 serverless: With serverless support, users can dynamically run any Lua function on a gateway node. Users can also use this feature as a lightweight plugin.#86
🌅 support IdP: Support external authentication services, such as Auth0, okta, etc., users can use this to connect to Oauth2.0 and other authentication methods. #447
rate limit: Support for more restricted keys, such as X-Forwarded-For and X-Real-IP, and allows users to use Nginx variables, request headers, and request parameters as keys. #228
IP black and white list Support IP black and white list for security. #398

CLI

Add the version directive to get the version number of APISIX. #420

Admin

The PATCH API is supported and can be modified individually for a configuration without submitting the entire configuration. #365

Dashboard

🌅 Add the online version of the dashboard，users can experience APISIX without install. #374

Back to TOC

0.6.0

Released on 2019/08/05

This release brings many new features such as health check and circuit breaker, debug mode, opentracing and JWT auth. And add built-in dashboard.

Core

🌅 Health Check and Circuit Breaker: Enable health check on the upstream node, and will automatically filter unhealthy nodes during load balancing to ensure system stability. #249
Anti-ReDoS(Regular expression Denial of Service). #252
supported debug mode. #319
allowed to use different router. #364
supported to match route by host + uri. #325
allowed plugins to handler balance phase. #299
added desc for upstream and service in schema. #289

Plugins

🌅 OpenTracing: support Zipkin and Apache SkyWalking. #304
JWT auth. #303

CLI

support multiple ips of allow. #340
supported real_ip configure in nginx.conf and added functions to get ip and remote ip. #236

Dashboard

🌅 add built-in dashboard. #327

Test

support OSX in Travis CI. #217
installed all of the dependencies to deps folder. #248

Back to TOC

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Table of Contents

3.0.0-beta

Change

Moves the config_center, etcd and Admin API configuration to the deployment

Removing multiple deprecated configurations

New Admin API response format

Other

Core

Plugin

Bugfix

2.15.0

Change

Core

Plugin

Bugfix

2.14.1

Bugfix

2.14.0

Change

Core

Plugin

Bugfix

2.13.3

2.13.2

2.13.1

2.13.0

Change

Core

Plugin

Bugfix

2.12.1

2.12.0

Change

Core

Plugin

Bugfix

2.11.0

Change

Core

Plugin

2.10.5

2.10.4

2.10.3

2.10.2

2.10.1

2.10.0

Change

Core

Plugin

Bugfix

2.9.0

Change

Core

Plugin

Bugfix

2.8.0

Change

Core

Plugin

Bugfix

2.7.0

Change

Core

Plugin

Bugfix

2.6.0

Change

Core

Plugin

Bugfix

2.5.0

Change

Core

Plugin