![\"Illustration](\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2021\/11\/image1.png\")
<\/p>\nToday we announce the release of YARP 1.0, which can be downloaded from NuGet. YARP (Yet Another Reverse Proxy) is a highly customizable reverse proxy built using .NET. The biggest differentiator between YARP and other reverse proxies is how it is built and packaged \u2013 YARP is supplied as a library and samples showing how to create a proxy that is customized to the needs of your specific scenarios.<\/p>\n
Reverse proxies are used to listen to incoming HTTP requests and to forward the requests to appropriate servers based on the contents of the request. Unlike a typical firewall\/router which acts at layer 4 (TCP\/IP), reverse proxies typically work at layer 7 so they understand http and work based on http fields.<\/p>\n
When YARP proxies a request, it handles the HTTP connection from the client, and then creates its own connections to the destination server, and both sides can benefit from connection pooling.<\/p>\n
<\/p>\n
Using a reverse proxy has a number of advantages:<\/p>\n
YARP<\/a> is a project to deliver an open-source reverse proxy server based on .NET. It started almost two years ago when we noticed a pattern of questions from teams at Microsoft who were either building a reverse proxy for their service or had been asking about APIs and technology for building one. We decided to get them all together to work on a common solution, which became YARP.<\/p>\n YARP is a reverse proxy toolkit for building fast proxy servers in .NET using the infrastructure from ASP.NET and .NET. The key differentiator for YARP is that it is being designed to be easily customized and tweaked to match the specific needs of each deployment scenario.<\/p>\n The thing we found from talking with teams creating Microsoft services is that each service is slightly off the beaten path, and they had all been building their own solutions, or trying to customize a 3rd party proxy. While they had solutions for HTTP\/1.1, they needed HTTP\/2 – commonly for gRPC, and HTTP\/2 uses a binary framing format which is much more complicated to implement. YARP enables developers to have full control while leveraging the proven feature set of ASP.NET Core and .NET, with the productivity of C# (or other .NET languages).<\/p>\n YARP plugs into ASP.NET as middleware for handling incoming requests, and YARP offers two main paths for use & customization:<\/p>\n These can even be used together in the same process, switching between them based on the route.<\/p>\n Unlike other proxies that are supplied as an executable that you can extend, YARP reverses the model. You create a proxy using a template that calls into YARP, this makes it much easier to add your own customization and features to YARP.<\/p>\n The following sample is based on the new simplified templates for .NET 6. Examples are available<\/a> for .NET Core 3.1 and .NET 5.<\/p>\n This will create a proxy that will listen to http:\/\/localhost:5000 and https:\/\/localhost:5001 and route any requests to https:\/\/httpbin.org (a useful site for http debugging.) Further details on what can be added through configuration<\/a>.<\/p>\n This 1.0 release of YARP includes the following features:<\/p>\n YARP documentation<\/a>.<\/p>\n Performance of the proxy will depend on a number of factors:<\/p>\n We have a set of benchmarks that get run daily against YARP and other proxy servers. This is measured in a lab using the “citrine<\/a>” hardware definition created to measure the TechEmpower benchmarks. The results are presented using a PowerBI dashboard that can be used to compare against other proxies. For example, comparing YARP and Envoy for (incoming-outgoing protocol) http-http1.1 & https-https1.1 with results in October ’21 looks like:<\/p>\n The dashboard can be found at https:\/\/aka.ms\/aspnet\/benchmarks<\/a>. Once there, at the bottom of the page is a widget to select the page. Proxy results are on page 16.<\/p>\n Hint:<\/strong> Clicking the text “1 of 21” will bring up a menu of pages, where “Proxies” can be selected directly.<\/p><\/blockquote>\n YARP is being developed and delivered as an open source project. It is hosted on github at https:\/\/github.com\/microsoft\/reverse-proxy<\/a>. We welcome contributions, issues and discussions at the repo.<\/p>\n YARP support is provided by the product team – the engineers working on YARP – which is a combination of members from ASP.NET and the core libraries networking teams. We do not provide 24\/7 support or ‘carry pagers’, but as we have team members located in Prague and Redmond we generally have good time zone coverage. Bugs should be reported in github using the issue templates<\/a> and will typically be responded to within 24hrs. If you find a security issue we ask you to report it via the Microsoft Security Response Center (MSRC)<\/a>.<\/p>\n We will service 1.0 for security or other significant issues. New features will be considered for future versions. We expect to start releasing preview builds of the next version in the next couple of months.<\/p>\n In addition to the contributions from Microsoft employees, we are very grateful to have received a number of PRs and issues from the community. Thank you to those who contributed PRs to make this release happen – @amweiss, @anorborg, @BennyM, @dpbevin, @danirzv, @epignosisx, @ericwj, @ganesanarun, @gustavopaes, @hughesjon, @ihvo, @Insomniak47, @isaacabraham, @jboelter, @jmezach, @jrunyen, @jtkech, @Marusyk, @MeladKamari, @MoienTajik, @NoahStahl, @rwkarg, @sharkAndshark, @sleemer, @stefanolsenn, @Tornhoof, @vdjuric, @WeihanLi, @William-Yeh.<\/p>\n I want to make a special call out to @Kahbazi who made an amazing 86 commits and was a more prolific contributor than many of the people assigned to the project.<\/p>\n Work on the reverse proxy will continue. Items we have on our list to work on for the next version include:<\/p>\n YARP, an open-source, highly customizable reverse proxy using .NET has been released.<\/p>\n","protected":false},"author":8635,"featured_media":37332,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[685,196,197,7591],"tags":[],"class_list":["post-37331","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","category-dotnet-core","category-aspnet","category-networking"],"acf":[],"blog_post_summary":" YARP, an open-source, highly customizable reverse proxy using .NET has been released.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/37331","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/8635"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=37331"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/37331\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/37332"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=37331"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=37331"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=37331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
Getting started<\/h2>\n
\n
dotnet new web --name MyYarpProxy<\/code><\/pre>\n\n
dotnet add package MyYarpProxy Yarp.ReverseProxy <\/code><\/pre>\n\n
var builder = WebApplication.CreateBuilder(args);\r\n\r\nbuilder.Services.AddReverseProxy()\r\n .LoadFromConfig(builder.Configuration.GetSection(\"ReverseProxy\"));\r\n\r\nvar app = builder.Build();\r\n\r\napp.MapReverseProxy();\r\n\r\napp.Run();<\/code><\/pre>\n\n
{\r\n \"Urls\": \"http:\/\/localhost:5000;https:\/\/localhost:5001\",\r\n \"Logging\": {\r\n \"LogLevel\": {\r\n \"Default\": \"Information\",\r\n \"Microsoft.AspNetCore\": \"Warning\"\r\n }\r\n },\r\n \"AllowedHosts\": \"*\",\r\n \"ReverseProxy\": {\r\n \"Routes\": {\r\n \"minimumroute\": {\r\n \"ClusterId\": \"minimumcluster\",\r\n \"Match\": {\r\n \"Path\": \"{**catch-all}\"\r\n }\r\n }\r\n },\r\n\r\n \"Clusters\": {\r\n \"minimumcluster\": {\r\n \"Destinations\": {\r\n \"httpbin.org\": {\r\n \"Address\": \"https:\/\/httpbin.org\/\"\r\n }\r\n }\r\n }\r\n }\r\n }\r\n}<\/code><\/pre>\nWhat is in YARP 1.0<\/h2>\n
Configuration<\/h3>\n
\n
\n
Routing & inbound connections<\/h3>\n
\n
Proxying & outbound connections<\/h3>\n
\n
Diagnostics<\/h3>\n
\n
General<\/h3>\n
\n
Documentation<\/h2>\n
Performance<\/h2>\n
\n
![\"Graph](\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2021\/11\/image3.png\")
<\/p>\nOpen Source<\/h2>\n
Support<\/h2>\n
Thank you to contributors<\/h2>\n
What’s next<\/h2>\n
\n