什么是 YARP，如何在 .NET 中实现反向代理？-C#.Net教程-PHP中文网

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

煙雲

发布： 2025-10-20 21:13:02

原创

514人浏览过

YARP是微软基于.NET的高性能反向代理库，支持动态路由、负载均衡、健康检查、请求重写和可观测性；通过创建ASP.NET Core项目、安装YARP包、配置路由与集群、在Program.cs中启用服务即可实现；可结合代码进行HttpClient配置和请求转换，适用于微服务网关、内嵌代理等场景，优势在于轻量、高集成度和无需外部依赖。

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

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 中定义路由和集群：

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

{
  "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 处理等复杂逻辑。