YARP 2.3.0 · .NET 8 / 9 · MIT

为 .NET 而生的反向代理 与 API 网关

所有请求先到网关这一个入口：按路由规则匹配，转发到正确的后端服务；鉴权、限流、熔断、WAF 都在内置 Dashboard 里统一管理，无需从零搭建。

快速开始 在线演示 GitHub

演示登录：admin / demo123

Aneiang.Yarp 反向代理请求流转示意图 请求入口 路由转发 目标服务集群 浏览器 / Web 移动端 App 内部微服务 GATEWAY Aneiang.Yarp /api/{service}/** 路由匹配 · 负载均衡 鉴权 · 限流 · WAF · 熔断 order-svc :8081 · x2 user-svc :8082 · x3 pay-svc :8083 · x1 客户端请求 健康实例 降级 / 熔断
请求入口 → 路由匹配 → 目标服务集群：网关是唯一的流量入口
01

核心功能

生产级 API 网关增强方案，15 个 Dashboard 管理页面，三个 NuGet 包协同工作

路由

动态路由管理

运行时 CRUD 路由与集群，无需重启。表单 / JSON 双模编辑器，拖拽排序优先级，静态与动态配置自动合并、持久化恢复。

注册

客户端自动注册

一行代码 AddAneiangYarpClient()，启动自动注册、关闭自动注销。支持多路径注册、心跳自愈，服务名与地址全部智能推断。

路由

IP 隔离负载均衡

多人开发调试利器。同一服务多人并行，网关按客户端 IP 自动路由到对应开发者实例，前端零感知。

安全

多模式认证鉴权

None / API Key / JWT（默认 / 自定义）/ 自定义委托五种模式。凭据智能推断，Dashboard 自动适配登录页，网关 API 另支持 Basic 兼容。

安全

WAF 防火墙

内建生产级防护：IP 黑白名单、SQL 注入 / XSS / 路径遍历检测、请求大小与头限制。按路由精细控制，停用零损耗。

流量

限流 · 重试 · 熔断

固定窗口 / 滑动窗口 / 令牌桶 / 并发四种限流算法，可选 Redis 分布式限流；指数退避重试与熔断器半开探测，多实例网关全局精确控流。

插件

插件化架构

11 个内置插件：WAF、限流（内存 / Redis）、重试、熔断、压缩、缓存、代理日志与流量指标。插件中心可视化管理，IGatewayPlugin 契约支持自定义扩展。

发现

服务发现集成

内置 Consul / Nacos / Eureka / Kubernetes / HttpJson / Static 六种发现模式，周期性刷新集群目标端点，健康实例自动过滤。

管理

可视化 Dashboard

15 个管理页面：集群 / 路由 CRUD、插件中心、访问统计、熔断面板、配置历史回滚、请求 / 审计日志，概览页实时推送，中英文切换。

智能

AI 运维助手

对话式管理网关：内置 10 个操作工具，读操作直接执行、写操作需确认，SSE 流式输出，预设 DeepSeek / OpenAI / 智谱 / 通义千问等 8 种服务商，复杂操作一句话完成。

观测

通知告警

钉钉 / 企业微信 / 飞书 / Slack / Discord / Telegram / Teams / 自定义 Webhook 八种渠道，熔断打开、重试耗尽、WAF 拦截等 6 类事件告警，独立冷却防风暴。

观测

监控与健康检查

实时请求日志（SignalR 推送 + 脱敏 + 采样）、熔断器状态面板、P50/P90/P99 延迟统计，流量与集群指标独立看板。

02

Dashboard 界面预览

两行代码即可拥有的专业管理面板

运行概览

一屏掌握网关运行状态

集中查看路由、集群、健康状态和最近配置变更，快速判断网关当前运行情况。

访问统计

看清流量与性能分布

展示请求量趋势、延迟分位、状态码分布和 Top 路由，帮助定位流量和性能问题。

集群管理

后端集群运行时可调

维护后端服务集群、目标节点、健康检查和负载均衡配置，支持运行时调整。

路由管理

路由规则修改即时生效

可视化维护路由匹配、转发集群、优先级和转换规则，修改后即时生效。

请求日志

实时请求流水，随时回查

实时查看代理请求日志，按路由、状态码和 TraceID 过滤，辅助排查线上问题。

WAF 防火墙

入口安全策略集中配置

配置黑白名单、SQL 注入、XSS、路径遍历和安全响应头，为网关入口提供基础防护。

通知告警

异常事件第一时间触达

配置告警渠道和事件规则，在熔断、重试耗尽、WAF 拦截等场景及时通知。

审计日志

每次变更都有迹可循

记录配置变更、操作对象、变更内容和时间，方便追踪问题和回溯操作。

Aneiang.Yarp Dashboard 运行概览页面截图
Aneiang.Yarp Dashboard 访问统计页面截图
Aneiang.Yarp Dashboard 集群管理页面截图
Aneiang.Yarp Dashboard 路由管理页面截图
Aneiang.Yarp Dashboard 请求日志页面截图
Aneiang.Yarp Dashboard WAF 防火墙页面截图
Aneiang.Yarp Dashboard 通知告警页面截图
Aneiang.Yarp Dashboard 审计日志页面截图
03

三步快速开始

不用从零搭建网关管理系统，几分钟即可跑起 Dashboard

1

安装 Dashboard 包

Package 
dotnet add package Aneiang.Yarp.Dashboard
2

启用网关 Dashboard

Program.cs 
builder.Services.AddAneiangYarpDashboard();
app.UseAneiangYarpDashboard();
3

打开管理面板

启动网关后访问 Dashboard，即可管理路由、集群、插件、WAF、日志、审计、告警和健康检查。

前端 / 客户端HTTP
→
Aneiang.YarpGateway + Dashboard
→
微服务集群Aneiang.Yarp.Client

NuGet 包

按需引用，依赖关系清晰。客户端微服务不引入 YARP SDK

Core

Aneiang.Yarp

网关核心：动态路由引擎、双层配置源合并、API 鉴权、IP 隔离负载均衡、插件契约 IGatewayPlugin、gRPC 注册协议

dotnet add package Aneiang.Yarp
NuGet
Dashboard

Aneiang.Yarp.Dashboard

Web 管理面板：15 个管理页面、11 个内置插件、AI 运维助手、8 渠道通知告警、请求 / 审计日志、配置历史回滚、SQLCipher 加密持久化

dotnet add package Aneiang.Yarp.Dashboard
NuGet
Client

Aneiang.Yarp.Client

客户端自动注册：一行代码接入，HTTP/gRPC 双协议，指数退避重试，零 YARP SDK 依赖

dotnet add package Aneiang.Yarp.Client
NuGet

客户端微服务仅需引用 Aneiang.Yarp.Client。网关项目引用 Aneiang.Yarp + Aneiang.Yarp.Dashboard

04

相比原生 YARP 补齐了什么

Aneiang.Yarp 不替代 YARP，而是在 YARP 之上补齐生产落地常用配套能力

能力 原生 YARP Aneiang.Yarp
反向代理 支持 基于 YARP
Dashboard 需要自建 内置
动态路由管理 需要开发 内置
服务自动注册 需要开发 客户端 SDK
WAF 需要扩展 内置
限流 / 重试 / 熔断 需要开发 内置插件
服务发现 需要集成 内置 6 种模式
通知告警 需要扩展 内置
AI 运维助手 无 内置
配置快照 / 回滚 需要开发 内置
SQLite 持久化 需要开发 内置
重启自动恢复配置 需要开发 内置
数据库加密 需要开发 SQLCipher AES-256
05

从试用到生产

按四个阶段逐步接入，能更平滑地把 YARP 网关能力落到实际项目中

01
阶段 01

本地试用

先在本地把示例项目跑起来，体感 Dashboard 和整体接入方式。

  • 克隆示例仓库
  • 运行 Gateway 示例
  • 体验 Dashboard 与示例数据
02
阶段 02

基础接入

在已有或新建的网关项目中引入 Aneiang.Yarp，逐步打开 Dashboard、鉴权和动态配置。

  • 引入 Aneiang.Yarp + Dashboard
  • 选择认证方式
  • 配置动态路由、集群与服务发现
03
阶段 03

能力增强

按业务需要在插件中心开启安全、流量与观测能力，让网关真正承担生产职责。

  • 在插件中心启用 WAF · 限流 · 熔断
  • 对接通知告警渠道
  • 配置审计与配置快照
04
阶段 04

私有化上线

按内网环境打包发布，建立变更与监控流程，长期维护。

  • 私有化部署到内网
  • 建立配置变更流程
  • 用 AI 助手辅助日常运维
06

为什么选择 Aneiang.Yarp

面向 .NET 团队的 YARP 网关增强方案，追求开箱即用、运维简单、私有化部署友好

Fit

它适合谁

如果你正在用 YARP，或准备为 .NET 项目搭建统一网关，它能直接接管从接入到治理的常见工作。

  • 正在用或准备用 YARP
  • 想给 .NET 微服务一个统一入口
  • 希望低依赖、简单部署的内网网关
Why

它和 YARP 有什么不同

YARP 提供反向代理引擎，Aneiang.Yarp 在它之上补齐 Dashboard、动态配置、WAF、自动注册和审计治理等生产配套。

  • 不需要从零写 Dashboard
  • 开箱即用的安全与审计
  • 微服务侧用 SDK 自动注册
Open

开源透明

项目以 MIT 协议开源，代码在 GitHub / Gitee 公开，欢迎提交 Issue、讨论使用场景和贡献代码。

  • MIT License
  • 面向真实 .NET 网关场景持续演进
  • 公开反馈渠道与社区讨论
适合这些场景
  • .NET 微服务项目需要统一 API 网关
  • 想使用 YARP，但不想从零开发 Dashboard
  • 企业内网系统需要私有化部署
  • 老系统需要统一入口、鉴权、审计和防护
  • 多人开发环境需要服务自动注册和 IP 隔离
  • 中小团队希望低成本获得网关管理能力
  • 多实例网关需要 Redis 分布式精确限流
  • 希望用对话式 AI 完成网关配置与排障
参与开源共建 如果 Aneiang.Yarp 对你有帮助，欢迎在常用平台点 Star；遇到问题或有功能建议，也欢迎提交 Issue。
给项目点 Star
提交问题或建议
07

常见问题

快速了解 Aneiang.Yarp 的定位、依赖和使用方式

Aneiang.Yarp 是替代 YARP 吗？

不是。它基于 Microsoft YARP，补充 Dashboard、动态配置、WAF、告警、自动注册等生产配套能力。

是否必须依赖外部数据库？

不需要。默认使用 SQLite 本地文件持久化，无需额外部署数据库服务。

是否适合私有化部署？

适合。项目默认依赖少，配置和数据可本地持久化，适合内网系统和中小团队场景。

微服务必须引用 YARP 吗？

不需要。微服务只需引用 Aneiang.Yarp.Client 用于自动注册，不直接依赖 YARP SDK。

是否支持中文界面？

支持。官网和 Dashboard 均提供中英文界面。

支持服务发现吗？

支持。内置 Consul / Nacos / Eureka / Kubernetes / HttpJson / Static 六种发现模式，周期性刷新集群目标端点，并自动过滤健康实例。

AI 运维助手支持哪些模型？

预设 DeepSeek、OpenAI、Anthropic、Google、xAI、智谱、通义千问等 8 种服务商，也支持自定义 OpenAI 兼容端点。内置 10 个操作工具，读操作直接执行、写操作需确认，响应流式输出。

技术栈 高性能、零外部服务依赖
反向代理引擎Microsoft YARP（版本跟随）
运行时.NET 8.0 / 9.0
存储SQLite + SQLCipher AES-256 加密
通信协议REST API + gRPC + SignalR + SSE 流式
认证JWT (HMAC-SHA256) + API Key + 自定义委托
插件生态11 个内置插件 · IGatewayPlugin 自定义扩展
AI 助手OpenAI 兼容协议 · 8 种服务商预设
Dashboard 技术Razor Pages + 原生 JavaScript（零 Node.js 依赖）

准备好开始了吗？

只需几行代码，即可拥有企业级 API 网关管理能力

立即开始 在线演示 GitHub Star Gitee Star