YARP简介 —— IHttpProxy

在YARP框架中，核心处理类是IHttpProxy，其接口定义如下：

Task ProxyAsync(HttpContext context, string destinationPrefix, HttpMessageInvoker httpClient, RequestProxyOptions requestOptions, HttpTransformer transformer)

从它的接口定义基本可以看出它的功能：从 HttpContext 创建 Http 查询信息、发送到目标地址，并将响应结果写会HttpContext。

IhttpProxy特点如下：

1. 灵活，能根据请求动态选择代理目标
2. 强大，能修改http请求和响应的头
3. 支持gRPC或WebSockets这种流式协议
4. 支持异常处理

它简单灵活，本身是一个反向代理的功能类的。 用它本身是可以非常简单的实现一个反向代理功能的。代码如下： 

public void ConfigureServices(IServiceCollection services)
{
    services.AddHttpProxy();
}

public void Configure(IApplicationBuilder app, IHttpProxy httpProxy)
{
    var httpClient = new HttpMessageInvoker(new SocketsHttpHandler()
    {
        UseProxy = false,
        AllowAutoRedirect = false,
        AutomaticDecompression = DecompressionMethods.None,
        UseCookies = false
    });
    var transformer = new CustomTransformer(); // or HttpTransformer.Default;
    var requestOptions = new RequestProxyOptions { Timeout = TimeSpan.FromSeconds(100) };

    app.UseRouting();
    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.Map("/{**catch-all}", async httpContext =>
        {
            await httpProxy.ProxyAsync(httpContext, "https://localhost:10000/", httpClient,
                requestOptions, transformer);

            var errorFeature = httpContext.GetProxyErrorFeature();
            if (errorFeature != null)
            {
                var error = errorFeature.Error;
                var exception = errorFeature.Exception;
            }
        });
    });
}

这里为了演示请求和相应头的功能，自定义了一个HttpTransformer，代码如下。 

private class CustomTransformer : HttpTransformer
{
    public override async Task TransformRequestAsync(HttpContext httpContext,
        HttpRequestMessage proxyRequest, string destinationPrefix)
    {
        // Copy headers normally and then remove the original host.
        // Use the destination host from proxyRequest.RequestUri instead.
        await base.TransformRequestAsync(httpContext, proxyRequest, destinationPrefix);
        proxyRequest.Headers.Host = null;
    }
}

上述代码本身是实现了一个完整的的反向代理的功能的。和目前的主流的反向代理框架比起来，主要缺少一些高级功能，如：路由匹配、负载均衡、会话保持、重试等。但这些高级功能本身不是必须的，这个时候直接用IhttpProxy更加简单直接，也可以方便我们自己构建一个更加灵活高效的反向代理框架。

参考文章：

• Direct Proxying
• 微软的反向代理库YARP
• NuGet Gallery | Yarp.ReverseProxy