NuGet NuGet Dashboard NuGet Client YARP .NET gRPC

基于 YARP 的生产级全功能 API 网关

Dashboard 可视化管理 · WAF 防火墙 · 通知告警 · 动态路由 · 自动注册 · IP 隔离 · 熔断限流 · 健康检查 · 配置回滚

演示登录:admin / demo123

核心功能

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

动态路由管理

运行时 CRUD 路由与集群,无需重启。双配置源统一,自动持久化到 gateway-dynamic.json,线程安全。

客户端自动注册

一行代码 AddAneiangYarpClient(),微服务启动自动注册、关闭自动注销。智能推断所有默认值。

IP 隔离负载均衡

多人开发调试利器。同一服务多人并行,网关按客户端 IP 自动路由,前端零感知。

可视化 Dashboard

两行代码启用。集群/路由 CRUD、配置导入导出、快照回滚、实时日志、日志脱敏与采样、中英文切换。

多模式认证鉴权

None / API Key / JWT(默认 & 自定义)/ 自定义委托。智能凭据推断,少写配置。

配置管理与回滚

导入导出标准 YARP 格式配置。每次变更自动快照,一键回滚到任意历史版本。

WAF 防火墙

内建生产级防护:IP 黑白名单、SQL 注入/XSS/路径遍历检测、请求限制、安全响应头。按路由精细控制。

通知告警

多渠道告警(钉钉/通用 Webhook)。熔断、重试耗尽、WAF 拦截等 6 种事件类型,独立冷却防告警风暴。

监控与健康检查

实时请求日志(WebSocket 推送)、熔断器状态面板、主动/被动健康检查、P50/P90/P99 延迟统计。

三步快速开始

不用从零搭建网关管理系统,几分钟即可跑起 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

Dashboard 界面预览

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

运行概览

运行概览

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

访问统计

访问统计

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

集群管理

集群管理

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

路由管理

路由管理

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

请求日志

请求日志

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

WAF 防火墙

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 审计日志页面截图

适合这些场景

如果你正在使用 YARP,或准备为 .NET 项目建设统一网关,这些场景都可以直接落地

.NET 微服务项目需要统一 API 网关
想使用 YARP,但不想从零开发 Dashboard
企业内网系统需要私有化部署
老系统需要统一入口、鉴权、审计和防护
多人开发环境需要服务自动注册和 IP 隔离
中小团队希望低成本获得网关管理能力

生产落地能力

围绕企业内网和 .NET 微服务网关场景,提供安全、运维、观测和配置治理能力

Gateway

网关核心能力

  • 动态路由与集群管理
  • 配置持久化与快照回滚
  • 熔断、重试、限流
  • IP 隔离负载均衡
Security

安全与审计

  • WAF 防火墙与黑白名单
  • SQL 注入、XSS、路径遍历检测
  • API Key / JWT 鉴权
  • 操作审计与配置变更追踪
Observe

可观测性

  • 实时请求日志(WebSocket 推送)
  • 状态码分布与路由访问排行
  • P50 / P90 / P99 延迟统计
  • 熔断器状态与健康检查结果
Ops

部署与运维

  • 默认 SQLite,本地文件持久化
  • 不强制依赖外部数据库
  • 支持 Windows / Linux 部署
  • 重启后自动恢复配置

NuGet 包

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

Core

Aneiang.Yarp

网关核心:动态路由引擎、配置持久化、API 鉴权、IP 隔离负载均衡、8 个独立仓储接口、gRPC 注册协议

dotnet add package Aneiang.Yarp
Dashboard

Aneiang.Yarp.Dashboard

Web 管理面板:全量 CRUD、WAF 防火墙、通知告警、熔断器、请求日志、健康检查、审计日志、策略引擎、SQLite 持久化

dotnet add package Aneiang.Yarp.Dashboard
Client

Aneiang.Yarp.Client

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

dotnet add package Aneiang.Yarp.Client

相比原生 YARP 补齐了什么

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

能力 原生 YARP Aneiang.Yarp
反向代理支持基于 YARP
Dashboard需要自建内置
动态路由管理需要开发内置
服务自动注册需要开发客户端 SDK
WAF需要扩展内置
通知告警需要扩展内置
配置快照 / 回滚需要开发内置
SQLite 持久化需要开发内置

技术栈

高性能、零外部服务依赖

反向代理引擎Microsoft YARP(版本跟随)
运行时.NET 8.0 / 9.0
存储SQLite + SQLCipher AES-256 加密
通信协议REST API + gRPC + SignalR WebSocket
认证JWT (HMAC-SHA256) + API Key + 自定义委托
Dashboard 技术Razor Pages + 原生 JavaScript(零 Node.js 依赖)

为什么选择 Aneiang.Yarp

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

Fit

它适合谁

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

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

开源透明

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

  • MIT License
  • 面向真实 .NET 网关场景持续演进
  • 公开反馈渠道与社区讨论
参与开源共建 如果 Aneiang.Yarp 对你有帮助,欢迎在常用平台点 Star;遇到问题或有功能建议,也欢迎提交 Issue。
给项目点 Star
提交问题或建议

从试用到生产

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

阶段 01

本地试用

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

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

基础接入

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

  • 引入 Aneiang.Yarp + Dashboard
  • 选择认证方式
  • 配置动态路由和集群
阶段 03

能力增强

按业务需要开启安全、观测和审计能力,让网关真正承担生产职责。

  • 启用 WAF / 限流 / 熔断
  • 对接通知告警渠道
  • 配置审计与配置快照
阶段 04

私有化上线

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

  • 私有化部署到内网
  • 建立配置变更流程
  • 根据实际场景持续反馈

开源信息

源码、包、文档和演示环境都可以直接访问,方便评估和接入

常见问题

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

Aneiang.Yarp 是替代 YARP 吗?

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

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

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

是否适合私有化部署?

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

微服务必须引用 YARP 吗?

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

是否支持中文界面?

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

准备好开始了吗?

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