ABP VNext + Microsoft YARP：自定义反向代理与请求路由

最新推荐文章于 2025-11-18 08:50:53 发布

原创

最新推荐文章于 2025-11-18 08:50:53 发布 · 474 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#microsoft #后端 #ABP vNext #微服务 #YARP

ABP VNext + Microsoft YARP：自定义反向代理与请求路由 ☁️

📚 目录

ABP VNext + Microsoft YARP：自定义反向代理与请求路由 ☁️

一、引言 🎉

✨ TL;DR

基于 ABP VNext + Microsoft YARP 构建生产级 API 网关；
支持动态路由热加载、熔断（Circuit Breaker）、指数退避重试⚡；
IP/ClientID 限流、路由级授权🔒、转发头、CORS 安全策略；
集成 YARP Active Health Check、Prometheus 指标📊、Serilog 日志；
提供 Docker Compose 与 k6 脚本，一键复现🚀。

📚 背景与动机
在微服务架构中，网关负责「统一入口」「流量控制」「安全边界」「可观测性」。ABP VNext 6.x 官方推荐使用 YARP 替代 Ocelot，其高吞吐、低延迟、配置同源与可扩展性完美契合生产环境需求。

二、环境与依赖 🛠️

平台：.NET 6 + ABP VNext 6.x

关键 NuGet 包

<PackageReference Include="Microsoft.ReverseProxy" Version="1.1.0-preview.8.21451.2" />
<PackageReference Include="Polly.Extensions.Http" Version="3.0.0" />
<PackageReference Include="AspNetCoreRateLimit" Version="4.3.1" />
<PackageReference Include="Volo.Abp.AspNetCore.Authentication.JwtBearer" Version="6.4.0" />
<PackageReference Include="prometheus-net.AspNetCore" Version="5.0.1" />
<PackageReference Include="Serilog.AspNetCore" Version="7.0.0" />

容器化说明
配置支持环境变量、Kubernetes ConfigMap/Secret、Docker Compose 覆盖，免重建镜像。

三、项目骨架与启动配置 📁

3.1 目录结构

Gateway/
├─ Gateway.csproj
├─ Program.cs
├─ appsettings.json
├─ appsettings.Production.json
└─ ProxyConfig/
     ├─ Routes.json
     └─ Clusters.json
Services/            // 后端微服务
docker-compose.yml

3.2 配置加载流程

3.3 Program.cs 高层结构

var builder = WebApplication.CreateBuilder(args);

// 1. Serilog 日志
builder.Host.UseSerilog((ctx, lc) => lc.ReadFrom.Configuration(ctx.Configuration));

// 2. 配置热加载
builder.Configuration
    .AddJsonFile("appsettings.json", false, true)
    .AddJsonFile("ProxyConfig/Routes.json", true, true)
    .AddJsonFile("ProxyConfig/Clusters.json", true, true)
    .AddEnvironmentVariables();

// 3. 模块化服务注册
builder.Services.AddGatewayServices(builder.Configuration);

var app = builder.Build();

// 4. 模块化管道配置
app.UseGatewayPipeline();

app.R