生产级 API 网关增强方案,15 个 Dashboard 管理页面,三个 NuGet 包协同工作
运行时 CRUD 路由与集群,无需重启。双配置源统一,自动持久化到 gateway-dynamic.json,线程安全。
一行代码 AddAneiangYarpClient(),微服务启动自动注册、关闭自动注销。智能推断所有默认值。
多人开发调试利器。同一服务多人并行,网关按客户端 IP 自动路由,前端零感知。
两行代码启用。集群/路由 CRUD、配置导入导出、快照回滚、实时日志、日志脱敏与采样、中英文切换。
None / API Key / JWT(默认 & 自定义)/ 自定义委托。智能凭据推断,少写配置。
导入导出标准 YARP 格式配置。每次变更自动快照,一键回滚到任意历史版本。
内建生产级防护:IP 黑白名单、SQL 注入/XSS/路径遍历检测、请求限制、安全响应头。按路由精细控制。
多渠道告警(钉钉/通用 Webhook)。熔断、重试耗尽、WAF 拦截等 6 种事件类型,独立冷却防告警风暴。
实时请求日志(WebSocket 推送)、熔断器状态面板、主动/被动健康检查、P50/P90/P99 延迟统计。
不用从零搭建网关管理系统,几分钟即可跑起 Dashboard
dotnet add package Aneiang.Yarp.Dashboard
builder.Services.AddAneiangYarpDashboard();
app.UseAneiangYarpDashboard();
启动网关后访问 Dashboard,即可管理路由、集群、WAF、日志、审计、告警和健康检查。
两行代码即可拥有的专业管理面板
集中查看路由、集群、健康状态和最近配置变更,快速判断网关当前运行情况。
展示请求量趋势、延迟分位、状态码分布和 Top 路由,帮助定位流量和性能问题。
维护后端服务集群、目标节点、健康检查和负载均衡配置,支持运行时调整。
可视化维护路由匹配、转发集群、优先级和转换规则,修改后即时生效。
实时查看代理请求日志,按路由、状态码和 TraceID 过滤,辅助排查线上问题。
配置黑白名单、SQL 注入、XSS、路径遍历和安全响应头,为网关入口提供基础防护。
配置告警渠道和事件规则,在熔断、重试耗尽、WAF 拦截等场景及时通知。
记录配置变更、操作对象、变更内容和时间,方便追踪问题和回溯操作。
如果你正在使用 YARP,或准备为 .NET 项目建设统一网关,这些场景都可以直接落地
围绕企业内网和 .NET 微服务网关场景,提供安全、运维、观测和配置治理能力
按需引用,依赖关系清晰。客户端微服务不引入 YARP SDK
网关核心:动态路由引擎、配置持久化、API 鉴权、IP 隔离负载均衡、8 个独立仓储接口、gRPC 注册协议
dotnet add package Aneiang.Yarp
Web 管理面板:全量 CRUD、WAF 防火墙、通知告警、熔断器、请求日志、健康检查、审计日志、策略引擎、SQLite 持久化
dotnet add package Aneiang.Yarp.Dashboard
客户端自动注册:一行代码接入,HTTP/gRPC 双协议,指数退避重试,零 YARP SDK 依赖
dotnet add package Aneiang.Yarp.Client
Aneiang.Yarp 不替代 YARP,而是在 YARP 之上补齐生产落地常用配套能力
| 能力 | 原生 YARP | Aneiang.Yarp |
|---|---|---|
| 反向代理 | 支持 | 基于 YARP |
| Dashboard | 需要自建 | 内置 |
| 动态路由管理 | 需要开发 | 内置 |
| 服务自动注册 | 需要开发 | 客户端 SDK |
| WAF | 需要扩展 | 内置 |
| 通知告警 | 需要扩展 | 内置 |
| 配置快照 / 回滚 | 需要开发 | 内置 |
| SQLite 持久化 | 需要开发 | 内置 |
高性能、零外部服务依赖
面向 .NET 团队的 YARP 网关增强方案,追求开箱即用、运维简单、私有化部署友好
如果你正在用 YARP,或准备为 .NET 项目搭建统一网关,它能直接接管从接入到治理的常见工作。
YARP 提供反向代理引擎,Aneiang.Yarp 在它之上补齐 Dashboard、动态配置、WAF、自动注册和审计治理等生产配套。
项目以 MIT 协议开源,代码在 GitHub / Gitee 公开,欢迎提交 Issue、讨论使用场景和贡献代码。
按四个阶段逐步接入,能更平滑地把 YARP 网关能力落到实际项目中
先在本地把示例项目跑起来,体感 Dashboard 和整体接入方式。
在已有或新建的网关项目中引入 Aneiang.Yarp,逐步打开 Dashboard、鉴权和动态配置。
按业务需要开启安全、观测和审计能力,让网关真正承担生产职责。
按内网环境打包发布,建立变更与监控流程,长期维护。
源码、包、文档和演示环境都可以直接访问,方便评估和接入
快速了解 Aneiang.Yarp 的定位、依赖和使用方式
不是。它基于 Microsoft YARP,补充 Dashboard、动态配置、WAF、告警、自动注册等生产配套能力。
不需要。默认使用 SQLite 本地文件持久化,无需额外部署数据库服务。
适合。项目默认依赖少,配置和数据可本地持久化,适合内网系统和中小团队场景。
不需要。微服务只需引用 Aneiang.Yarp.Client 用于自动注册,不直接依赖 YARP SDK。
支持。官网和 Dashboard 均提供中英文界面。