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