This release supports .NET Core 3.1, .NET 5.0, and .NET 6.0. See Getting Started.

The Yarp.ReverseProxy packages are available on NuGet.org.

Breaking changes

• The Yarp.ReverseProxy.Telemetry.Consumption package was renamed to Yarp.Telemetry.Consumption. #1251
• The Yarp.ReverseProxy.ServiceFabric nuget package is not included in this release. That work is moving to a different repo and development schedule. #1304
• The ForwarderRequestConfig.Timeout request timeout has been replaced by an ActivityTimeout. The timeout now restarts when response headers are received, or when any request, response, or websocket data is transferred. WebSockets should enable Pings to keep idle connections alive. gRPC streams should consider using application level pings if they intend to remain idle longer than the timeout. #1289
• The I*MetricsConsumer interfaces have been consolidated to IMetricsConsumer<T>. #1295
• ActivityPropagationHandler and ActivityContextHeaders removed. This feature is now available natively in .NET 6. See the discussion for information on how to enable the scenario for prior versions of .NET. #1311
• Response header and trailer transform APIs now take a ResponseCondition to allow them to run on Success, Failure, or Always. #1300
• The HttpContext.GetClusterState extension method has been removed. #1166
• IProxyConfigFilter.ConfigureRouteAsync now takes in ClusterConfig as well. #1231

Other changes

• The libraries have added a target for net6.0, and various optimizations to take advantage of 6.0.
• Query parameter based routing, and additional modes for header based routing. #1277
• Response transforms will be run even if the destination failed to respond. #1257
• HttpForwarder uses the same default transforms as the rest of YARP, including X-Forwarded-* headers and removing the Host header. #1246
• New WebSockets telemetry middleware. #1237
• Support for header allow lists. #1137

For a full list of changes see here.