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

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

Major changes and features:

• [Breaking change] This release contains a number of API breaking changes that aim to make YARP easier and more consistent to use:
  • ProxyMatch => RouteMatch
  • AddProxyConfigFilter => AddConfigFilter
  • UseProxyLoadBalancing => UseLoadBalancing
  • UseAffinitizedDestinationLookup => UseSessionAffinity
  • Removed RouteManager, ClusterManager, DestinationManager
  • Changed the routes config model from an array to a Dictionary - #900 Sample change might look like:

  "Routes": [
    {
      "RouteId": "route1",
      "ClusterId": "cluster1"
    }
  ]
  

  "Routes": {
    "route1": {
      "ClusterId": "cluster1"
    }
  }
  

• [Breaking change] X-Fowarded-PathBase header has been replaced with X-Forwarded-Prefix
• Added the ability to interrupt and replace proxy responses (like adding retries) - #866
• Exposed ProxyHttpClientFactory, simplifying the customization of HttpClient instances - #869
• Added WebProxy support for outgoing requests - #879
• [Breaking change] For the Telemetry.Consumption library, removed Add*TelemetryListener methods in favour of a single AddTelemetryListeners, forcing consumer lifetime to singleton - #928
• Many small fixes

For a complete list of changes see the PR history.