{"full_name":"dotnet/yarp","owner":"dotnet","name":"yarp","shard":"1","url":"https://github.com/dotnet/yarp","description":"A toolkit for developing high-performance HTTP reverse proxy applications.","homepage":"https://yarp.dot.net","topics":[],"tag_pages":[],"language":"C#","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/9141961?v=4","created_at":"2020-03-05T18:10:21Z","pushed_at":"2026-11-09T13:27:39Z","metrics":{"stars":9656,"forks":936,"watchers":259,"issues":1171,"prs":1457,"releases":29,"issues_open":187,"issues_closed":984,"prs_open":10,"prs_closed":105,"prs_merged":1342,"discussions":351},"growth":{"day":{"stars":1,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[9650,9652,9653,9653,9655,9655,9656],"forks":[933,935,935,935,936,936,936],"watchers":[null,259,259,259,259,259,259],"issues_open":[null,187,187,187,187,187,187],"prs_open":[null,9,9,9,10,10,10]},"boards":{},"same_owner":[{"full_name":"dotnet/BenchmarkDotNet","name":"BenchmarkDotNet","shard":"1","boards":{}},{"full_name":"dotnet/aspnetcore","name":"aspnetcore","shard":"1","boards":{"daily_watchers":77,"debut":77}},{"full_name":"dotnet/blazor","name":"blazor","shard":"1","boards":{}},{"full_name":"dotnet/core","name":"core","shard":"1","boards":{}},{"full_name":"dotnet/corefx","name":"corefx","shard":"1","boards":{}},{"full_name":"dotnet/dotnet-docker","name":"dotnet-docker","shard":"1","boards":{}},{"full_name":"dotnet/machinelearning","name":"machinelearning","shard":"1","boards":{}},{"full_name":"dotnet/msbuild","name":"msbuild","shard":"1","boards":{}},{"full_name":"dotnet/runtime","name":"runtime","shard":"1","boards":{"daily_watchers":45,"debut":42}},{"full_name":"dotnet/skills","name":"skills","shard":"1","boards":{}},{"full_name":"dotnet/winforms","name":"winforms","shard":"1","boards":{}}],"issues":[{"number":1618,"title":"Tunneling with YARP","comments":37,"created_at":"2022-03-24T07:56:19Z"},{"number":1789,"title":"How to add Swagger for Gateway?","comments":33,"created_at":"2022-07-01T08:03:55Z"},{"number":56,"title":"Retry of \"Safe\" HTTP requests","comments":33,"created_at":"2020-04-15T17:55:30Z"},{"number":2427,"title":"YARP has a higher cpu usage than Nginx","comments":28,"created_at":"2024-03-04T10:48:04Z"},{"number":1158,"title":"Proxy SignalR -- document how","comments":25,"created_at":"2021-07-20T08:27:50Z"},{"number":2721,"title":"\"Stream was already consumed\" exception thrown even with enabled buffering.","comments":18,"created_at":"2025-01-22T15:21:55Z"},{"number":247,"title":"Proxy is supplied as a pre-built docker image","comments":18,"created_at":"2020-06-16T19:13:22Z"},{"number":120,"title":"Are you planning a disk-backed cache?","comments":17,"created_at":"2020-04-28T14:06:56Z"}],"discussions":[{"number":3046,"title":"Yarp behind Traefik - [Cache-Control] header overriden","comments":1,"category":"Q&A","created_at":"2026-07-27T08:43:37Z"},{"number":3034,"title":"YARPad - a browser-based admin UI for YARP","comments":0,"category":"Show and tell","created_at":"2026-05-29T12:12:54Z"},{"number":2977,"title":"OperationCanceledException","comments":1,"category":"General","created_at":"2025-11-21T11:59:33Z"},{"number":2974,"title":"Use YARP to intercept all outbound requests of an app for testing purposes","comments":1,"category":"Q&A","created_at":"2025-11-16T20:42:10Z"},{"number":2968,"title":"YARP returns 502 without waiting for a response when upstream closes the stream without reading to end.","comments":1,"category":"Q&A","created_at":"2025-10-24T00:24:16Z"},{"number":2966,"title":"YARP Redis OutputCaching is not working.","comments":1,"category":"Q&A","created_at":"2025-10-16T12:14:06Z"},{"number":2965,"title":"How to Forward User Claims to DownStream-Apis ?","comments":1,"category":"Q&A","created_at":"2025-10-15T16:28:17Z"},{"number":2957,"title":"Yarp Windows Container","comments":1,"category":"Ideas","created_at":"2025-09-25T11:48:47Z"}],"latest_release":{"name":"2.3.0","tag":"v2.3.0","published_at":"2025-02-27T16:52:54Z","body":"This release supports .NET 8.0 and newer. See [Getting Started](https://learn.microsoft.com/aspnet/core/fundamentals/servers/yarp/getting-started). \r\nNote that while this version also includes targets for .NET 6 and .NET 7, those runtimes are [no longer supported](https://dotnet.microsoft.com/platform/support/policy/dotnet-core#lifecycle).\r\n\r\nThe [Yarp.ReverseProxy](https://www.nuget.org/packages/Yarp.ReverseProxy/2.3.0) packages are available on NuGet.org.\r\n\r\n## Breaking changes\r\n\r\n- More errors triggered by the client disconnecting are now logged under a `Debug` severity (#2765 by @MihaZupan).\r\n  - `ForwarderError.ResponseBodyCanceled` and `UpgradeResponseCanceled` are no longer logged with a `Warning` severity.\r\n  - This is a continuation of a change we've made in 2.2 where we've done the same with `RequestCanceled`, `RequestBodyCanceled`, and `UpgradeRequestCanceled`.\r\n- Replacing the `HttpRequestMessage.Content` property in a request transform will throw an exception (#2722 by @MihaZupan).\r\n  - While setting the property may have appeared to work during limited testing, it could lead to various issues as YARP internally relies on the property remaining unchanged. See the pull request for more context on this change.\r\n- We now always enforce the `HttpVersionPolicy` during HTTP version negotiation (#2729 by @MihaZupan).\r\n  - It was previously possible for YARP to initiate HTTP/1.1 connections for WebSocket and SPDY requests even if the specified `HttpVersionPolicy` disallowed it. This was breaking scenarios such as outgoing HTTP/2 WebSockets without TLS.\r\n  - If the policy disallows the use of outbound HTTP/1.1, SPDY requests will not be proxied and will instead return a `RequestCreation` error.\r\n  - This does not affect the default YARP configuration, which is `Version=2.0, Policy=RequestVersionOrLower`.\r\n\r\n## Major changes\r\n\r\n- YARP has always logically been a part of .NET and we have now moved the repository from the microsoft to the dotnet organization.\r\n  - The [license](https://github.com/dotnet/yarp/blob/main/LICENSE.txt) has been updated to the .NET foundation, but remains MIT as before (#2738 by @adityamandaleeka).\r\n  - As part of the repository move, we have moved the documentation to [learn.microsoft.com](https://learn.microsoft.com/aspnet/core/fundamentals/servers/yarp/getting-started).\r\n- We've created a JSON schema for YARP configuration! Editing now comes with validation and autocompletions (#2758 by @MihaZupan).\r\n  - The change is automatic when referencing the 2.3.0 version of the YARP package and editing the `ReverseProxy` section in `appsettings.json`.\r\n  ![image](https://github.com/user-attachments/assets/b0595fee-e21e-479d-bf63-7cc6adf1709d)\r\n  ![image](https://github.com/user-attachments/assets/3d1b354e-e2c3-49d5-9636-d4504efb95f5)\r\n  - If you encounter any issues with the schema, please let us know by [opening an issue](https://github.com/dotnet/yarp/issues).\r\n  - False positives can be safely ignored until we're able to update the schema. Runtime interpretation of the configuration remains unchanged and is unaffected by schema validation.\r\n  - You can manually reference the latest version of the schema without changing the package by pointing Visual Studio at https://raw.githubusercontent.com/dotnet/yarp/refs/heads/main/src/ReverseProxy/ConfigurationSchema.json.\r\n  ![image](https://github.com/user-attachments/assets/a0301601-b443-43fb-b1ae-7196665d3811)\r\n- We've started shipping a minimal YARP container image at [mcr.microsoft.com](https://mcr.microsoft.com/artifact/mar/dotnet/nightly/yarp/about) (#2710 by @benjaminpetit).\r\n  - More functionality will be added to the image over time.\r\n\r\n## Other changes\r\n\r\n- We've added optional parameters to `AddForwarded` and `AddXForwarded` request transforms that allow you to opt-out of removing the other variant of the header (#2728 by @rkargMsft).\r\n  ```c#\r\n  ctx.AddForwarded(removeAllXForwardedHeaders: false);\r\n  ctx.AddXForwarded(removeForwardedHeader: false)","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}