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 MyReverseProxy2. 安装 YARP 包
添加 Microsoft.ReverseProxy SDK：
dotnet add package Microsoft.ReverseProxy --version 2.0.03. 配置代理路由
{
"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 生态中轻松实现反向代理，无需依赖外部组件，同时保持高性能和高可控性。不复杂但容易忽略的是配置细节和路由优先级，建议结合文档调试验证。
