Skip to content
bitzorcas
中EN

Concept

Host 组合与运行拓扑:API、Gateway、JobHost 与 Aspire 编排

深入解析 BitzOrcas.Modern 的宿主组合架构:API Host、YARP Gateway、JobHost 物理职责划分、ServiceDefaults 共享基底与 .NET Aspire 本地编排拓扑。

Last updated

BitzOrcas.Modern 采用按职责分离的 Host 组合根:将同步 HTTP API、边缘网关与异步定时任务分别封装在独立的运行宿主中,同时通过 ServiceDefaults 共享统一的可观测性与健康检查配置。

宿主组合与运行时拓扑全景图

后台异步调度宿主共享基础设施数据层

SQL Server 2022 (:14333)

Redis 7 (:6379)

RabbitMQ (:5672)

外部客户端 / Web 前端 (5860)

BitzOrcas.Gateway (YARP 网关 :6880)

BitzOrcas.Api (业务 Minimal API :6881)

BitzOrcas.JobHost (Quartz 分布式任务)


核心运行宿主职责矩阵

宿主工程默认端口核心职责与架构定位
BitzOrcas.Api6883 (HTTPS) / 6881 (HTTP)主业务 API 宿主,执行 JWT/2FA 认证、租户解析、10 级管道流转与业务切片 Handler 编排
BitzOrcas.Gateway6880 (HTTP)YARP 反向代理网关,负责全局限流(Rate Limiting)、CORS 安全响应头与多域名路由转发
BitzOrcas.JobHost无对外 HTTP 端口Quartz 分布式后台任务宿主,执行数据归档、订阅续费扣减、未支付工单超时自动关闭等异步 Job
BitzOrcas.AppHost6888 (Dashboard).NET Aspire 本地编排组合根,一键拉起容器基础设施与微内核实例,集成链路追踪与集中日志

总结

清晰的 Host 职责切分保证了系统具备极高的运维弹性:

  • 流量洪峰隔离:网关层阻断恶意流量,保护后端 API;
  • 异步任务解耦:重型数据归档与报表计算运行在 JobHost 中,绝不占用 API 请求线程池。

100%

滚轮或按钮缩放 · 放大后拖动画面 · 双击切换 100% / 200%