什么是 YARP，如何在 .NET 中实现反向代理？

来源：这里教程网时间：2026-02-21 17:28:27 作者：

YARP（Yet Another Reverse Proxy）是微软开发的一个基于 .NET 的高性能反向代理库，可用于构建灵活、可扩展的网关服务。它能将客户端请求转发到后端服务，并将响应返回给客户端，常用于微服务架构中的路由、负载均衡、认证等场景。

YARP 的核心功能

YARP 不只是一个简单的请求转发工具，它提供以下关键能力：

动态路由：根据请求路径、主机头等条件匹配目标服务 负载均衡：支持轮询、最少连接等策略分发请求 健康检查：自动探测后端服务状态并剔除不可用节点 请求重写：修改请求头、路径或协议后再转发 可观测性：集成日志、指标和分布式追踪

在 .NET 中实现反向代理的步骤

使用 YARP 搭建反向代理非常简单，以下是具体实现流程：

1. 创建 ASP.NET Core 项目

使用命令行创建新项目：

dotnet new web -n MyReverseProxy

2. 安装 YARP 包

添加 Microsoft.ReverseProxy SDK：

dotnet add package Microsoft.ReverseProxy --version 2.0.0

3. 配置代理路由

在 appsettings.json 中定义路由和集群：

{
  "ReverseProxy": {
    "Routes": {
      "service1_route": {
        "ClusterId": "cluster1",
        "Match": {
          "Path": "/api/service1/{**catch-all}"
        }
      }
    },
    "Clusters": {
      "cluster1": {
        "Destinations": {
          "destination1": {
            "Address": "https://localhost:5001/"
          }
        }
      }
    }
  }
}

4. 启用并配置 YARP

在 Program.cs 中启用反向代理：

var builder = WebApplication.CreateBuilder(args);
// 添加 YARP 服务
builder.Services.AddReverseProxy()
    .LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"));
var app = builder.Build();
// 启用路由转发
app.MapReverseProxy();
app.Run();

高级配置示例

你也可以通过代码方式更精细地控制代理行为：

builder.Services.AddReverseProxy()
    .ConfigureHttpClient((context, handler) =>
    {
        // 自定义超时
        handler.DefaultRequestHeaders.Add("X-Forwarded-For", context.Request.Headers["X-Real-IP"]);
    })
    .AddTransforms(transformBuilderContext =>
    {
        // 重写路径前缀
        transformBuilderContext.AddPathPrefix("/api/service1/");
    });

这样可以实现请求头注入、路径改写、HTTPS 处理等复杂逻辑。