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

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

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

适用场景与优势

YARP 特别适合以下情况：

• 需要轻量级、内嵌式反向代理的 .NET 应用
• 微服务入口网关，统一处理跨域、认证、限流
• 替代 nginx 或 IIS URL Rewrite 的纯 .NET 方案
• 与 ASP.NET Core 中间件无缝集成

基本上就这些。YARP 让你在 .NET 生态中轻松实现反向代理，无需依赖外部组件，同时保持高性能和高可控性。不复杂但容易忽略的是配置细节和路由优先级，建议结合文档调试验证。